argus/deployment/build/templates/client/INSTALL_CLIENT_zh.md

Argus Metric 客户端安装指南（容器内普通用户场景）

准备与连通性检查

• FTP 连接（需要账号密码，默认 ftpuser / ZGClab1234!）
  • curl -u ftpuser:ZGClab1234! -I ftp://<FTP_IP>:21/LATEST_VERSION
  • curl -u ftpuser:ZGClab1234! -s ftp://<FTP_IP>:21/ | head
• 下载安装脚本
  • curl -u ftpuser:ZGClab1234! -fsSL ftp://<FTP_IP>:21/setup.sh -o /tmp/setup.sh
  • chmod +x /tmp/setup.sh

元数据与主机名

• Agent 需要元数据（env/user/instance）与 Master 地址：
  • 方式A：hostname 形如 env-user-instance-xxx（推荐）
  • 方式B：导出环境变量：
    • export AGENT_ENV=dev
    • export AGENT_USER=<your_user>
    • export AGENT_INSTANCE=<node_id>
• Master 地址：
  • export MASTER_ENDPOINT=http://master.argus.com:3000

安装脚本会在开头检查上述条件，缺失时会终止并给出修复提示。

执行安装

• 以 root 运行（容器内如为非 root 用户请切换为 root）：
  • sudo /tmp/setup.sh --server <FTP_IP> --user ftpuser --password 'ZGClab1234!' --port 21
• 如需自定义安装根目录：--install-dir /opt/argus-metric

安装后自检（setup 自动执行）

• setup 会等待最多 5 分钟，确认以下条件后才报告完成：
  • /private/argus/agent/<hostname>/node.json 已生成；
  • last_report 在持续更新；
  • health.metric-argus-agent|metric-node-exporter|metric-fluent-bit|metric-dcgm-exporter 均为 healthy 且 error 为空。

手工验证（可选）

• cat /private/argus/agent/$(hostname)/node.json | jq '.'
• curl -s -o /dev/null -w "%{http_code}\n" http://localhost:9100/metrics 应为 200
• 查看日志：/var/log/argus-agent.log、/opt/argus-metric/versions/*/.install.log