ZeroNews 3.0 与 4.0 平台互不兼容。安装 4.0 客户端后，并在 4.0 版本中重建原有映射，相关映射服务方可继续访问使用。

​
为什么要升级

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

​
如何升级

​
第一步：登录 4.0 平台

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

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

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

​
第三步：安装 4.0 客户端

如您当前正在运行 3.0 版本客户端，请先停止运行或卸载后，根据「快速开始」页面系统类型重新下载安装 4.0 客户端。
前往 控制台 → 快速开始，根据您的操作系统下载并安装 4.0 客户端，完成认证后启动客户端。 前台模式运行客户端 卸载 
# Windows，您可以直接删除掉程序目录及文件，重新创建 ZeroNews 程序目录

# macOS，您可以直接删除掉程序目录及文件，按照快速开始页面下载更新后，系统会自动创建新的程序文件
# macOS默认程序目录路径：/Applications/zeronews，可打开「访达」-「应用程序」列表，下拉找到 ZeroNews 程序文件夹进行删除
后台模式运行客户端 卸载 
# Windows 以管理员运行 zeronews 程序
zeronews uninstall

# macOS
sudo rm -rf /usr/local/bin/zeronews
sudo ./zeronews uninstall

# Linux
service zeronews stop && rm -rf /etc/zeronews
systemctl disable zeronews

# 树莓派
service zeronews stop && rm -rf /etc/zeronews
systemctl disable zeronews

# Docker
docker stop zeronews && docker rm zeronews
rm /opt/zeronews
然后请根据您的系统类型，按照快速开始页面中的对应系统进行安装 4.0 版本客户端。

​
第四步：重新添加隧道

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

​
飞牛和群晖设备用户

如果您通过飞牛或群晖应用市场安装 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. 升级过程中遇到其他问题怎么办？ 如仍有疑问，请联系官网客服协助处理。