> ## Documentation Index
> Fetch the complete documentation index at: https://docs.plasma.org/llms.txt
> Use this file to discover all available pages before exploring further.

# 升级

> 软件更新、共识升级与维护

## 为什么升级很重要

Plasma 的架构快速演进，以支持高吞吐、稳定币原生的用例。及时升级可以：

* 防范安全漏洞
* 提升支付负载的性能
* 保持与 Plasma 共识层与 RPC 接口的兼容性

过时的节点可能出现同步失败、性能下降或安全问题。由于非验证者节点常常为支付应用承担关键的 RPC 流量，因此保持更新至关重要。

<Note>
  大多数非验证者节点升级需要 15–30 分钟的停机时间。引入新功能或共识变更的大版本可能需要更长的同步时间窗口。
</Note>

## 升级类型

<Columns cols={3}>
  <Card title="安全补丁" href="#security-patches">
    保护支付基础设施的关键修复
  </Card>

  <Card title="功能更新" href="#feature-updates">
    支付应用的新能力
  </Card>

  <Card title="性能优化" href="#performance-optimisations">
    针对高交易量处理的改进
  </Card>
</Columns>

### 安全补丁

安全补丁修复非验证者客户端、Reth 或依赖项中的漏洞。

**示例：**

* 状态不一致或共识脱同步漏洞
* RPC 访问控制与认证修复
* 密码学库更新

发布后应立即应用。

### 功能更新

功能版本支持新的协议能力或新的应用模式。

**示例：**

* 零手续费 USD₮ 转账增强
* 自定义 gas 代币支持
* 新增或扩展的 RPC 方法
* 状态查询优化
* 钱包与交易所集成改进

### 性能优化

以性能为重点的版本提升执行速度、同步效率与资源利用率。

**示例：**

* 数据库读写更快
* 负载下 RPC 延迟降低
* 内存与 CPU 效率提升
* 共识同步改进

## 升级流程

非验证者节点的升级通常包括拉取新的 Docker 镜像、更新配置以及重启服务。

<Steps>
  <Step title="通知应用方">
    告知相连的服务有计划的维护。
  </Step>

  <Step title="确认兼容性">
    确保新的非验证者客户端版本能与当前共识端点协同工作。
  </Step>

  <Step title="更新配置">
    应用任何用于增强功能的新配置选项。特别注意影响自定义 gas 代币支持、零手续费交易处理或支付应用 RPC 接口的变化。
  </Step>

  <Step title="测试 RPC 端点">
    升级后验证支付应用的兼容性。
  </Step>

  <Step title="监控交易处理">
    确保 USD₮ 转账和自定义 gas 操作正常运行。
  </Step>
</Steps>

<Tip>
  在运行多个非验证者节点时，分阶段部署升级。先从非关键实例开始，然后再升级主要的支付基础设施，并在继续之前仔细监控首个升级后的节点。
</Tip>

## 升级后验证

升级后，请验证与共识层完全同步并检查核心功能。

<Check>**共识同步**：区块高度与网络对齐</Check>
<Check>**RPC 功能**：测试支付应用使用的关键端点</Check>
<Check>**性能基线**：将升级后指标与先前基线对比</Check>
<Check>**监控**：确认监控与告警系统仍正常运行</Check>

<Tip>
  记录配置更改与观察到的行为。这能提高未来升级与故障排查的可靠性。常见问题请参阅[故障排查指南](./troubleshooting)。
</Tip>

## 回滚流程

### 何时回滚

如出现以下情况，请回滚：

* 共识同步失败
* 严重的 RPC 性能下降
* 应用不兼容
* 安全回退
* 影响余额或转账的数据不一致

### 如何回滚

<Steps>
  <Step title="停止服务">
    停止非验证者节点服务。
  </Step>

  <Step title="回退镜像与配置">
    回退到先前的 Docker 镜像与配置。
  </Step>

  <Step title="重启并重新同步">
    重启服务并与网络重新同步。
  </Step>

  <Step title="验证功能">
    重新测试 RPC 端点与交易功能。
  </Step>

  <Step title="通知团队">
    通知应用团队服务已恢复。
  </Step>
</Steps>

## 最佳实践

### 自动化与监控

* 尽可能自动化镜像拉取与配置更新
* 通过版本化配置追踪更改
* 升级期间增强可观测性
* 重启后密切监控 RPC 错误率、同步状态和交易吞吐

## 常见排障

如果升级后出现问题：

* **共识同步**：检查端点连接、凭据与许可名单状态
* **RPC 错误**：校验配置、版本兼容性与更新后的接口
* **性能回退**：监控资源使用并查看发布说明

升级 Plasma 非验证者节点对维持稳定币应用所依赖的可靠、安全的 RPC 基础设施至关重要。遵循结构化的升级与验证流程可降低风险，并确保平滑的性能。