Files

Super User 72a5bf30b4 feat: 天地图瓦片缓存(tile-cache)、拓扑标注助手与文档更新

- tile-cache: 瓦片缓存服务(vec/cva)、启动探针、详细日志、上游超时可配置(UPSTREAM_TIMEOUT_MS)
- central: docker-compose 集成 tile-cache，env.example 增加 TILE_CACHE_* / TIANDITU_TK
- topology-editor: 天地图/缓存加载、GPS 安全来源错误提示、TIANDITU 文档(403/白名单、localhost 测试说明)
- doc: README 部署步骤与 GPS 安全来源说明，TIANDITU_CONFIG 完善

Co-authored-by: Cursor <cursoragent@cursor.com>

2026-02-25 11:11:38 -05:00

2.7 KiB

Raw Blame History

部署指南

部署顺序见 doc/README.md#部署顺序：中央 → 边缘 → 多用户/告警（可选）→ 拓扑标注（可选）。本文为各步操作与验证要点。

第一步：部署中央服务器

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

cd central-server
cp env.example .env   # 可选
bash deploy.sh

验证：Grafana http://localhost:3000（admin/admin123）、Prometheus http://localhost:9091、VictoriaMetrics http://localhost:8428、拓扑标注助手 http://localhost:4080。

第二步：部署边缘节点

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

本机同机：cd edge-agent && bash run-edge-local.sh（中央地址设为 host.docker.internal:8428）。
边缘在另一台机器：
- 在 edge-agent 下 cp env.example .env，编辑 CENTRAL_SERVER_HOST、CENTRAL_SERVER_PORT=8428。
- cd config && ./update-configs.sh && cd .. && bash deploy.sh。

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

常见问题：

看不到边缘数据：确认 .env 中为中央 IP（非 host.docker.internal，除非本机同机）；从边缘 curl -s -o /dev/null -w "%{http_code}" http://<中央IP>:8428/health 应为 200。
端口冲突：边缘 Prometheus 已映射 9092，避免与中央 9091 冲突。

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

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

第四步（可选）：拓扑标注助手

与中央同机运行，访问 http://localhost:4080。上传本机 targets.csv → 选择设备、GPS 或地图点击补坐标 → 保存 → 下载 CSV → 将下载文件部署到各边缘 edge-agent/config/targets.csv，在边缘执行：

cd edge-agent/config && ./update-configs.sh && ./csv-to-topology-geojson.sh targets.csv topology.geojson

部署后检查清单

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

详见 TROUBLESHOOTING.md、README.md。

2.7 KiB Raw Blame History Unescape Escape