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

# v0.12.6

<Warning>
  在 Monad 基金会发出通知之前，请不要执行此操作。
</Warning>

## 节点运营者操作说明

### 1. 以 `root` 用户身份 SSH 登录节点

### 2. 更新配置文件

将 `ping_rate_limit_per_second` 参数添加到配置文件的 `[peer_discovery]` 部分：

```bash theme={null}
nano /home/monad/monad-bft/config/node.toml
```

将以下行添加到 `[peer_discovery]` 部分：

```toml theme={null}
[peer_discovery]
self_address = "YOUR_IP:8000"
self_record_seq_num = 0 # This remains the same as your current self_record_seq_num
self_name_record_sig = "YOUR_SIGNATURE"
refresh_period = 20
request_timeout = 5
unresponsive_prune_threshold = 3
last_participation_prune_threshold = 1000
min_num_peers = 1
max_num_peers = 450
ping_rate_limit_per_second = 100  # This is new to 0.12.6
```

### 3. 检查 systemctl 覆盖（如适用）

<Warning title="对带有自定义 systemctl 覆盖的运营者的重要说明">
  此版本向 `monad-bft` 服务启动添加了 `--persisted-peers-path /home/monad/monad-bft/config/peers.toml`。如果您有 `monad-bft` 的现有 systemctl 覆盖，您必须确保此标志包含在您的覆盖配置中。
</Warning>

检查您是否有覆盖：

```bash theme={null}
systemctl cat monad-bft | grep -A 10 "override"
```

如果您有现有的覆盖，请对其进行编辑以包含持久化对等节点路径：

```bash theme={null}
sudo systemctl edit monad-bft
```

确保您的覆盖包含：

```
--persisted-peers-path /home/monad/monad-bft/config/peers.toml
```

### 4. 升级 monad 软件包

```bash theme={null}
sudo apt update && sudo apt install --reinstall monad=0.12.6 -y --allow-downgrades --allow-change-held-packages
```

### 5. 重启服务并验证

```bash theme={null}
sudo systemctl restart monad-bft monad-execution monad-rpc
sudo systemctl status monad-bft monad-execution monad-rpc --no-pager -l
```

预期输出：所有服务应显示 `Active: active (running)`

### 6. 验证运行的版本正确

```bash theme={null}
monad-rpc --version
```

预期输出：

```json theme={null}
monad-rpc {"commit":"cced63c687c6ab67846c94bc9fd6d6ae60272cd4","tag":"v0.12.6","branch":"","modified":true}
```

<Info title="Sidecar CPU 核心配置">
  Sidecar 需要自己的 CPU 核心，**不能与 monad 进程共享核心**。Monad 在标准设置中使用所有 16 个核心（核心 0-15），因此在相同核心上运行 sidecar 会导致性能问题。
</Info>

## 补丁说明

请参考 [`v0.12.6`](/zh/developer-essentials/changelog/releases#v0-12-6) 的公开变更日志。

### 面向节点运营者的重要更新

* **\[Node ops / Peer Discovery]** 添加 ping 速率限制配置
  * 新的**必需**参数：`[peer_discovery]` 部分中的 `ping_rate_limit_per_second = 100`
  * 防止过多的 ping 流量并提高网络稳定性