# 部署指南

部署顺序：中央 → 边缘 → 多用户/告警（可选）。详见 [README](README.md)。

---

## 第一步：部署中央服务器

**前置**：Docker、Docker Compose；端口 3000、9091、8428、9093 未被占用；磁盘充足。

```bash
cd central-server
cp env.example .env   # 可选，按需改端口、Traefik 等
bash deploy.sh
```

**验证**：Grafana http://localhost:3000（admin/admin123）、Prometheus http://localhost:9091、VictoriaMetrics http://localhost:8428。

**详细**：[CENTRAL_SERVER_CONFIG](CENTRAL_SERVER_CONFIG.md)、[central-server/CONFIGURATION.md](../central-server/CONFIGURATION.md)。

---

## 第二步：部署边缘节点

**前提**：中央已运行，VictoriaMetrics 8428 可访问。

- **本机同机**：`cd edge-agent && bash deploy.sh --local`（中央地址设为 host.docker.internal:8428）。
- **边缘跨机**：`cd edge-agent` → 编辑 `.env` 中 `CENTRAL_SERVER_HOST=中央IP` → `bash deploy.sh`。

**验证**：边缘 http://localhost:9092；中央 Grafana 选数据源 **VictoriaMetrics**，查询 `probe_success{job="network-ping"}` 可见边缘数据。

**targets.csv**：部署时自动生成 target-*.json；修改 targets.csv 后需手动 `cd config && ./update-configs.sh`，vmagent 每 5 分钟自动重载。

**常见问题**：  
- 看不到边缘数据：确认 `.env` 中为中央 IP（跨机不能用 host.docker.internal）；`curl -s -o /dev/null -w "%{http_code}" http://<中央IP>:8428/health` 应为 200。  
- 端口冲突：边缘已映射 9092，与中央 9091 区分。

**详细**：[EDGE_AGENT_CONFIG](EDGE_AGENT_CONFIG.md)、[TARGETS_AND_MONITORING](TARGETS_AND_MONITORING.md)。

---

## 第三步（可选）：多用户与告警

- **Grafana 多用户**：`cd central-server/config/grafana && bash setup-users.sh`，见 [USER_MANAGEMENT](USER_MANAGEMENT.md)。
- **告警**：规则见 [ALERTING](ALERTING.md)；通知渠道编辑 `central-server/config/alertmanager/alertmanager.yml`。

---

## 部署后检查清单

- **中央**：`docker compose ps` 中相关服务 Up；Grafana Prometheus 数据源可查 `up`。
- **边缘**：prometheus-edge、blackbox-exporter Up；Grafana 选 VictoriaMetrics 可查 `probe_success{job="network-ping"}`。
- **磁盘/端口**：`ss -tulpn` 查端口；空间不足时清理或扩容。

详见 [TROUBLESHOOTING](TROUBLESHOOTING.md)。