# 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. 安装：`./server-install.sh`（支持普通用户：会自动创建最小目录并在容器内修复 Kibana/ES/Bind）
3. 状态：`./server-status.sh`
4. 自检：`./server-selfcheck.sh`（失败会自动采集诊断）
5. 卸载：`./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`。
- 非 root 场景：安装器会创建最小目录（含 `private/argus/log/{elasticsearch,kibana}`），并在容器内完成：
  - Kibana 的 `data` 软链到 `/private/argus/log/kibana`
  - Elasticsearch 的 `data` 软链到 `/private/argus/log/elasticsearch`
  - Bind 生成 `/etc/bind/rndc.key`

## 故障排查（见下文 Troubleshooting_zh）
- `./server-selfcheck.sh` → `logs/selfcheck.json`
- `./server-diagnose.sh` → `logs/diagnose_error_*.log` / `logs/diagnose_details_*.log`