派想网
Pi Network 官方 Node 页面目前显示，Mainnet 区块链协议正在升级，并明确要求每个 Mainnet Node 升级到 v28。对节点运营者来说，重点不是只看到“v28”三个字符，而是确认客户端、区块链容器和实际连接状态是否都已完成切换。
此前本站曾整理过节点协议升级对连接状态的影响。这篇文章进一步解决实际操作问题：怎样判断自己是否需要处理、更新前保留什么、更新后如何确认，以及断连时先排查哪一层。
先分清桌面客户端版本和协议版本
Pi Desktop 或 Pi Node 的应用版本，是安装在电脑上的客户端版本；v28 则指节点要支持的区块链协议版本。两者有关联，但不是同一个数字。只看安装程序版本号，不能直接证明节点已经在 v28 网络上正常同步。
更可靠的判断方式是同时检查三项：官方 Pi Node 页面是否仍提示强制升级；Pi Desktop 内的节点状态是否显示正常；节点日志或状态页是否持续同步最新区块。若客户端已经更新但区块高度长期不变，问题可能在容器、磁盘、网络或协议迁移阶段。
更新前先保留这些信息
- 记录当前 Pi Desktop 或 Pi Node 版本、节点状态和最后同步时间。
- 截图保存容器名称、数据目录和磁盘剩余空间。
- Linux 节点按官方升级文档备份现有配置，尤其是节点密钥、数据库密码和数据卷路径。
- 不要把节点私钥、钱包助记词、数据库密码或完整配置文件发到群聊求助。
- 不要先删除 Docker 数据卷。删除数据卷可能导致重新同步，且无法解决账号或协议配置问题。
Windows 与 macOS 节点怎样处理
先从 Pi 官方 Node 页面进入 Windows 或 macOS 下载入口，避免使用群文件或第三方重打包程序。完全退出旧客户端后安装官方版本，再重新打开 Pi Desktop，给容器和数据库迁移预留时间。大型迁移可能不会在界面出现后立刻完成。
更新后依次确认：Node 开关是否开启；区块链组件是否在运行；同步高度是否继续增长；网络连接和入站检测是否恢复。若状态短暂显示离线，先等待初始化完成，不要连续重装。
Linux 节点怎样更新
Pi 官方 Linux 文档提供自动更新与手动控制两种方式。启用自动更新时，节点会在新版本发布后执行所需迁移；希望自行控制窗口的运营者，可以按官方文档使用更新命令。APT 安装方式可先更新软件包索引，再升级 pi-node 软件包；协议迁移则以官方文档当时列出的 pi-node update-protocol 流程为准。
执行前要确认服务目录、数据卷和环境配置来自现有节点，不要复制陌生教程里的节点密钥或数据库参数。升级过程中如果提示迁移尚未完成，应先查看日志并保留现场，而不是直接重新初始化。
升级后仍断连，按这五层排查
1. 系统时间
电脑时间偏差可能影响网络握手和证书验证。开启系统自动校时，确认时区与时间准确，然后重启客户端。
2. 磁盘与内存
数据库迁移和重新索引会增加磁盘占用。系统盘空间不足、Docker 数据目录已满或内存压力过高，都可能让容器反复退出。先查看资源使用，再决定是否清理不相关文件。
3. Docker 或节点服务
确认相关容器没有停在退出、重启循环或健康检查失败状态。只重启有问题的节点组件，并保留错误日志。不要把“容器正在运行”误当成“区块已同步”。
4. 网络与安全软件
检查防火墙、路由器、VPN 和安全软件是否在更新后把新程序路径当作不同应用。可以先允许官方程序联网并重新运行检测，但不要为图省事永久关闭系统防火墙。
5. 协议状态
如果客户端运行正常但仍停留在旧协议或旧区块高度，应再次核对官方升级说明。社区截图中的截止日期或命令可能已经过期，最终以 Pi Node 页面链接的升级指南为准。
哪些情况不需要普通手机用户操作
v28 提示针对运行 Mainnet Node 的电脑。只使用 Pi 手机应用、钱包或 Pi Browser，并不意味着要在手机上安装所谓“v28 升级包”。任何要求通过 APK、二维码或钱包签名完成节点协议更新的页面，都应视为高风险。
最稳妥的处理顺序
- 从 minepi.com/pi-node 确认官方提示。
- 记录现状并备份节点配置，不保存或分享敏感密钥。
- 使用官方安装入口或官方 Linux 指令升级。
- 等待迁移完成，再观察同步高度、容器状态和网络检测。
- 异常时逐层排查，不先删除数据卷或重新初始化。
官方 Node 页面截至 2026 年 11 月 9 日仍显示 v28 升级要求。页面内容与升级指南可能继续调整，执行任何命令前应再次打开官方来源核对。
