argus/deployment/build/templates/docs/INSTALL_SERVER_zh.md

Argus 服务端离线安装指南

先决条件

• Linux x86_64（推荐 Ubuntu 22.04；NixOS 见“兼容说明”）
• 已安装 Docker 与 Docker Compose
• 端口：32300, 9200, 5601, 9090, 9093, 8080..8085, 21, 20, 21100–21110

快速开始

1. 解压到目标目录（例如 /opt/argus-deploy/versions/<YYYYMMDD>）
2. 进入 scripts/：sudo ./server-prepare-dirs.sh（推荐）
3. 安装：./server-install.sh（支持普通用户：会自动创建最小目录并在容器内修复 Kibana/ES/Bind）
4. 状态：./server-status.sh
5. 自检：./server-selfcheck.sh（失败会自动采集诊断）
6. 卸载：./server-uninstall.sh

安装流程要点

• 仅启动 10 个服务端组件（不包含测试节点）；
• DNS Bootstrap：补齐首次部署 DNS 依赖（生成/确认 dns.conf、统一容器 resolv.conf、写入 *.argus.com、reload bind、重启 web‑proxy）；
• 输出自检结果到 logs/selfcheck.json。

兼容说明（NixOS 等）

• 使用 security_opt: ["label=disable"] 与 userns_mode: host。
• 若不能使用 sudo：安装器会创建最小目录（含 private/argus/log/{elasticsearch,kibana}），并在容器内完成：
  • Kibana 的 data 软链到 /private/argus/log/kibana
  • Elasticsearch 的 data 软链到 /private/argus/log/elasticsearch
  • Bind 生成 /etc/bind/rndc.key 安装后也可再执行 sudo ./server-prepare-dirs.sh 统一目录属主。

故障排查（见下文 Troubleshooting_zh）

• ./server-selfcheck.sh → logs/selfcheck.json
• ./server-diagnose.sh → logs/diagnose_error_*.log / logs/diagnose_details_*.log