跳到主要内容

ZeroNews v3.0.0 版本升级指南

发布日期：2025年7月11日

版本升级维护时间： 2025年7月16日 5:00 - 9:30（UTC+8）

一、升级须知：手动安装强制要求 ⚠️​

尊敬的 ZeroNews 用户：

为提供更稳定、高效的服务，我们将于2025年7月16日进行v3.0.0版本维护升级。

本次更新主要包含底层架构全面升级，TLS终结、集成中心及 Agent 3.0.0(客户端)等核心功能, 全新的架构不兼容现有 Agent 版本，您需要下载最新的 Agent 进行手动升级。

  1. 卸载旧版客户端(Agent)（各系统操作见下文）。
  2. 升级当日在用户平台完成新版客户端(Agent)下载及恢复Agent（各系统操作见下文）。

延迟升级将导致穿透服务不可用！​

升级期间，官方在线客服及技术支持团队将准时在线，为您提供支持。

二、核心功能预览​

安全与效率提升​

功能描述
TLS终止支持用户自定义上游服务/Agent端终止 TLS，用户掌握TLS证书，端到端数据加密，显著提升数据安全。
文件共享无公网IP远程访问本地文件，浏览器直连下载，数据永不离开您的设备。
流量管理实时监测服务流量，识别异常访问，优化带宽分配。

管理体验优化​

功能描述
云策略引擎重装系统/更换客户端(Agent)后，通过Token+Agent ID一键恢复映射规则与安全策略。
集成中心集成多种类型插件，覆盖映射安全、开发测试、身份认证等核心功能，有效提升平台兼容性与扩展性。
消息通知站内消息+微信推送，重要通知（如审核通知、服务到期、版本更新）零遗漏。

更多版本升级功能，请查看详情版本更新日志

三、各系统Agent升级操作指南​

  1. 首先登录用户平台 User Control Platform，然后进入到设备(Agent)页面

  2. 选择需要恢复的设备(Agent)，点击设备(Agent)详情，再点击恢复设备(Agent)

  3. 然后选择您设备(Agent)对应的系统，按照步骤进行操作，可直接复制对应的内容。

  4. 具体升级步骤可参考下面各系统更新说明

Windows系统更新​

下载新的 ZeroNews 安装包更新

  1. 右键以管理员方式打开旧版Agent，并执行如下命令卸载

    zeronews uninstall

  2. 下载最新的 ZeroNews 安装包，将程序解压到原有程序目录下（若已有最新Agent，可忽略下载步骤）

  3. 恢复现有设备(Agent)映射配置

    zeronews set token <authtoken> <agentid>

    备注：

    authtoken：登录用户平台， 在Token页面复制对应的token值即可

    agentid：登录用户平台，在设备(Agent)页面，找到您需要恢复的设备(Agent)对应的 id

  4. 启动Agent

    • 前台启动

      zeronews start

    • 后台服务启动

      zeronews start -d

Linux/树莓派 系统更新​

  1. 停止 ZeroNews 程序

    service zeronews stop

  2. 下载最新的 ZeroNews 程序 （若已有最新Agent，可忽略下载步骤）

    curl -SLk https://download.zeronews.cc/linux/zeronews-install.sh | sh -s install

  3. 恢复现有设备(Agent)映射配置

    zeronews set token <authtoken> <agentid>

    备注：

    authtoken：登录用户平台， 在Token页面复制对应的token值即可

    agentid：登录用户平台，在设备(Agent)页面，找到您需要恢复的设备(Agent)对应的 id

  4. 重新启动Agent

    service zeronews restart

macOS 系统更新​

  1. 卸载现有程序及服务

    Agent 低于 3.0 版本

    sudo zeronews uninstall

    sudo rm -rf /usr/local/bin/zeronews

    Agent 高于或等于 3.0 版本

    sudo rm -rf /usr/local/bin/zeronews

  2. 下载程序（若已有最新Agent，可忽略下载步骤）

    • Apple 芯片
    mkdir /Applications/zeronews || cd /Applications/zeronews && curl  -o zeronews.tmp  https://download.zeronews.cc/macos/arm/zeronews  &&  mv zeronews.tmp zeronews &&chmod +x  zeronews

    • Intel 芯片

      mkdir /Applications/zeronews || cd /Applications/zeronews && curl  -o zeronews.tmp  https://download.zeronews.cc/macos/amd/zeronews  &&  mv zeronews.tmp zeronews &&chmod +x  zeronews

  3. 恢复现有设备(Agent)映射配置

    ./zeronews set token <authtoken> <agentid>

    备注：

    authtoken：登录用户平台， 在Token页面复制对应的token值即可

    agentid：登录用户平台，在设备(Agent)页面，找到您需要恢复的设备(Agent)对应的 id

  4. 后台启动

    ./zeronews start -d

  5. 为方便实用 ZeroNews，建议添加软连接至系统环境变量中，可执行如下命令。

    sudo ln -s  /Applications/zeronews/zeronews  /usr/local/bin

OpenWrt 系统更新​

  1. 停止 ZeroNews 的程序

    /etc/init.d/zeronews stop

  2. 下载最新的 ZeroNews 程序（若已有最新Agent，可忽略下载步骤）

    curl -SLk https://download.zeronews.cc/openwrt/zeronews-install.sh | sh -s install

  3. 恢复现有设备(Agent)映射配置

    zeronews set token <authtoken> <agentid>

    备注：

    authtoken：登录用户平台， 在Token页面复制对应的token值即可

    agentid：登录用户平台，在设备(Agent)页面，找到您需要恢复的设备(Agent)对应的 id

  4. 重新启动 Agent

    /etc/init.d/zeronews restart

Docker 系统更新​

以 docker 方式部署 ZeroNews ，更新时，需要先下载最新的 ZeroNews 容器镜像

  1. 下载最新镜像（若已有最新Agent，可忽略下载步骤）

    docker pull docker.zeronews.cc/zeronews/zeronews:latest

从新镜像启动容器

  • docker run 方式启动容器

    1. 停止并删除原有 ZeroNews 容器， 容器名称根据实际的名称填写

      docker stop zeronews && docker rm zeronews

    2. 启动 ZeroNews 容器,挂载现有的 ZeroNews 配置文件目录,恢复映射配置

      docker run -d --name zeronews --net host -v /opt/zeronews:/etc/zeronews -e TOKEN="<authtoken> <agentid>" docker.zeronews.cc/zeronews/zeronews:latest

      备注：

      authtoken：登录用户平台， 在Token页面复制对应的token值即可

      agentid：登录用户平台，在设备(Agent)页面，找到您需要恢复的设备(Agent)对应的 id

  • docker compose 方式启动容器

    1. 进入到容器目录

      cd /opt/zeronews

    2. 停止容器

      docker compose down

    3. 重新生成docker-compose

      cat > /opt/zeronews/docker-compose.yml << EOF

      services:

        zeronews:

      ​    restart: always

      ​    image: zeronews/zeronews:latest

      ​    container_name: zeronews

      ​    hostname: zeronews

      ​    network_mode: host

      ​    volumes:

      ​      \- ./zeronews:/etc/zeronews

      ​    environment:

      ​      \- TZ=Asia/Shanghai

      ​      \- TOKEN=<authtoken> <agentid>

      EOF

      备注：

      authtoken：登录用户平台， 在Token页面复制对应的token值即可

      agentid：登录用户平台，在设备(Agent)页面，找到您需要恢复的设备(Agent)对应的 id

    4. 启动容器

      docker compose up -d

四、客服支持​

升级期间，技术支持团队全程在线：

ZeroNews团队致力于为用户提供企业级穿透服务！

  • 如有任何疑问，可以扫描客服二维码

  • 紧急问题：0755-26600873（固话）

ZeroNews产品团队

2025年7月11日