本文内容来源于Pi Network官网公告 及Pi Core Team官方GitHub技术文档，用于节点运营者、技术节点用户参考。
一、Pi Node节点协议升级总体说明
Pi Network 将按照既定顺序，逐步将主网协议版本从v19升级至v23。
⚠️所有节点必须严格按顺序升级，不可跳级升级，并且必须等待全网升级完成后，才能进入下一阶段。
强制升级路径（不可跳过）
19.1 → 19.6 → 19.9 → 20.2 → 21.1 → 22.1 → 23.0
📌当前要求：所有节点必须升级至v19.6
二、关键升级时间节点（务必关注）
| 日期 |
升级目标版本 |
当前状态 |
| 2026 年 2 月 12 日 |
升级至 v19.6 |
✅ 正在进行 |
| 2026 年 2 月 27 日 |
升级至 v19.9 |
⛔ 尚未开始 |
| 2026 年 3 月 12 日 |
升级至 v20.2 |
⛔ 尚未开始 |
⚠️官方未宣布开始前，禁止提前升级
三、升级状态速查表（官方）
| 升级步骤 |
当前状态 |
截止时间 |
官方说明 |
| 19.1 → 19.6 |
✅ 正在升级 |
2026/02/12 |
无破坏性改动，可安全升级 |
| 19.6 → 19.9 |
🚫 禁止开始 |
2026/02/27 |
Horizon 架构调整，需切换 captive-core |
| 19.9 → 20.2 |
🚫 禁止开始 |
2026/03/12 |
官方尚未开放升级 |
| 20.2 → 21.1 |
🚫 禁止开始 |
TBD |
等待官方公告 |
| 21.1 → 22.1 |
🚫 禁止开始 |
TBD |
等待官方公告 |
| 22.1 → 23.0 |
🚫 禁止开始 |
TBD |
等待官方公告 |
四、不同节点类型的升级方式说明
1️⃣Pi Desktop（Windows / macOS）
✅无需任何手动操作
- 使用Pi Desktop启动节点时
- 协议升级会自动触发并完成
👉 适合普通节点用户
【Pi Desktop节点安装教程】
2️⃣Pi Linux Node CLI（Linux，新版官方推荐）
这是2026年推出的全新官方Linux节点运行方式，由Pi官方提供命令行工具，自动管理Docker容器。
查看来自官方介绍页面的Pi Linux Node CLI搭建教程
如果已开启自动更新
✅无需任何操作
如果未开启自动更新
执行以下命令即可升级协议：
pi-node update-protocol
📌 强烈建议 Linux 节点用户切换至此方式
3️⃣自行维护Docker节点（Linux旧方式）
这是早期的Linux节点部署方式（Legacy），需要手动维护docker-compose.yml。
官方建议：
👉尽量迁移至【Pi Linux Node CLI】
五、当前唯一允许的升级步骤（19.1 → 19.6）
升级状态
- 状态：✅ 官方已激活
- 截止时间：2026 年 2 月 12 日
- Docker镜像：
pinetwork/pi-node-docker:organization_mainnet-v1.3-p19.6
GitHub 官方发布说明
Pi Network官方GitHub升级说明：详解协议v19.1至v19.6的关键技术指南
Docker 升级操作步骤
修改docker-compose.yml中以下两行：
# Pi Network Mainnet Node
image: pinetwork/pi-node-docker:organization_mainnet-v1.3-p19.6
command:
- "--mainnet"
- "--enable-auto-migrations"
然后执行：
docker-compose up -d
自动迁移说明（非常重要）
./migrations/migration_runner.sh
六、⚠️尚未开放的升级步骤（禁止提前）
以下升级 全部未激活，请勿操作：
19.6 → 19.9
特别说明：
- Horizon必须切换至captive-core架构
- 不要使用Horizon 2.28（存在内存泄漏）
后续版本（仅占位，等待官方）
- 19.9 → 20.2
- 20.2 → 21.1
- 21.1 → 22.1
- 22.1 → 23.0
⛔均未发布Docker镜像，不可操作
七、如果错过升级时间怎么办？
如果节点错过了某个强制升级步骤：
- 可以尝试补齐中间所有升级步骤
- 但在部分情况下，必须重新同步整个节点数据
👉 建议提前备份节点数据
八、v19.6 版本更新要点速览（官方）
新增功能
--enable-auto-migrations
- 新增迁移脚本体系
- Docker构建时已内置迁移文件
架构调整
- 移除standalone模式
- 移除ephemeral临时模式
- 仅支持mainnet / testnet / testnet2
PostgreSQL 优化
构建与启动优化
- 精简Dockerfile
- 移除废弃参数
- 简化启动逻辑
Pi Network节点协议升级是一个强制、不可跳级、时间敏感的过程。
当前阶段，v19.6是唯一允许升级的版本，请所有节点运营者务必在官方截止时间前完成升级，以免节点失效或被迫重建。
