# 查看 NPC 版本与兼容性

> 查看在线 NPC 版本，理解跨版本连接行为并安全安排升级

---

LLMS 索引： [llms.txt](/llms.txt)

---

NPC 在握手时会向 NPS 上报发行版本，NPS 也会返回核心协议版本摘要。Web 管理的客户端列表会显示在线 NPC 的版本，便于发现混用版本。

## 当前兼容行为

当前产品的核心版本基线为 `0.26.0`。握手会完成版本交换，但核心版本不一致时仍会兼容放行；**版本不同不会单独导致连接被拒绝**。连接失败应先检查客户端验证密钥、桥接地址、协议、TLS 设置和网络连通性。

兼容放行不代表所有新字段都能被旧版识别。例如旧版 NPC 不会上报内网地址，也可能不支持后来增加的配置字段。服务端与客户端跨较大版本运行时，常见表现是部分功能缺失，而不是握手立即失败。

## 升级建议

1. 在客户端列表记录在线 NPC 的版本和客户端验证密钥。
2. 阅读目标版本更新日志，先升级一台非关键 NPC 验证。
3. 优先让 NPS 与 NPC 使用同一发行版本；需要分批升级时，缩短混用周期。
4. 升级后检查客户端在线状态，并逐项验证 TCP、UDP、HTTP(S)、P2P 等实际使用的隧道。

命令行可查看本机二进制版本：

```shell
./nps -version
./npc -version
```

如果 Web 显示的版本未更新，确认旧 NPC 进程已经退出，系统服务实际指向了新二进制，然后重新连接。