32 lines
1.6 KiB
Markdown
32 lines
1.6 KiB
Markdown
# 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`
|