zeronews reset 会清理当前设备上的客户端本地状态，包括配置文件、运行时状态与日志目录。执行后客户端回到未认证状态，需要重新执行 zeronews authtoken 才能再次连接云端。
重置只影响本机，不会删除控制台里的客户端记录，也不会删除云端隧道配置。若本机仍有隧道在运行，重置前请先停止客户端。
若要在新设备或重装系统后恢复原有隧道，请使用 恢复客户端。恢复流程会先 reset，再带上客户端 ID 执行 authtoken 拉取原映射。

​
适用场景

  • 更换 AuthToken：本地已有 config.yml，执行 authtoken 时提示 Local config file already exists, token update ignored
  • 重新认证：需要换绑账户 token，或本地配置损坏导致无法连接
  • 排查认证异常：排除本地旧配置干扰，从零开始重新认证
  • 卸载前清理：移除系统服务并清空工作目录中的客户端状态

​
重置会清理什么

reset 通常会：
  1. 若已安装系统服务，先尝试卸载服务
  2. 删除本地 config.yml
  3. 删除运行时状态文件（如 prg_runtime.json、control-plane.request.lock）
  4. 删除日志目录
控制台里的客户端 ID、隧道与域名配置不会被删除。

​
Windows

以管理员身份打开命令行，进入 zeronews.exe 所在目录后执行：
若客户端以系统服务方式运行，建议先停止服务再重置：

​
macOS

在终端进入客户端安装目录，使用 sudo 执行：
若已安装系统服务，可先停止：

​
Linux

使用 sudo 执行：
若已安装系统服务，可先停止：
Docker 部署若需清空容器内配置，通常应销毁并重建容器，同时确认数据卷挂载策略。仅当容器内本地配置需要清空、且控制台客户端仍离线时，才在容器内按 Linux 命令执行 reset。

​
重置后重新认证

重置完成后，按场景选择下一步： 认证为新客户端（控制台会出现一台新设备）：
恢复到已有离线客户端（保留原客户端 ID 与隧道）： 参见 恢复客户端，在 reset 后执行：
AuthToken 可在控制台 关联客户端 → 添加/认证设备 中查看，参见 关联客户端。