安装 Agent

简体中文 | English

注册并启动

安装器会：

根据 stable 或 RC 渠道选择 Agent；
验证官方发布清单、大小和校验和；
安装必要的下载依赖；
注册节点并取得节点专用凭据；
启动 systemd 或 OpenRC 服务。

Center 不替安装器决定具体 Agent 版本。只有明确需要某一版本时，才直接向安装器传入 --version VERSION。重复运行安装命令会保留仍然有效的本地节点身份。

节点凭据、本地队列和恢复状态保存在只有 root 可读的 /var/lib/ipchronicle-agent。关闭自动注册只阻止新节点，不会断开已经注册的 Agent。

检查运行状态

# systemd
systemctl status ipchronicle-agent
journalctl -u ipchronicle-agent -f

# OpenRC
rc-service ipchronicle-agent status
tail -f /var/log/ipchronicle-agent.log

两分钟内上报过的节点视为在线。配置通常在下一次 30 秒轮询时生效。管理员可以开启最长十分钟的临时同步模式，以便实时调整；它使用 WebSocket 唤醒，但不会替代轮询，也不会打开 Agent 入站端口。

注册本身不会立即执行完整探测。默认周期计划为节点时区每天午夜，首次探测由管理员决定。

卸载

移除服务和二进制，但保留节点身份与待上报数据：

curl --proto '=https' --tlsv1.2 -fsSL \
  "https://raw.githubusercontent.com/ipchronicle/ipchronicle/main/scripts/install-agent.sh" |
  sh -s -- --uninstall

同时永久清除 /var/lib/ipchronicle-agent：

curl --proto '=https' --tlsv1.2 -fsSL \
  "https://raw.githubusercontent.com/ipchronicle/ipchronicle/main/scripts/install-agent.sh" |
  sh -s -- --uninstall --purge

--purge 会丢弃节点凭据、缓存配置、代理凭据、更新恢复状态、任务身份和待上传结果。再次安装会注册成新节点。两种卸载方式都不会删除 Center 中的节点配置或历史，旧节点需要在 Center 中另行吊销或删除。

安装 Agent ​

注册并启动 ​

检查运行状态 ​

卸载 ​

安装 Agent

注册并启动

检查运行状态

卸载