Files

jack ab1515dffb refactor: config/apps 目录重组、文档重构、架构图收窄

- 中央：config/(prometheus,alertmanager,grafana)、apps/(tile-cache,topology-editor)
- 边缘：config/(vmagent,blackbox,targets)、apps/(onvif-exporter)
- env: TRAEFIK_PROVIDER、prometheus/env.example 详细说明
- 文档：README/doc 重构，EDGE_CACHE 合并到 EDGE_AGENT_CONFIG
- targets.csv 更新流程说明，ARCHITECTURE 图收窄

Made-with: Cursor

2026-02-28 22:05:43 -05:00

2.3 KiB

Raw Blame History

部署指南

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

第一步：部署中央服务器

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

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/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、TARGETS_AND_MONITORING。

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

Grafana 多用户：cd central-server/config/grafana && bash setup-users.sh，见 USER_MANAGEMENT。
告警：规则见 ALERTING；通知渠道编辑 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。

2.3 KiB Raw Blame History Unescape Escape