ZeroNews 3.0 与 4.0 平台互不兼容。升级至 4.0 后，您需要在 4.0 平台重新创建原有映射与配置，相关服务才可继续访问。自 2026 年 4 月 29 日 4.0 正式上线后，系统默认不再迁移 2026 年 4 月 29 日之后在 3.0 平台创建的免费版域名。

​
为什么要升级

基于云原生与 CNCF 设计理念，ZeroNews 4.0 对整体架构进行了全面重构，在安全性、稳定性与可扩展性方面实现了系统性提升。 面对更复杂的业务场景，4.0 提供了更强的扩展能力，以及企业级安全与可观测支持，可帮助用户构建更稳定、更高效的访问通道。 本次升级重点：
  • 架构升级：云原生架构 + 构建流程可视化，控制面与数据面深度解耦，提升性能与稳定性
  • 流量能力：支持流量编排、多服务负载，具备灰度发布与故障迁移的扩展能力
  • 安全能力：支持地理围栏、IAM 身份认证，RBAC
  • 可观测性：提供全链路访问日志与恶意流量防护能力
  • 开放能力：支持 CLI、开放 API 与 AI Agent 等扩展方式
  • 协作能力：新增 Webhook 隧道、文件共享、 WorkSpace 协同
为获得更好的使用体验，免费用户请于 05 月 15 日前，订阅用户请于 06 月 10 日前完成升级。如未在上述时间内完成升级，3.0 平台中的映射服务将停止访问。为避免影响业务连续性，建议您提前完成版本升级。

​
如何升级

​
第一步：登录 4.0 平台

访问 https://user.zeronews.cc/，使用原有账号登录。支持手机验证码登录或账号密码登录。
3.0 平台中的用户信息、订阅计划、域名及端口配置已自动同步至 4.0，无需重新添加。

​
第二步：激活已经同步过来的域名

点击域名激活后，3.0 平台关联的映射访问将立即中断并停止，为了不影响您的业务运行，请您合理安排激活时间。确认激活后，系统会更新域名的调度信息到新平台，请确保业务允许短暂中断，域名策略更新后，会在10分钟内生效。
登录后，控制台横幅会提示需要采取的操作：激活域名。
  1. 点击横幅提示「立即激活」，或前往「自定义域名」页面。
  2. 找到状态为「待激活」的域名（即从 3.0 平台同步的域名），点击域名右侧的激活按钮（激活按钮为一个小锁形状）。
  3. 按照页面提示完成激活。

​
第三步：卸载 3.0 客户端并安装 4.0

4.0 客户端无法与 3.0 客户端同时运行。如您当前已安装或正在运行 3.0 客户端，请先停止运行并卸载 3.0 后，再安装 4.0 客户端。

​
1. 卸载 3.0 客户端

请根据您当前的运行方式，选择对应的卸载方式。 前台模式运行（手动启动程序）
Windows
# 先 ctrl+c 停止运行的 3.0 客户端
# 然后直接删除 3.0 客户端程序目录及文件即可
# 建议新建一个独立的 ZeroNews 文件夹，用于存放 4.0 客户端程序
macOS
# 1. 停止正在运行的客户端
在当前终端运行窗口中按 Ctrl + C 结束客户端运行。

# 2. 删除 3.0 客户端程序目录
程序默认目录 /Applications/zeronews
您也可以打开「访达」→「应用程序」，找到 ZeroNews 程序文件夹后直接删除。
后台模式运行（已安装系统服务）
Windows
# Windows：请以管理员身份运行以下命令
zeronews.exe uninstall
macOS
cd /Applications/zeronews
sudo ./zeronews uninstall
sudo rm -rf /Applications/zeronews
Linux
sudo service zeronews stop 
sudo systemctl disable zeronews
sudo rm -rf /etc/zeronews /usr/bin/zeronews
树莓派
sudo service zeronews stop 
sudo systemctl disable zeronews
sudo rm -rf /etc/zeronews /usr/bin/zeronews
Docker
docker stop zeronews && docker rm zeronews

# 删除 zeronews 容器挂载目录，根据实际挂载目录执行删除错误
rm -rf /opt/zeronews

​
2. 安装 4.0 客户端

前往 控制台 → 快速开始 页面，根据您的系统类型下载并安装 4.0 客户端。 完成安装后，根据快速开始页面步骤提示执行设备认证并启动客户端即可。

​
第四步：重新添加隧道

启动 4.0 客户端后，请在控制台 隧道管理 页面重新添加隧道，以恢复原有服务。

​
第五步：如何检查是否已经成功升级到4.0，并且服务可用？

确认客户端安装成功：当按照首页指引，成功安装完成客户端后，登录到用户控制台，找到顶部菜单栏—关联客户端，检查是否有刚才安装的客户端，客户端显示在线状态，才表示安装成功。 添加隧道服务：4.0平台中的隧道，即是3.0平台中的映射，在确保域名激活成功，且客户端安装成功的前提下，在用户控制台中—隧道管理 里面，添加隧道即可。 隧道添加成功后，会在30秒内生效，此时可以测试访问添加的隧道地址，是否可正常访问，如访问有问题，可以联系客服人员协助检查。

​
飞牛和群晖设备用户

如果您通过飞牛或群晖应用市场安装 ZeroNews 客户端，如有安装3.0版本客户端，需要先卸载3.0版本客户端，再根据上述升级流程进行升级4.0版本客户端。 如需继续沿用现有域名，请确保先在 4.0 控制台的 自定义域名 页面中完成相关域名激活，再尽快通过应用市场更新至 4.0 客户端。否则，这些设备关联的隧道将无法正常访问。

​
3.0 平台入口

升级期间，3.0 旧平台仍可正常访问： https://userv1.zeronews.cc/ 您可在此查看 3.0 平台中的历史配置，用于辅助在 4.0 中重建隧道。3.0 平台将于指定时间关闭服务，建议尽快完成迁移。

​
升级前后权益变化

​
免费订阅

存量免费用户升级前后的映射条数及带宽配额保持不变，但仅支持 HTTPS 类型映射，不再支持 TCP 类型映射。
注意：4.0 平台新注册用户将按照新版免费计划标准享有权益，与存量用户迁移后的权益存在差异。

​
付费订阅

付费订阅的原有剩余时长保持不变，整体权益将有所提升，3.0 升级至 4.0 的订阅对应关系如下： 个人
3.0 版本订阅计划升级后4.0 版本订阅计划
个人 Lite→个人 Pro
个人 Pro→个人 Pro
个人 Pro+→个人 Pro+
团队
3.0 版本订阅计划 4.0 版本订阅计划
团队 Lite→团队 Pro
团队 Pro→团队 Pro
团队 Pro+→团队 Max
查看 4.0 完整订阅权益详情 →
4.0 平台新增 Business 和 Enterprise 政企类订阅服务，如有需要可咨询升级。

​
升级赠送服务时长

为感谢用户的支持，系统将自动为存量用户发放以下赠送时长，无需手动申请：
用户类型赠送内容
个人版订阅用户赠送订阅服务时长 15 天
团队版订阅用户赠送订阅服务时长 30 天
说明：以上赠送时长将在升级完成后的 14 天内生效。

​
FAQ

为帮助您顺利完成升级，请关注以下关键事项：
  1. 3.0 客户端是否还能继续使用？ 可以，但将逐步停止支持。3.0 客户端不兼容 4.0 平台，如需使用 4.0 服务，需重新安装 4.0 客户端，否则无法建立隧道连接。
  2. 同步过来的域名为什么不能直接使用？ 从 3.0 同步到 4.0 的域名在激活前无法使用。完成激活后，该域名在 3.0 平台将停止访问，请合理安排激活时间，尽量降低对业务的影响。
  3. 升级后为什么还要重新添加隧道？ 域名激活不会自动恢复原有隧道配置。由于 3.0 与 4.0 的客户端和平台不兼容，您需要在 4.0 控制台手动重新添加隧道，才能恢复服务。
  4. 4.0 客户端安装失败怎么办？ 可先手动删除现有 3.0 客户端程序目录，再按照 4.0 控制台“快速开始”页面中的流程重新安装。
  5. 3.0 平台什么时候停止维护？ 建议尽快完成升级。3.0 平台后续停服后，旧平台入口 https://userv1.zeronews.cc/ 将无法继续访问。
  6. 是否需要重新注册账号？ 不需要。直接使用原有账号登录 https://user.zeronews.cc/ 即可。
  7. 飞牛和群晖设备如何升级？ 更新至 4.0 客户端后，请尽快在 4.0 平台激活域名，并重新添加隧道，之后方可恢复正常访问。
  8. 升级过程中遇到其他问题怎么办？ 如仍有疑问，请联系官网客服协助处理。