Agent升级

如下是不同系统的 ZeroNews Agent升级方法。

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

     ​

macOS系统

• 可以在终端输入命令直接在线升级, 升级后重新启动 ZeroNews Agent

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

Linux

• 可以在终端输入命令直接在线升级, 升级后重新启动 ZeroNews Agent

  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

树莓派

• 树莓派 类型 Agent通过在线脚本安装方式完成更新，更新完后重启 Agent

  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