常见问题 - Zeronews documentation

以下问题适用于各平台客户端，平台相关的启动、服务安装与恢复步骤请参见 Windows、Linux、macOS、Docker 专题。

该提示表示客户端程序无法解析 zeronews.cc 的域名，通常是 DNS 故障导致，请检查网络。可按如下步骤排查：

该提示表示检测到存在同一个 Client ID 的客户端正在运行，拒绝重复连接。请检查并停止正在运行的客户端：

停止本机客户端
- 前台运行：关闭终端窗口或执行 Ctrl + C
- Windows 后台运行：以管理员方式打开客户端，执行 zeronews.exe service stop
- macOS 后台运行：执行 sudo ./zeronews service stop
- Linux 后台运行：执行 sudo zeronews service stop
停止客户端后，再重新启动客户端。

该提示说明本地工作目录下已经存在 config.yml 配置文件，authtoken 命令不会覆盖已有配置。如果需要更换 token 或重新认证，windows 已管理员方式运行客户端 , linxu / macos 则加 sudo 执行以下命令：

zeronews reset

reset 会清除本地配置文件和运行时状态，完成后再重新执行 zeronews authtoken <新token> 即可。

该提示说明提供的 authtoken 无效，可能是 token 填写错误或已失效。解决方法：

该提示说明当前套餐允许认证的客户端数量已达上限，无法再认证添加新客户端。解决方法：

该提示说明运行客户端的电脑或设备的本地 DNS 无法正常解析 userbackend.v2.zeronews.cc，导致客户端无法正常连接控制器。解决方法：

该提示说明客户端本地 HTTP API 默认端口（37271）已被占用，通常是已经有一个 zeronews start 进程在后台运行。ZeroNews 客户端默认提供 37271 端口的本地 HTTP 服务，用户可以在浏览器中打开查看客户端运行状态。解决方法：

先检查是否有运行中的客户端：执行 zeronews service status 查看状态。
如果已有运行中的客户端，直接使用即可，无需重复启动。
如果需要重启，执行 zeronews service stop 停止当前进程，再重新启动。
如果确认没有 zeronews 进程但端口仍被占用，检查其他程序是否占用了 37271 端口，或通过 --http_listen 参数指定其他端口启动，如 zeronews start --http_listen 0.0.0.0:37271。

该提示说明客户端与 cloud server 之间的 TCP 连接超时，网络层不通，常见原因是网络异常中断或防火墙拦截了到 ZeroNews 边缘节点的连接请求。解决方法：

检查本机网络是否正常，在命令行执行 ping 43.242.74.134 检测 ZeroNews 边缘节点网络是否正常；如果不能 ping 通，请检查本机网络。
如果能正常 ping 通，再检查本机防火墙（Windows Defender 防火墙 / iptables / ufw 等）是否放行了到该 IP 的 7000 端口出站流量。
检查上游网络设备（路由器、企业防火墙）是否有出站端口限制，需要放行对应端口的出站连接。
上述检查后仍无法连接 ZeroNews 边缘节点，请联系客服更换边缘节点。