怎么在 Linux 上启动客户端?

前台运行(注意:关闭终端窗口后,客户端程序会自动关闭) 在命令行窗口中执行:
zeronews start
后台运行 在命令行窗口中执行:
sudo zeronews service install
sudo zeronews service start
首次启动前需要先执行 zeronews authtoken <你的token> 完成认证,才能正常连接云端。

客户端支持后台运行吗?

支持。可以将客户端安装为系统服务实现后台长期运行:
sudo zeronews service install
sudo zeronews service start
sudo zeronews service status
安装为服务后,系统开机会自动启动客户端,无需手动执行 zeronews start

如何停止后台运行的客户端?

  • 如果是直接运行(前台或后台进程):
zeronews shutdown
  • 如果是以系统服务方式运行:
sudo zeronews service stop

如何卸载客户端的服务?

Linux 客户端执行以下命令:
sudo zeronews service uninstall
卸载服务后客户端不再随系统启动,但配置文件不会被删除。如需彻底清理所有状态,可执行 sudo zeronews reset

Linux 客户端执行 start 时提示 create temp runtime file: open /etc/zeronews/prg_runtime-xxxxxxxxxx.tmp: permission denied,怎么办?

该提示说明当前用户没有向 /etc/zeronews 目录写入文件的权限(Linux 默认工作目录为 /etc/zeronews,需要 root 权限)。 请使用 sudo 运行客户端:sudo zeronews start

Linux 客户端安装服务提示 installing service requires administrator privileges. Please run with sudo,怎么办?

该提示说明 Linux 客户端执行 zeronews service install 安装系统服务需要 root 管理员权限,因为安装服务需要将 systemd 服务文件写入 /etc/systemd/system/ 目录。 解决方法:使用 sudo 执行安装服务命令:
sudo zeronews service install
sudo zeronews service start

Linux 以服务方式启动客户端时提示 Failed to start zeronews-client.service: Unit zeronews-client.service not found,怎么办?

该提示说明服务器上尚未安装 zeronews 服务。请先执行服务安装命令,再启动:
sudo zeronews service install
sudo zeronews service start

如何在 Linux 上恢复现有客户端映射配置?

  1. 打开 Linux 设备命令行窗口。
  2. 登录 ZeroNews 平台,在「快速开始」页面选择 Linux 系统,复制 authtoken 命令,在命令行窗口中粘贴。
  3. 在「客户端管理」中找到要恢复的客户端,复制客户端 ID,粘贴到 token 后以空格分隔。
  4. 检查 authtoken 命令,命令格式为 zeronews authtoken <token> <客户端ID>
  5. 恢复命令确认无误后直接执行;执行成功后,再 start 启动客户端,要恢复的客户端映射配置会自动下发到新的客户端上。