恢复客户端

当客户端换到新设备，或原设备重装系统后，本地配置会丢失，控制台里原来的客户端通常会保持离线。此时不必重新添加设备、也不必重建隧道，可在控制台对这台离线客户端执行恢复，把原有隧道配置重新下发到当前设备。

恢复只适用于离线客户端。在线设备详情中的「恢复」按钮不可用。订阅到期导致的「已禁用」请参见已禁用状态说明与恢复方法，与本文不是同一件事。若只需清空本机配置并重新认证，而不恢复已有隧道，参见重置客户端。

适用场景

设备更换：原机器报废或换成新电脑 / 新服务器
系统重装：操作系统重装后本地 ZeroNews 配置被清空
环境迁移：把同一台客户端的映射配置迁到另一台机器

恢复完成后，原客户端 ID 保持不变，原先绑定在该客户端上的隧道会自动下发，无需逐条重建。

恢复页客户端

在 ZeroNews 用户控制的关联客户端页面，完成对已经离线的客户端进行恢复设备操作

登录 ZeroNews 控制台
打开顶部导航 关联客户端
在列表中找到要恢复的离线设备，打开设备详情
点击详情右上角恢复

进行客户端恢复操作

根据要恢复客户端的系统类型，选择对应的操作系统进行恢复

Windows

先以管理员身份运行 zeronews.exe，再依次执行恢复与启动。

1. 以管理员方式运行

右键 zeronews.exe，选择「以管理员身份运行」。安装或启动 Windows 服务也需要管理员权限。

2. 执行恢复命令

zeronews.exe reset
zeronews.exe authtoken <YOUR_AUTH_TOKEN> <CLIENT_ID>

3. 启动客户端

前台启动（关闭窗口后进程会退出）：

zeronews.exe start

后台服务启动：

zeronews.exe service install
zeronews.exe service start

macOS

在终端进入客户端安装目录后执行。

1. 执行恢复命令

cd /Applications/zeronews
sudo ./zeronews reset
sudo ./zeronews authtoken <YOUR_AUTH_TOKEN> <CLIENT_ID>

2. 启动客户端

前台启动：

sudo ./zeronews start

后台服务启动：

sudo ./zeronews service install
sudo ./zeronews service start

Linux

适用于 Linux 主机，以及控制台按 Linux 处理的 Docker、OpenWrt、NAS 等环境。命令需使用 sudo。

1. 执行恢复命令

sudo zeronews reset
sudo zeronews authtoken <YOUR_AUTH_TOKEN> <CLIENT_ID>

2. 启动客户端

前台启动：

sudo zeronews start

后台服务启动：

sudo zeronews service install
sudo zeronews service start

概览

常见问题

客户端常见问题

NAS 常见问题

订阅常见问题

其他问题

适用场景

恢复页客户端

进行客户端恢复操作

Windows

1. 以管理员方式运行

2. 执行恢复命令

3. 启动客户端

macOS

1. 执行恢复命令

2. 启动客户端

Linux

1. 执行恢复命令

2. 启动客户端

​适用场景

​恢复页客户端

​进行客户端恢复操作

​Windows

​1. 以管理员方式运行

​2. 执行恢复命令

​3. 启动客户端

​macOS

​1. 执行恢复命令

​2. 启动客户端

​Linux

​1. 执行恢复命令

​2. 启动客户端

适用场景

恢复页客户端

进行客户端恢复操作

Windows

1. 以管理员方式运行

2. 执行恢复命令

3. 启动客户端

macOS

1. 执行恢复命令

2. 启动客户端

Linux

1. 执行恢复命令

2. 启动客户端