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
This commit is contained in:
2026-02-28 22:05:43 -05:00
parent 650e5145f1
commit ab1515dffb
48 changed files with 2071 additions and 509 deletions

1
.gitignore vendored
View File

@@ -2,7 +2,6 @@ central-server/data/
central-server/.env central-server/.env
edge-agent/.env edge-agent/.env
edge-agent/prometheus-edge/data/
# 生成文件(由 update-configs.sh 从 targets.csv 生成) # 生成文件(由 update-configs.sh 从 targets.csv 生成)
edge-agent/config/*.json edge-agent/config/*.json

View File

@@ -1,67 +1,91 @@
# Distributed-Prometheus # Distributed-Prometheus
分布式 Prometheus 监控系统,支持多用户多设备监控 分布式 Prometheus 监控系统:中央收集、边缘上报、多用户多设备。
--- ---
## 部署顺序 ## 架构概览
**先中央,后边缘**(边缘向中央上报,中央必须先就绪)。 ```
边缘 targets.csv → update-configs.sh → target-onvif / target-ping / target-topology
边缘 vmagent 抓取 → remote_write → 中央 VictoriaMetrics
中央 Prometheus 抓取本地 + 查 VictoriaMetrics → 告警 + Grafana
```
| 步骤 | 做什么 | 命令摘要 | 边缘将指标推送到中央 VictoriaMetrics8428Grafana 查询边缘数据选 **VictoriaMetrics**,中央自抓选 **Prometheus**
|------|--------|----------|
| **第一步** | 部署中央服务器 | `cd central-server && bash deploy.sh` |
| **第二步** | 部署边缘节点(可选,可多台) | 本机同机:`cd edge-agent && bash deploy.sh --local`;远程:配 `.env``bash deploy.sh` |
| **第三步** | 多用户 / 告警(可选) | Grafana`central-server/grafana/setup-users.sh`;告警:编辑 `alertmanager/alertmanager.yml` |
**完整说明、验证方式与文档入口****[doc/README.md](doc/README.md)**(建议先看其中的「部署顺序」)。
--- ---
## 项目结构 ## 项目结构
- **central-server/** — 中央Prometheus、Grafana、VictoriaMetrics、Alertmanager ```
- **edge-agent/** — 边缘vmagent、ONVIF Exporter、Blackbox Exporter Distributed-Prometheus/
├── central-server/ # 中央节点
│ ├── config/ # 配置prometheus、alertmanager、grafana
│ ├── apps/ # 自建应用tile-cache、topology-editor
│ └── data/ # 运行时数据gitignore
├── edge-agent/ # 边缘节点(可多台)
│ ├── config/ # 配置vmagent、blackbox、targets.csv
│ └── apps/ # 自建应用onvif-exporter
└── doc/ # 文档
```
--- ---
## 快速开始(对应第一步 + 第二步) ## 快速开始
1. **第一步:部署中央** **顺序**:中央 → 边缘(边缘上报中央,中央须先就绪)
```bash
cd central-server
cp env.example .env # 可选
bash deploy.sh
```
访问 Grafanahttp://localhost:3000admin / admin123
2. **第二步:部署边缘**(可选)
- 本机同机:`cd edge-agent && bash deploy.sh --local`
- 边缘在别台机器:在 `edge-agent` 里配 `.env` 后 `bash deploy.sh`
边缘数据在 Grafana 中需选择数据源 **「VictoriaMetrics」** 才能看到中央自身指标在数据源「Prometheus」。 ```bash
# 1. 中央
cd central-server && cp env.example .env && bash deploy.sh
3. **第三步(可选)**:多用户见 `doc/USER_MANAGEMENT.md`,告警见 `doc/ALERTING.md`。 # 2. 边缘(本机同机)
cd edge-agent && bash deploy.sh --local
# 2. 边缘(跨机)
cd edge-agent && cp env.example .env
# 编辑 .env 中 CENTRAL_SERVER_HOST=中央IP
bash deploy.sh
```
--- ---
## 访问地址(默认) ## 访问地址(默认)
- Grafana: http://localhost:3000 | 服务 | 端口 | URL |
- Prometheus: http://localhost:9091 |------|------|-----|
- VictoriaMetrics: http://localhost:8428 | Grafana | 3000 | http://localhost:3000 |
- Alertmanager: http://localhost:9093 | Prometheus | 9091 | http://localhost:9091 |
- 边缘 Prometheus端口 9092http://localhost:9092 | VictoriaMetrics | 8428 | http://localhost:8428 |
| Alertmanager | 9093 | http://localhost:9093 |
| GPS 标注助手 | 4080 | http://localhost:4080 |
| 边缘 vmagent | 9092 | http://localhost:9092 |
Grafana 默认 admin/admin123查边缘数据选数据源 **VictoriaMetrics**
--- ---
## 多用户与数据隔离 ## 监控目标targets.csv
Grafana 支持多组织、多用户;通过 Prometheus 标签做数据隔离(如 `user_group`)。管理员可查看全部数据。详见 **doc/USER_MANAGEMENT.md** 边缘监控目标在 `edge-agent/config/targets.csv`,部署时自动生成 `target-onvif.json``target-ping.json`
**修改 targets.csv 后**:手动执行 `cd edge-agent/config && ./update-configs.sh`(或重新 `deploy.sh`vmagent 每 5 分钟自动重载,无需重启。
详见 [doc/TARGETS_AND_MONITORING.md](doc/TARGETS_AND_MONITORING.md)。
--- ---
## 文档 ## 文档
**入口与部署顺序****[doc/README.md](doc/README.md)** | 类别 | 文档 |
|------|------|
其他文档均在 `doc/` 下架构ARCHITECTURE、中央/边缘配置、告警、部署指南、故障排查等,见 [doc/README.md#文档列表](doc/README.md) | **部署与配置** | [doc/README.md](doc/README.md) 部署步骤、[DEPLOYMENT_GUIDE](doc/DEPLOYMENT_GUIDE.md) |
| **架构** | [ARCHITECTURE](doc/ARCHITECTURE.md) 容器关系、数据流 |
| **中央** | [CENTRAL_SERVER_CONFIG](doc/CENTRAL_SERVER_CONFIG.md)、[central-server/CONFIGURATION.md](central-server/CONFIGURATION.md) |
| **边缘** | [EDGE_AGENT_CONFIG](doc/EDGE_AGENT_CONFIG.md)、[TARGETS_AND_MONITORING](doc/TARGETS_AND_MONITORING.md) |
| **告警** | [ALERTING](doc/ALERTING.md) 规则与 Alertmanager |
| **扩展** | [ONVIF_ALTERNATIVES](doc/ONVIF_ALTERNATIVES.md)、[TIANDITU_CONFIG](doc/TIANDITU_CONFIG.md)、[USER_MANAGEMENT](doc/USER_MANAGEMENT.md) |
| **运维** | [TROUBLESHOOTING](doc/TROUBLESHOOTING.md)、[BEST_PRACTICES](doc/BEST_PRACTICES.md) |

View File

@@ -8,10 +8,13 @@
- **`.env`** - 环境变量配置文件(从 `env.example` 复制并修改) - **`.env`** - 环境变量配置文件(从 `env.example` 复制并修改)
- **`docker-compose.yml`** - Docker Compose 服务定义(使用环境变量) - **`docker-compose.yml`** - Docker Compose 服务定义(使用环境变量)
- **`prometheus.yml.template`** - Prometheus 配置模板(部署时自动生成 `prometheus.yml` - **`config/`** - 配置目录
- **`prometheus.yml`** - Prometheus 实际配置文件(由模板自动生成,不要手动编辑 - `prometheus/` - Prometheus 配置prometheus.yml.template, prometheus.yml, alert_rules.yml
- **`alert_rules.yml`** - Prometheus 告警规则配置 - `alertmanager/` - Alertmanager 配置alertmanager.yml
- **`alertmanager/alertmanager.yml`** - Alertmanager 告警管理配置 - `grafana/` - Grafana 配置provisioning, dashboards
- **`apps/`** - 自建应用源码
- `tile-cache/` - 天地图瓦片缓存
- `topology-editor/` - GPS 标注助手
## 快速开始 ## 快速开始
@@ -30,7 +33,7 @@
部署脚本会自动: 部署脚本会自动:
- 加载 `.env` 文件中的环境变量 - 加载 `.env` 文件中的环境变量
- 从 `prometheus.yml.template` 生成 `prometheus.yml` - 从 `config/prometheus/prometheus.yml.template` 生成 `config/prometheus/prometheus.yml`
- 创建数据目录并设置权限 - 创建数据目录并设置权限
- 启动所有服务 - 启动所有服务
@@ -108,7 +111,7 @@
| 参数 | 默认值 | 说明 | | 参数 | 默认值 | 说明 |
|------|--------|------| |------|--------|------|
| `TIANDITU_TK` | (空) | **天地图密钥**,配置到 `.env` 中。启用后 tile-cache、拓扑助手「使用服务器缓存」及 Grafana Geomap 使用天地图底图时均使用此密钥,无需在浏览器或 Grafana 中填写。在 [天地图开放平台](https://console.tianditu.gov.cn/) 申请。 | | `TIANDITU_TK` | (空) | **天地图密钥**,配置到 `.env` 中。启用后 tile-cache Grafana Geomap 使用天地图底图时均使用此密钥,无需在 Grafana 中填写。在 [天地图开放平台](https://console.tianditu.gov.cn/) 申请。 |
| `TILE_CACHE_PORT` | 4090 | 瓦片缓存服务端口 | | `TILE_CACHE_PORT` | 4090 | 瓦片缓存服务端口 |
| `TILE_CACHE_DATA_DIR` | ./data/tile-cache | 瓦片缓存数据目录 | | `TILE_CACHE_DATA_DIR` | ./data/tile-cache | 瓦片缓存数据目录 |
| `TILE_CACHE_TTL_DAYS` | 7 | 缓存老化时间(天),超过后该瓦片下次请求时重新向天地图拉取;可改为 15 等 | | `TILE_CACHE_TTL_DAYS` | 7 | 缓存老化时间(天),超过后该瓦片下次请求时重新向天地图拉取;可改为 15 等 |
@@ -135,7 +138,8 @@
| 参数 | 默认值 | 说明 | | 参数 | 默认值 | 说明 |
|------|--------|------| |------|--------|------|
| `TRAEFIK_ENABLED` | true | 是否启用 Traefik 反向代理 | | `TRAEFIK_ENABLED` | true | 是否启用 Traefik 反向代理 |
| `TRAEFIK_NETWORK` | traefik | Traefik 网络名称 | | `TRAEFIK_PROVIDER` | external | Traefik 来源:**internal**=本编排启动 Traefik**external**=使用已有外部 Traefik |
| `TRAEFIK_NETWORK` | traefik | Traefik 网络名称external 时通常为 traefikinternal 时 deploy.sh 设为 central_default |
| `GRAFANA_DOMAIN` | grafana.example.com | Grafana 域名 | | `GRAFANA_DOMAIN` | grafana.example.com | Grafana 域名 |
| `PROMETHEUS_DOMAIN` | prometheus.example.com | Prometheus 域名 | | `PROMETHEUS_DOMAIN` | prometheus.example.com | Prometheus 域名 |
| `ALERTMANAGER_DOMAIN` | alertmanager.example.com | Alertmanager 域名 | | `ALERTMANAGER_DOMAIN` | alertmanager.example.com | Alertmanager 域名 |
@@ -145,11 +149,11 @@
**Traefik 配置说明** **Traefik 配置说明**
- 启用 Traefik 后,服务将通过域名访问,不再直接暴露端口 - 启用 Traefik 后,服务将通过域名访问,不再直接暴露端口
- 需要确保 Traefik 网络已创建:`docker network create traefik`(如果不存在) - **TRAEFIK_PROVIDER=internal**:本编排内启动 Traefik监听 80/443自动创建网络无需外部 Traefik
- 需要配置 DNS 解析,将域名指向 Traefik 服务器 - **TRAEFIK_PROVIDER=external**:接入已有 Traefik需 `docker network create traefik`(若不存在)
- 需要配置 DNS 解析,将域名指向本机
- VictoriaMetrics 通常不通过 Traefik 访问(边缘节点直接连接) - VictoriaMetrics 通常不通过 Traefik 访问(边缘节点直接连接)
- 如果使用 HTTPS需要配置 Traefik 的 TLS 证书 - 如果使用 HTTPS需要配置 Traefik 的 TLS 证书
- `NETWORK_NAME` 必须与 Traefik 实际网络一致,否则 Traefik 无法转发
### Docker 网络配置 ### Docker 网络配置
@@ -290,9 +294,9 @@ Docker Compose 配置文件,定义了所有服务的:
**注意**:此文件已配置为使用环境变量,一般不需要手动修改。 **注意**:此文件已配置为使用环境变量,一般不需要手动修改。
### prometheus.yml.template ### config/prometheus/prometheus.yml.template
Prometheus 配置模板文件,包含: Prometheus 配置模板文件(位于 `config/prometheus/`,包含:
- 全局配置(抓取间隔、评估间隔、集群名称) - 全局配置(抓取间隔、评估间隔、集群名称)
- 远程写入配置(接收边缘节点数据) - 远程写入配置(接收边缘节点数据)
- 抓取配置(抓取本地服务指标) - 抓取配置(抓取本地服务指标)
@@ -301,18 +305,18 @@ Prometheus 配置模板文件,包含:
**注意** **注意**
- 此文件是模板,不要直接使用 - 此文件是模板,不要直接使用
- 部署脚本会自动从此模板生成 `prometheus.yml` - 部署脚本会自动从此模板生成 `prometheus/prometheus.yml`
- 修改配置应通过 `.env` 文件,而不是直接修改模板 - 修改配置应通过 `.env` 文件,而不是直接修改模板
### prometheus.yml ### config/prometheus/prometheus.yml
Prometheus 实际配置文件,由 `prometheus.yml.template` 自动生成。 Prometheus 实际配置文件,由 `prometheus.yml.template` 自动生成。
**注意** **注意**
- 此文件由部署脚本自动生成,**不要手动编辑** - 此文件由部署脚本自动生成,**不要手动编辑**
- 如果需要修改,应修改 `prometheus.yml.template` 和 `.env` 文件 - 如果需要修改,应修改 `config/prometheus/prometheus.yml.template` 和 `.env` 文件
### alert_rules.yml ### config/prometheus/alert_rules.yml
Prometheus 告警规则配置文件,定义了: Prometheus 告警规则配置文件,定义了:
- ONVIF 设备告警规则(设备离线、高温、存储不足) - ONVIF 设备告警规则(设备离线、高温、存储不足)
@@ -320,7 +324,7 @@ Prometheus 告警规则配置文件,定义了:
**注意**:此文件需要手动编辑,修改后需要重启 Prometheus 服务。 **注意**:此文件需要手动编辑,修改后需要重启 Prometheus 服务。
### alertmanager/alertmanager.yml ### config/alertmanager/alertmanager.yml
Alertmanager 告警管理配置文件,定义了: Alertmanager 告警管理配置文件,定义了:
- 告警路由规则 - 告警路由规则
@@ -343,7 +347,7 @@ Alertmanager 告警管理配置文件,定义了:
**A**: **A**:
- 查看环境变量:`cat .env` - 查看环境变量:`cat .env`
- 查看生成的 Prometheus 配置:`cat prometheus.yml` - 查看生成的 Prometheus 配置:`cat config/prometheus/prometheus.yml`
- 查看 Docker Compose 配置:`cat docker-compose.yml` - 查看 Docker Compose 配置:`cat docker-compose.yml`
### Q3: 配置错误导致服务无法启动? ### Q3: 配置错误导致服务无法启动?
@@ -361,9 +365,7 @@ Alertmanager 告警管理配置文件,定义了:
# 备份所有配置文件 # 备份所有配置文件
tar -czf central-server-config-backup-$(date +%Y%m%d).tar.gz \ tar -czf central-server-config-backup-$(date +%Y%m%d).tar.gz \
.env \ .env \
prometheus.yml.template \ config/ \
alert_rules.yml \
alertmanager/alertmanager.yml \
docker-compose.yml docker-compose.yml
``` ```

View File

@@ -1,6 +1,6 @@
FROM node:20-alpine FROM node:20-alpine
WORKDIR /app WORKDIR /app
COPY tile-cache/package.json tile-cache/server.js ./ COPY apps/tile-cache/package.json apps/tile-cache/server.js ./
RUN mkdir -p /app/cache RUN mkdir -p /app/cache
ENV PORT=4090 ENV PORT=4090
EXPOSE 4090 EXPOSE 4090

View File

@@ -0,0 +1 @@
{"name":"tianditu-tile-cache","version":"1.0.0","description":"Cache Tianditu WMTS tiles to reduce API key usage","main":"server.js"}

View File

@@ -0,0 +1,3 @@
node_modules
*.log
.env*

View File

@@ -0,0 +1,16 @@
# GPS 标注助手H5 采集 GPS + 编辑 targets.csv构建上下文为 central-server
FROM node:20-alpine
WORKDIR /app
COPY apps/topology-editor/package.json ./
RUN npm install --production
COPY apps/topology-editor/server.js ./
COPY apps/topology-editor/public ./public
ENV PORT=4080
EXPOSE 4080
# 运行时由 docker-compose 挂载 edge-agent/config 到 /config并设置 CONFIG_DIR=/config
CMD ["node", "server.js"]

View File

@@ -0,0 +1,827 @@
{
"name": "topology-editor",
"version": "0.1.0",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "topology-editor",
"version": "0.1.0",
"dependencies": {
"express": "^4.19.2"
}
},
"node_modules/accepts": {
"version": "1.3.8",
"resolved": "https://registry.npmjs.org/accepts/-/accepts-1.3.8.tgz",
"integrity": "sha512-PYAthTa2m2VKxuvSD3DPC/Gy+U+sOA1LAuT8mkmRuvw+NACSaeXEQ+NHcVF7rONl6qcaxV3Uuemwawk+7+SJLw==",
"license": "MIT",
"dependencies": {
"mime-types": "~2.1.34",
"negotiator": "0.6.3"
},
"engines": {
"node": ">= 0.6"
}
},
"node_modules/array-flatten": {
"version": "1.1.1",
"resolved": "https://registry.npmjs.org/array-flatten/-/array-flatten-1.1.1.tgz",
"integrity": "sha512-PCVAQswWemu6UdxsDFFX/+gVeYqKAod3D3UVm91jHwynguOwAvYPhx8nNlM++NqRcK6CxxpUafjmhIdKiHibqg==",
"license": "MIT"
},
"node_modules/body-parser": {
"version": "1.20.4",
"resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.4.tgz",
"integrity": "sha512-ZTgYYLMOXY9qKU/57FAo8F+HA2dGX7bqGc71txDRC1rS4frdFI5R7NhluHxH6M0YItAP0sHB4uqAOcYKxO6uGA==",
"license": "MIT",
"dependencies": {
"bytes": "~3.1.2",
"content-type": "~1.0.5",
"debug": "2.6.9",
"depd": "2.0.0",
"destroy": "~1.2.0",
"http-errors": "~2.0.1",
"iconv-lite": "~0.4.24",
"on-finished": "~2.4.1",
"qs": "~6.14.0",
"raw-body": "~2.5.3",
"type-is": "~1.6.18",
"unpipe": "~1.0.0"
},
"engines": {
"node": ">= 0.8",
"npm": "1.2.8000 || >= 1.4.16"
}
},
"node_modules/bytes": {
"version": "3.1.2",
"resolved": "https://registry.npmjs.org/bytes/-/bytes-3.1.2.tgz",
"integrity": "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/call-bind-apply-helpers": {
"version": "1.0.2",
"resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
"integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
"license": "MIT",
"dependencies": {
"es-errors": "^1.3.0",
"function-bind": "^1.1.2"
},
"engines": {
"node": ">= 0.4"
}
},
"node_modules/call-bound": {
"version": "1.0.4",
"resolved": "https://registry.npmjs.org/call-bound/-/call-bound-1.0.4.tgz",
"integrity": "sha512-+ys997U96po4Kx/ABpBCqhA9EuxJaQWDQg7295H4hBphv3IZg0boBKuwYpt4YXp6MZ5AmZQnU/tyMTlRpaSejg==",
"license": "MIT",
"dependencies": {
"call-bind-apply-helpers": "^1.0.2",
"get-intrinsic": "^1.3.0"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/content-disposition": {
"version": "0.5.4",
"resolved": "https://registry.npmjs.org/content-disposition/-/content-disposition-0.5.4.tgz",
"integrity": "sha512-FveZTNuGw04cxlAiWbzi6zTAL/lhehaWbTtgluJh4/E95DqMwTmha3KZN1aAWA8cFIhHzMZUvLevkw5Rqk+tSQ==",
"license": "MIT",
"dependencies": {
"safe-buffer": "5.2.1"
},
"engines": {
"node": ">= 0.6"
}
},
"node_modules/content-type": {
"version": "1.0.5",
"resolved": "https://registry.npmjs.org/content-type/-/content-type-1.0.5.tgz",
"integrity": "sha512-nTjqfcBFEipKdXCv4YDQWCfmcLZKm81ldF0pAopTvyrFGVbcR6P/VAAd5G7N+0tTr8QqiU0tFadD6FK4NtJwOA==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/cookie": {
"version": "0.7.2",
"resolved": "https://registry.npmjs.org/cookie/-/cookie-0.7.2.tgz",
"integrity": "sha512-yki5XnKuf750l50uGTllt6kKILY4nQ1eNIQatoXEByZ5dWgnKqbnqmTrBE5B4N7lrMJKQ2ytWMiTO2o0v6Ew/w==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/cookie-signature": {
"version": "1.0.7",
"resolved": "https://registry.npmjs.org/cookie-signature/-/cookie-signature-1.0.7.tgz",
"integrity": "sha512-NXdYc3dLr47pBkpUCHtKSwIOQXLVn8dZEuywboCOJY/osA0wFSLlSawr3KN8qXJEyX66FcONTH8EIlVuK0yyFA==",
"license": "MIT"
},
"node_modules/debug": {
"version": "2.6.9",
"resolved": "https://registry.npmjs.org/debug/-/debug-2.6.9.tgz",
"integrity": "sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA==",
"license": "MIT",
"dependencies": {
"ms": "2.0.0"
}
},
"node_modules/depd": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/depd/-/depd-2.0.0.tgz",
"integrity": "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/destroy": {
"version": "1.2.0",
"resolved": "https://registry.npmjs.org/destroy/-/destroy-1.2.0.tgz",
"integrity": "sha512-2sJGJTaXIIaR1w4iJSNoN0hnMY7Gpc/n8D4qSCJw8QqFWXf7cuAgnEHxBpweaVcPevC2l3KpjYCx3NypQQgaJg==",
"license": "MIT",
"engines": {
"node": ">= 0.8",
"npm": "1.2.8000 || >= 1.4.16"
}
},
"node_modules/dunder-proto": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
"integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
"license": "MIT",
"dependencies": {
"call-bind-apply-helpers": "^1.0.1",
"es-errors": "^1.3.0",
"gopd": "^1.2.0"
},
"engines": {
"node": ">= 0.4"
}
},
"node_modules/ee-first": {
"version": "1.1.1",
"resolved": "https://registry.npmjs.org/ee-first/-/ee-first-1.1.1.tgz",
"integrity": "sha512-WMwm9LhRUo+WUaRN+vRuETqG89IgZphVSNkdFgeb6sS/E4OrDIN7t48CAewSHXc6C8lefD8KKfr5vY61brQlow==",
"license": "MIT"
},
"node_modules/encodeurl": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/encodeurl/-/encodeurl-2.0.0.tgz",
"integrity": "sha512-Q0n9HRi4m6JuGIV1eFlmvJB7ZEVxu93IrMyiMsGC0lrMJMWzRgx6WGquyfQgZVb31vhGgXnfmPNNXmxnOkRBrg==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/es-define-property": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
"integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
}
},
"node_modules/es-errors": {
"version": "1.3.0",
"resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
"integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
}
},
"node_modules/es-object-atoms": {
"version": "1.1.1",
"resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
"integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
"license": "MIT",
"dependencies": {
"es-errors": "^1.3.0"
},
"engines": {
"node": ">= 0.4"
}
},
"node_modules/escape-html": {
"version": "1.0.3",
"resolved": "https://registry.npmjs.org/escape-html/-/escape-html-1.0.3.tgz",
"integrity": "sha512-NiSupZ4OeuGwr68lGIeym/ksIZMJodUGOSCZ/FSnTxcrekbvqrgdUxlJOMpijaKZVjAJrWrGs/6Jy8OMuyj9ow==",
"license": "MIT"
},
"node_modules/etag": {
"version": "1.8.1",
"resolved": "https://registry.npmjs.org/etag/-/etag-1.8.1.tgz",
"integrity": "sha512-aIL5Fx7mawVa300al2BnEE4iNvo1qETxLrPI/o05L7z6go7fCw1J6EQmbK4FmJ2AS7kgVF/KEZWufBfdClMcPg==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/express": {
"version": "4.22.1",
"resolved": "https://registry.npmjs.org/express/-/express-4.22.1.tgz",
"integrity": "sha512-F2X8g9P1X7uCPZMA3MVf9wcTqlyNp7IhH5qPCI0izhaOIYXaW9L535tGA3qmjRzpH+bZczqq7hVKxTR4NWnu+g==",
"license": "MIT",
"dependencies": {
"accepts": "~1.3.8",
"array-flatten": "1.1.1",
"body-parser": "~1.20.3",
"content-disposition": "~0.5.4",
"content-type": "~1.0.4",
"cookie": "~0.7.1",
"cookie-signature": "~1.0.6",
"debug": "2.6.9",
"depd": "2.0.0",
"encodeurl": "~2.0.0",
"escape-html": "~1.0.3",
"etag": "~1.8.1",
"finalhandler": "~1.3.1",
"fresh": "~0.5.2",
"http-errors": "~2.0.0",
"merge-descriptors": "1.0.3",
"methods": "~1.1.2",
"on-finished": "~2.4.1",
"parseurl": "~1.3.3",
"path-to-regexp": "~0.1.12",
"proxy-addr": "~2.0.7",
"qs": "~6.14.0",
"range-parser": "~1.2.1",
"safe-buffer": "5.2.1",
"send": "~0.19.0",
"serve-static": "~1.16.2",
"setprototypeof": "1.2.0",
"statuses": "~2.0.1",
"type-is": "~1.6.18",
"utils-merge": "1.0.1",
"vary": "~1.1.2"
},
"engines": {
"node": ">= 0.10.0"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/express"
}
},
"node_modules/finalhandler": {
"version": "1.3.2",
"resolved": "https://registry.npmjs.org/finalhandler/-/finalhandler-1.3.2.tgz",
"integrity": "sha512-aA4RyPcd3badbdABGDuTXCMTtOneUCAYH/gxoYRTZlIJdF0YPWuGqiAsIrhNnnqdXGswYk6dGujem4w80UJFhg==",
"license": "MIT",
"dependencies": {
"debug": "2.6.9",
"encodeurl": "~2.0.0",
"escape-html": "~1.0.3",
"on-finished": "~2.4.1",
"parseurl": "~1.3.3",
"statuses": "~2.0.2",
"unpipe": "~1.0.0"
},
"engines": {
"node": ">= 0.8"
}
},
"node_modules/forwarded": {
"version": "0.2.0",
"resolved": "https://registry.npmjs.org/forwarded/-/forwarded-0.2.0.tgz",
"integrity": "sha512-buRG0fpBtRHSTCOASe6hD258tEubFoRLb4ZNA6NxMVHNw2gOcwHo9wyablzMzOA5z9xA9L1KNjk/Nt6MT9aYow==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/fresh": {
"version": "0.5.2",
"resolved": "https://registry.npmjs.org/fresh/-/fresh-0.5.2.tgz",
"integrity": "sha512-zJ2mQYM18rEFOudeV4GShTGIQ7RbzA7ozbU9I/XBpm7kqgMywgmylMwXHxZJmkVoYkna9d2pVXVXPdYTP9ej8Q==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/function-bind": {
"version": "1.1.2",
"resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
"integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
"license": "MIT",
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/get-intrinsic": {
"version": "1.3.0",
"resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
"integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
"license": "MIT",
"dependencies": {
"call-bind-apply-helpers": "^1.0.2",
"es-define-property": "^1.0.1",
"es-errors": "^1.3.0",
"es-object-atoms": "^1.1.1",
"function-bind": "^1.1.2",
"get-proto": "^1.0.1",
"gopd": "^1.2.0",
"has-symbols": "^1.1.0",
"hasown": "^2.0.2",
"math-intrinsics": "^1.1.0"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/get-proto": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
"integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
"license": "MIT",
"dependencies": {
"dunder-proto": "^1.0.1",
"es-object-atoms": "^1.0.0"
},
"engines": {
"node": ">= 0.4"
}
},
"node_modules/gopd": {
"version": "1.2.0",
"resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
"integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/has-symbols": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
"integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/hasown": {
"version": "2.0.2",
"resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
"integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
"license": "MIT",
"dependencies": {
"function-bind": "^1.1.2"
},
"engines": {
"node": ">= 0.4"
}
},
"node_modules/http-errors": {
"version": "2.0.1",
"resolved": "https://registry.npmjs.org/http-errors/-/http-errors-2.0.1.tgz",
"integrity": "sha512-4FbRdAX+bSdmo4AUFuS0WNiPz8NgFt+r8ThgNWmlrjQjt1Q7ZR9+zTlce2859x4KSXrwIsaeTqDoKQmtP8pLmQ==",
"license": "MIT",
"dependencies": {
"depd": "~2.0.0",
"inherits": "~2.0.4",
"setprototypeof": "~1.2.0",
"statuses": "~2.0.2",
"toidentifier": "~1.0.1"
},
"engines": {
"node": ">= 0.8"
},
"funding": {
"type": "opencollective",
"url": "https://opencollective.com/express"
}
},
"node_modules/iconv-lite": {
"version": "0.4.24",
"resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz",
"integrity": "sha512-v3MXnZAcvnywkTUEZomIActle7RXXeedOR31wwl7VlyoXO4Qi9arvSenNQWne1TcRwhCL1HwLI21bEqdpj8/rA==",
"license": "MIT",
"dependencies": {
"safer-buffer": ">= 2.1.2 < 3"
},
"engines": {
"node": ">=0.10.0"
}
},
"node_modules/inherits": {
"version": "2.0.4",
"resolved": "https://registry.npmjs.org/inherits/-/inherits-2.0.4.tgz",
"integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==",
"license": "ISC"
},
"node_modules/ipaddr.js": {
"version": "1.9.1",
"resolved": "https://registry.npmjs.org/ipaddr.js/-/ipaddr.js-1.9.1.tgz",
"integrity": "sha512-0KI/607xoxSToH7GjN1FfSbLoU0+btTicjsQSWQlh/hZykN8KpmMf7uYwPW3R+akZ6R/w18ZlXSHBYXiYUPO3g==",
"license": "MIT",
"engines": {
"node": ">= 0.10"
}
},
"node_modules/math-intrinsics": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
"integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
}
},
"node_modules/media-typer": {
"version": "0.3.0",
"resolved": "https://registry.npmjs.org/media-typer/-/media-typer-0.3.0.tgz",
"integrity": "sha512-dq+qelQ9akHpcOl/gUVRTxVIOkAJ1wR3QAvb4RsVjS8oVoFjDGTc679wJYmUmknUF5HwMLOgb5O+a3KxfWapPQ==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/merge-descriptors": {
"version": "1.0.3",
"resolved": "https://registry.npmjs.org/merge-descriptors/-/merge-descriptors-1.0.3.tgz",
"integrity": "sha512-gaNvAS7TZ897/rVaZ0nMtAyxNyi/pdbjbAwUpFQpN70GqnVfOiXpeUUMKRBmzXaSQ8DdTX4/0ms62r2K+hE6mQ==",
"license": "MIT",
"funding": {
"url": "https://github.com/sponsors/sindresorhus"
}
},
"node_modules/methods": {
"version": "1.1.2",
"resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz",
"integrity": "sha512-iclAHeNqNm68zFtnZ0e+1L2yUIdvzNoauKU4WBA3VvH/vPFieF7qfRlwUZU+DA9P9bPXIS90ulxoUoCH23sV2w==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/mime": {
"version": "1.6.0",
"resolved": "https://registry.npmjs.org/mime/-/mime-1.6.0.tgz",
"integrity": "sha512-x0Vn8spI+wuJ1O6S7gnbaQg8Pxh4NNHb7KSINmEWKiPE4RKOplvijn+NkmYmmRgP68mc70j2EbeTFRsrswaQeg==",
"license": "MIT",
"bin": {
"mime": "cli.js"
},
"engines": {
"node": ">=4"
}
},
"node_modules/mime-db": {
"version": "1.52.0",
"resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
"integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/mime-types": {
"version": "2.1.35",
"resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
"integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
"license": "MIT",
"dependencies": {
"mime-db": "1.52.0"
},
"engines": {
"node": ">= 0.6"
}
},
"node_modules/ms": {
"version": "2.0.0",
"resolved": "https://registry.npmjs.org/ms/-/ms-2.0.0.tgz",
"integrity": "sha512-Tpp60P6IUJDTuOq/5Z8cdskzJujfwqfOTkrwIwj7IRISpnkJnT6SyJ4PCPnGMoFjC9ddhal5KVIYtAt97ix05A==",
"license": "MIT"
},
"node_modules/negotiator": {
"version": "0.6.3",
"resolved": "https://registry.npmjs.org/negotiator/-/negotiator-0.6.3.tgz",
"integrity": "sha512-+EUsqGPLsM+j/zdChZjsnX51g4XrHFOIXwfnCVPGlQk/k5giakcKsuxCObBRu6DSm9opw/O6slWbJdghQM4bBg==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/object-inspect": {
"version": "1.13.4",
"resolved": "https://registry.npmjs.org/object-inspect/-/object-inspect-1.13.4.tgz",
"integrity": "sha512-W67iLl4J2EXEGTbfeHCffrjDfitvLANg0UlX3wFUUSTx92KXRFegMHUVgSqE+wvhAbi4WqjGg9czysTV2Epbew==",
"license": "MIT",
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/on-finished": {
"version": "2.4.1",
"resolved": "https://registry.npmjs.org/on-finished/-/on-finished-2.4.1.tgz",
"integrity": "sha512-oVlzkg3ENAhCk2zdv7IJwd/QUD4z2RxRwpkcGY8psCVcCYZNq4wYnVWALHM+brtuJjePWiYF/ClmuDr8Ch5+kg==",
"license": "MIT",
"dependencies": {
"ee-first": "1.1.1"
},
"engines": {
"node": ">= 0.8"
}
},
"node_modules/parseurl": {
"version": "1.3.3",
"resolved": "https://registry.npmjs.org/parseurl/-/parseurl-1.3.3.tgz",
"integrity": "sha512-CiyeOxFT/JZyN5m0z9PfXw4SCBJ6Sygz1Dpl0wqjlhDEGGBP1GnsUVEL0p63hoG1fcj3fHynXi9NYO4nWOL+qQ==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/path-to-regexp": {
"version": "0.1.12",
"resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.12.tgz",
"integrity": "sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ==",
"license": "MIT"
},
"node_modules/proxy-addr": {
"version": "2.0.7",
"resolved": "https://registry.npmjs.org/proxy-addr/-/proxy-addr-2.0.7.tgz",
"integrity": "sha512-llQsMLSUDUPT44jdrU/O37qlnifitDP+ZwrmmZcoSKyLKvtZxpyV0n2/bD/N4tBAAZ/gJEdZU7KMraoK1+XYAg==",
"license": "MIT",
"dependencies": {
"forwarded": "0.2.0",
"ipaddr.js": "1.9.1"
},
"engines": {
"node": ">= 0.10"
}
},
"node_modules/qs": {
"version": "6.14.2",
"resolved": "https://registry.npmjs.org/qs/-/qs-6.14.2.tgz",
"integrity": "sha512-V/yCWTTF7VJ9hIh18Ugr2zhJMP01MY7c5kh4J870L7imm6/DIzBsNLTXzMwUA3yZ5b/KBqLx8Kp3uRvd7xSe3Q==",
"license": "BSD-3-Clause",
"dependencies": {
"side-channel": "^1.1.0"
},
"engines": {
"node": ">=0.6"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/range-parser": {
"version": "1.2.1",
"resolved": "https://registry.npmjs.org/range-parser/-/range-parser-1.2.1.tgz",
"integrity": "sha512-Hrgsx+orqoygnmhFbKaHE6c296J+HTAQXoxEF6gNupROmmGJRoyzfG3ccAveqCBrwr/2yxQ5BVd/GTl5agOwSg==",
"license": "MIT",
"engines": {
"node": ">= 0.6"
}
},
"node_modules/raw-body": {
"version": "2.5.3",
"resolved": "https://registry.npmjs.org/raw-body/-/raw-body-2.5.3.tgz",
"integrity": "sha512-s4VSOf6yN0rvbRZGxs8Om5CWj6seneMwK3oDb4lWDH0UPhWcxwOWw5+qk24bxq87szX1ydrwylIOp2uG1ojUpA==",
"license": "MIT",
"dependencies": {
"bytes": "~3.1.2",
"http-errors": "~2.0.1",
"iconv-lite": "~0.4.24",
"unpipe": "~1.0.0"
},
"engines": {
"node": ">= 0.8"
}
},
"node_modules/safe-buffer": {
"version": "5.2.1",
"resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.2.1.tgz",
"integrity": "sha512-rp3So07KcdmmKbGvgaNxQSJr7bGVSVk5S9Eq1F+ppbRo70+YeaDxkw5Dd8NPN+GD6bjnYm2VuPuCXmpuYvmCXQ==",
"funding": [
{
"type": "github",
"url": "https://github.com/sponsors/feross"
},
{
"type": "patreon",
"url": "https://www.patreon.com/feross"
},
{
"type": "consulting",
"url": "https://feross.org/support"
}
],
"license": "MIT"
},
"node_modules/safer-buffer": {
"version": "2.1.2",
"resolved": "https://registry.npmjs.org/safer-buffer/-/safer-buffer-2.1.2.tgz",
"integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==",
"license": "MIT"
},
"node_modules/send": {
"version": "0.19.2",
"resolved": "https://registry.npmjs.org/send/-/send-0.19.2.tgz",
"integrity": "sha512-VMbMxbDeehAxpOtWJXlcUS5E8iXh6QmN+BkRX1GARS3wRaXEEgzCcB10gTQazO42tpNIya8xIyNx8fll1OFPrg==",
"license": "MIT",
"dependencies": {
"debug": "2.6.9",
"depd": "2.0.0",
"destroy": "1.2.0",
"encodeurl": "~2.0.0",
"escape-html": "~1.0.3",
"etag": "~1.8.1",
"fresh": "~0.5.2",
"http-errors": "~2.0.1",
"mime": "1.6.0",
"ms": "2.1.3",
"on-finished": "~2.4.1",
"range-parser": "~1.2.1",
"statuses": "~2.0.2"
},
"engines": {
"node": ">= 0.8.0"
}
},
"node_modules/send/node_modules/ms": {
"version": "2.1.3",
"resolved": "https://registry.npmjs.org/ms/-/ms-2.1.3.tgz",
"integrity": "sha512-6FlzubTLZG3J2a/NVCAleEhjzq5oxgHyaCU9yYXvcLsvoVaHJq/s5xXI6/XXP6tz7R9xAOtHnSO/tXtF3WRTlA==",
"license": "MIT"
},
"node_modules/serve-static": {
"version": "1.16.3",
"resolved": "https://registry.npmjs.org/serve-static/-/serve-static-1.16.3.tgz",
"integrity": "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA==",
"license": "MIT",
"dependencies": {
"encodeurl": "~2.0.0",
"escape-html": "~1.0.3",
"parseurl": "~1.3.3",
"send": "~0.19.1"
},
"engines": {
"node": ">= 0.8.0"
}
},
"node_modules/setprototypeof": {
"version": "1.2.0",
"resolved": "https://registry.npmjs.org/setprototypeof/-/setprototypeof-1.2.0.tgz",
"integrity": "sha512-E5LDX7Wrp85Kil5bhZv46j8jOeboKq5JMmYM3gVGdGH8xFpPWXUMsNrlODCrkoxMEeNi/XZIwuRvY4XNwYMJpw==",
"license": "ISC"
},
"node_modules/side-channel": {
"version": "1.1.0",
"resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz",
"integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==",
"license": "MIT",
"dependencies": {
"es-errors": "^1.3.0",
"object-inspect": "^1.13.3",
"side-channel-list": "^1.0.0",
"side-channel-map": "^1.0.1",
"side-channel-weakmap": "^1.0.2"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/side-channel-list": {
"version": "1.0.0",
"resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz",
"integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==",
"license": "MIT",
"dependencies": {
"es-errors": "^1.3.0",
"object-inspect": "^1.13.3"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/side-channel-map": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/side-channel-map/-/side-channel-map-1.0.1.tgz",
"integrity": "sha512-VCjCNfgMsby3tTdo02nbjtM/ewra6jPHmpThenkTYh8pG9ucZ/1P8So4u4FGBek/BjpOVsDCMoLA/iuBKIFXRA==",
"license": "MIT",
"dependencies": {
"call-bound": "^1.0.2",
"es-errors": "^1.3.0",
"get-intrinsic": "^1.2.5",
"object-inspect": "^1.13.3"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/side-channel-weakmap": {
"version": "1.0.2",
"resolved": "https://registry.npmjs.org/side-channel-weakmap/-/side-channel-weakmap-1.0.2.tgz",
"integrity": "sha512-WPS/HvHQTYnHisLo9McqBHOJk2FkHO/tlpvldyrnem4aeQp4hai3gythswg6p01oSoTl58rcpiFAjF2br2Ak2A==",
"license": "MIT",
"dependencies": {
"call-bound": "^1.0.2",
"es-errors": "^1.3.0",
"get-intrinsic": "^1.2.5",
"object-inspect": "^1.13.3",
"side-channel-map": "^1.0.1"
},
"engines": {
"node": ">= 0.4"
},
"funding": {
"url": "https://github.com/sponsors/ljharb"
}
},
"node_modules/statuses": {
"version": "2.0.2",
"resolved": "https://registry.npmjs.org/statuses/-/statuses-2.0.2.tgz",
"integrity": "sha512-DvEy55V3DB7uknRo+4iOGT5fP1slR8wQohVdknigZPMpMstaKJQWhwiYBACJE3Ul2pTnATihhBYnRhZQHGBiRw==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/toidentifier": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/toidentifier/-/toidentifier-1.0.1.tgz",
"integrity": "sha512-o5sSPKEkg/DIQNmH43V0/uerLrpzVedkUh8tGNvaeXpfpuwjKenlSox/2O/BTlZUtEe+JG7s5YhEz608PlAHRA==",
"license": "MIT",
"engines": {
"node": ">=0.6"
}
},
"node_modules/type-is": {
"version": "1.6.18",
"resolved": "https://registry.npmjs.org/type-is/-/type-is-1.6.18.tgz",
"integrity": "sha512-TkRKr9sUTxEH8MdfuCSP7VizJyzRNMjj2J2do2Jr3Kym598JVdEksuzPQCnlFPW4ky9Q+iA+ma9BGm06XQBy8g==",
"license": "MIT",
"dependencies": {
"media-typer": "0.3.0",
"mime-types": "~2.1.24"
},
"engines": {
"node": ">= 0.6"
}
},
"node_modules/unpipe": {
"version": "1.0.0",
"resolved": "https://registry.npmjs.org/unpipe/-/unpipe-1.0.0.tgz",
"integrity": "sha512-pjy2bYhSsufwWlKwPc+l3cN7+wuJlK6uz0YdJEOlQDbl6jo/YlPi4mb8agUkVC8BF7V8NuzeyPNqRksA3hztKQ==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
},
"node_modules/utils-merge": {
"version": "1.0.1",
"resolved": "https://registry.npmjs.org/utils-merge/-/utils-merge-1.0.1.tgz",
"integrity": "sha512-pMZTvIkT1d+TFGvDOqodOclx0QWkkgi6Tdoa8gC8ffGAAqz9pzPTZWAybbsHHoED/ztMtkv/VoYTYyShUn81hA==",
"license": "MIT",
"engines": {
"node": ">= 0.4.0"
}
},
"node_modules/vary": {
"version": "1.1.2",
"resolved": "https://registry.npmjs.org/vary/-/vary-1.1.2.tgz",
"integrity": "sha512-BNGbWLfd0eUPabhkXUVm0j8uuvREyTh5ovRa/dyow/BqAbZJyC+5fU+IzQOzmAKzYqYRAISoRhdQr3eIZ/PXqg==",
"license": "MIT",
"engines": {
"node": ">= 0.8"
}
}
}
}

View File

@@ -0,0 +1,13 @@
{
"name": "topology-editor",
"version": "0.1.0",
"description": "拓扑标注助手:上传/下载 targets.csvH5 采集 GPS 与地图校验。可与 central-server 或 edge-agent 同机运行。",
"main": "server.js",
"scripts": {
"start": "node server.js"
},
"dependencies": {
"express": "^4.19.2",
"multer": "^1.4.5-lts.1"
}
}

View File

@@ -0,0 +1,509 @@
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8" />
<title>拓扑标注助手GPS → targets.csv</title>
<meta name="viewport" content="width=device-width, initial-scale=1" />
<style>
body {
font-family: system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI",
sans-serif;
margin: 0;
padding: 16px;
}
h1 {
font-size: 18px;
margin-bottom: 8px;
}
label {
display: block;
margin-top: 8px;
font-size: 14px;
}
input,
select {
width: 100%;
padding: 6px 8px;
font-size: 14px;
box-sizing: border-box;
}
button {
margin-top: 12px;
padding: 8px 12px;
font-size: 14px;
}
.row {
margin-bottom: 8px;
}
.log {
margin-top: 12px;
font-size: 12px;
color: #555;
white-space: pre-wrap;
}
#map-section {
margin-top: 20px;
border: 1px solid #ccc;
border-radius: 8px;
overflow: hidden;
}
#map-section h2 {
font-size: 14px;
margin: 0;
padding: 8px 12px;
background: #f5f5f5;
}
#map-container {
width: 100%;
height: 300px;
background: #e8e8e8;
}
.map-tip {
font-size: 12px;
color: #666;
padding: 6px 12px;
margin: 0;
}
</style>
</head>
<body>
<h1>拓扑标注助手</h1>
<p style="font-size: 13px">
与 central 同机运行时:先<strong>上传</strong>本机 <code>targets.csv</code>,在页面上选设备、补 GPS 或新建后<strong>下载</strong> CSV 部署到边缘。与 edge-agent 同机挂载 config 时可直接读写 <code>config/targets.csv</code>
</p>
<div id="upload-download-section" class="row" style="margin-top:12px; padding:10px; background:#f9f9f9; border-radius:6px;">
<label>上传 / 下载 targets.csv</label>
<div style="display:flex; flex-wrap:wrap; gap:8px; align-items:center;">
<input type="file" id="csv-file" accept=".csv" style="width:auto; max-width:200px;" />
<button id="btn-upload">上传 CSV</button>
<a id="btn-download" href="/api/download" download="targets.csv" style="padding:8px 12px; font-size:14px; background:#0d6efd; color:#fff; text-decoration:none; border-radius:4px;">下载 targets.csv</a>
</div>
<p id="mode-hint" style="font-size:12px; color:#666; margin:8px 0 0 0;"></p>
</div>
<div class="row">
<label>选择已有设备(可选,推荐)</label>
<select id="existing">
<option value="">(新建设备)</option>
</select>
</div>
<p style="font-size: 13px">
若是新建设备:先选上面的「(新建设备)」,再填写下列字段。
</p>
<div class="row">
<label>设备类型 (type)</label>
<select id="type">
<option value="topology">topology哑设备/拓扑节点)</option>
<option value="ping">ping有 IP可探测</option>
<option value="onvif">onvif摄像头</option>
</select>
</div>
<div class="row">
<label>设备名称 (name唯一标识)</label>
<input id="name" placeholder="例如 core_sw_1 / camera_front" />
</div>
<div class="row">
<label>角色 (role)</label>
<select id="role">
<option value="core_switch">core_switch</option>
<option value="access_switch">access_switch</option>
<option value="camera">camera</option>
<option value="wireless_bridge">wireless_bridge</option>
<option value="media_converter">media_converter</option>
<option value="other">other</option>
</select>
</div>
<div class="row">
<label>上联设备名称 (parent可留空)</label>
<input id="parent" placeholder="例如 core_sw_1" />
</div>
<div class="row">
<label>上联链路类型 (uplink_type)</label>
<select id="uplink_type">
<option value="">(无)</option>
<option value="fiber">fiber光纤</option>
<option value="copper">copper铜缆</option>
<option value="wireless">wireless无线</option>
</select>
</div>
<div class="row">
<label>IP可选ping/onvif 用)</label>
<input id="ip" placeholder="192.168.x.x" />
</div>
<div class="row">
<label>位置描述 (location可选)</label>
<input id="location" placeholder="例如A栋3楼弱电井" />
</div>
<div class="row">
<label>经度 (lon)</label>
<input id="lon" readonly />
</div>
<div class="row">
<label>纬度 (lat)</label>
<input id="lat" readonly />
</div>
<button id="btn-gps">获取当前 GPS 坐标</button>
<button id="btn-save">保存到 targets.csv</button>
<div class="log" id="log"></div>
<section id="map-section">
<h2>地图校验</h2>
<div class="row">
<label>天地图 TK<a href="https://console.tianditu.gov.cn/" target="_blank" rel="noopener">申请密钥</a>,填一次即可)</label>
<input id="tianditu-tk" type="text" placeholder="请输入您的天地图 tk" />
</div>
<div style="display:flex; flex-wrap:wrap; gap:8px; align-items:center;">
<button id="btn-load-map">加载天地图(直接)</button>
<span id="cache-buttons" style="display:none;">
<button id="btn-load-map-cache">加载天地图(使用服务器缓存)</button>
</span>
</div>
<div id="map-container"></div>
<p class="map-tip">点击地图可修正坐标;有经纬度后会自动打点并居中。</p>
</section>
<script>
const logEl = document.getElementById("log");
const existingSelect = document.getElementById("existing");
let existingTargets = [];
let map = null;
let marker = null;
let accuracyCircle = null;
let lastGpsAccuracyM = null;
let mapSource = null;
let leafletMap = null;
let leafletMarker = null;
let cacheBaseUrl = "";
function log(msg) {
logEl.textContent = msg;
}
function getTk() {
return (document.getElementById("tianditu-tk").value || "").trim();
}
function loadTiandituMap() {
const tk = getTk();
if (!tk) {
log("请先填写天地图 TK 再加载地图。");
return;
}
try {
localStorage.setItem("tianditu_tk", tk);
} catch (e) {}
if (window.T && window.T.Map) {
initMap();
return;
}
log("正在加载天地图…");
const script = document.createElement("script");
script.src = "https://api.tianditu.gov.cn/api?v=4.0&tk=" + encodeURIComponent(tk);
script.onload = function () {
log("天地图加载成功,可点击地图修正坐标。");
initMap();
};
script.onerror = function () {
log("天地图加载失败,请检查 TK 或网络。");
};
document.head.appendChild(script);
}
function initMap() {
if (map && mapSource === "tianditu") return;
var T = window.T;
if (!T || !T.Map) return;
if (map) return;
mapSource = "tianditu";
map = new T.Map("map-container");
map.centerAndZoom(new T.LngLat(116.4, 39.9), 12);
map.addEventListener("click", function (e) {
var ll = e.lnglat;
var lat = Math.round(ll.lat * 1e6) / 1e6;
var lon = Math.round(ll.lng * 1e6) / 1e6;
document.getElementById("lat").value = lat;
document.getElementById("lon").value = lon;
updateMapMarker(lat, lon);
log("已从地图点击设置坐标lat=" + lat + ", lon=" + lon);
});
var latEl = document.getElementById("lat").value.trim();
var lonEl = document.getElementById("lon").value.trim();
if (latEl && lonEl) {
var lat = parseFloat(latEl), lon = parseFloat(lonEl);
if (!isNaN(lat) && !isNaN(lon)) updateMapMarker(lat, lon);
}
}
function loadLeafletThenInitCacheMap() {
if (window.L && window.L.map) {
initCacheMap();
return;
}
log("正在加载地图库…");
var link = document.createElement("link");
link.rel = "stylesheet";
link.href = "https://unpkg.com/leaflet@1.9.4/dist/leaflet.css";
link.integrity = "sha256-p4NxAoJBhIIN+hmNHrzRCf9tD/miZyoHS5obTRR9BMY=";
link.crossOrigin = "";
document.head.appendChild(link);
var script = document.createElement("script");
script.src = "https://unpkg.com/leaflet@1.9.4/dist/leaflet.js";
script.integrity = "sha256-20nQCchB9co0qIjJZRGuk2/Z9VM+kNiyxNV1lvTlZBo=";
script.crossOrigin = "";
script.onload = function () {
log("使用服务器缓存加载天地图,可点击地图修正坐标。");
initCacheMap();
};
script.onerror = function () { log("Leaflet 加载失败"); };
document.head.appendChild(script);
}
function initCacheMap() {
if (leafletMap) return;
if (!cacheBaseUrl) { log("未配置缓存服务"); return; }
document.getElementById("map-container").innerHTML = "";
map = null;
marker = null;
mapSource = "leaflet";
leafletMap = L.map("map-container").setView([39.9, 116.4], 12);
L.tileLayer(cacheBaseUrl + "/vec/{z}/{x}/{y}", { attribution: "© 天地图" }).addTo(leafletMap);
L.tileLayer(cacheBaseUrl + "/cva/{z}/{x}/{y}", { attribution: "" }).addTo(leafletMap);
leafletMap.on("click", function (e) {
var lat = Math.round(e.latlng.lat * 1e6) / 1e6;
var lon = Math.round(e.latlng.lng * 1e6) / 1e6;
document.getElementById("lat").value = lat;
document.getElementById("lon").value = lon;
updateMapMarker(lat, lon);
log("已从地图点击设置坐标lat=" + lat + ", lon=" + lon);
});
var latEl = document.getElementById("lat").value.trim();
var lonEl = document.getElementById("lon").value.trim();
if (latEl && lonEl) {
var lat = parseFloat(latEl), lon = parseFloat(lonEl);
if (!isNaN(lat) && !isNaN(lon)) updateMapMarker(lat, lon);
}
}
function updateMapMarker(lat, lon) {
if (isNaN(lat) || isNaN(lon)) return;
if (mapSource === "leaflet" && leafletMap) {
if (leafletMarker) leafletMap.removeLayer(leafletMarker);
leafletMarker = L.marker([lat, lon]).addTo(leafletMap);
leafletMap.setView([lat, lon], 17);
return;
}
if (window.T && map) {
var T = window.T;
if (marker) {
map.removeOverLay(marker);
marker = null;
}
if (accuracyCircle) {
map.removeOverLay(accuracyCircle);
accuracyCircle = null;
}
var lngLat = new T.LngLat(lon, lat);
marker = new T.Marker(lngLat);
map.addOverLay(marker);
map.panTo(lngLat);
map.setZoom(17);
if (lastGpsAccuracyM != null && lastGpsAccuracyM > 0 && T.Circle) {
try {
accuracyCircle = new T.Circle(lngLat, lastGpsAccuracyM, {
color: "#3388ff",
weight: 1,
opacity: 0.4,
});
map.addOverLay(accuracyCircle);
} catch (e) {}
}
}
}
function fillFormFromTarget(t) {
document.getElementById("type").value = t.type || "topology";
document.getElementById("name").value = t.name || "";
document.getElementById("role").value = t.role || "other";
document.getElementById("parent").value = t.parent || "";
document.getElementById("uplink_type").value = t.uplink_type || "";
document.getElementById("ip").value = t.ip || "";
document.getElementById("location").value = t.location || "";
document.getElementById("lat").value = t.lat || "";
document.getElementById("lon").value = t.lon || "";
if (t.lat && t.lon) {
var lat = parseFloat(t.lat), lon = parseFloat(t.lon);
if (!isNaN(lat) && !isNaN(lon)) updateMapMarker(lat, lon);
}
}
async function loadExisting() {
try {
const resp = await fetch("/api/targets");
if (!resp.ok) throw new Error("加载 targets.csv 失败");
existingTargets = await resp.json();
existingSelect.innerHTML =
'<option value="">(新建设备)</option>' +
existingTargets
.map(
(t) =>
`<option value="${(t.name || '').replace(/"/g, '&quot;')}">${(t.name || '')} (${t.type || ""} / ${t.role || ""})</option>`
)
.join("");
log("已加载现有设备列表,可从下拉框选择后补充 GPS。");
} catch (e) {
log("加载现有设备失败:" + e.message);
}
}
existingSelect.onchange = () => {
const name = existingSelect.value;
if (!name) {
const lat = document.getElementById("lat").value;
const lon = document.getElementById("lon").value;
fillFormFromTarget({
type: "topology",
role: "other",
lat,
lon,
});
return;
}
const t = existingTargets.find((r) => r.name === name);
if (!t) return;
fillFormFromTarget(t);
};
document.getElementById("btn-gps").onclick = () => {
if (!navigator.geolocation) {
log("当前浏览器不支持 Geolocation。");
return;
}
log("正在获取 GPS 坐标…");
navigator.geolocation.getCurrentPosition(
(pos) => {
const { latitude, longitude, accuracy } = pos.coords;
document.getElementById("lat").value = latitude.toFixed(6);
document.getElementById("lon").value = longitude.toFixed(6);
lastGpsAccuracyM = accuracy != null ? accuracy : null;
updateMapMarker(latitude, longitude);
var acc = lastGpsAccuracyM != null ? ",精度约 " + Math.round(lastGpsAccuracyM) + " 米" : "";
log("获取成功lat=" + latitude + ", lon=" + longitude + acc + "。请在地图上核对位置,若有偏差可点击地图修正。");
},
(err) => {
var msg = err.message || "";
if (msg.indexOf("secure origins") !== -1 || msg.indexOf("secure context") !== -1) {
log("获取定位失败:当前页面不是安全来源,浏览器不允许获取定位。请使用 https:// 访问本页,或在同一台电脑上用 http://localhost:4080 打开。");
} else {
log("获取定位失败:" + msg);
}
},
{
enableHighAccuracy: true,
timeout: 10000,
maximumAge: 0,
}
);
};
document.getElementById("btn-load-map").onclick = loadTiandituMap;
document.getElementById("btn-load-map-cache").onclick = loadLeafletThenInitCacheMap;
document.getElementById("btn-upload").onclick = async () => {
var fileInput = document.getElementById("csv-file");
if (!fileInput.files || !fileInput.files[0]) {
log("请先选择要上传的 CSV 文件。");
return;
}
var form = new FormData();
form.append("file", fileInput.files[0]);
try {
log("正在上传…");
var r = await fetch("/api/upload", { method: "POST", body: form });
var d = await r.json();
if (!r.ok) throw new Error(d.error || "上传失败");
log("已上传,共 " + (d.rows || 0) + " 条。");
loadExisting();
} catch (e) {
log("上传失败:" + e.message);
}
};
(async function setModeHint() {
try {
var r = await fetch("/api/mode");
var d = await r.json();
var el = document.getElementById("mode-hint");
el.textContent = d.mode === "file" ? "当前为「文件模式」:直接读写边缘 config/targets.csv保存后自动执行脚本。" : "当前为「内存模式」:请先上传 targets.csv编辑后可下载到本机再部署到边缘。";
} catch (e) {}
})();
(async function setMapConfig() {
try {
var r = await fetch("/api/map-config");
var d = await r.json();
if (d.cacheBaseUrl) {
cacheBaseUrl = d.cacheBaseUrl;
document.getElementById("cache-buttons").style.display = "inline";
}
} catch (e) {}
})();
(function () {
try {
var saved = localStorage.getItem("tianditu_tk");
if (saved) document.getElementById("tianditu-tk").value = saved;
} catch (e) {}
})();
document.getElementById("btn-save").onclick = async () => {
const payload = {
type: document.getElementById("type").value,
ip: document.getElementById("ip").value.trim(),
name: document.getElementById("name").value.trim(),
role: document.getElementById("role").value,
parent: document.getElementById("parent").value.trim(),
uplink_type: document.getElementById("uplink_type").value,
location: document.getElementById("location").value.trim(),
lat: document.getElementById("lat").value.trim(),
lon: document.getElementById("lon").value.trim(),
};
if (!payload.name || !payload.type) {
log("type 与 name 为必填。");
return;
}
try {
log("正在保存并重建配置…");
const resp = await fetch("/api/targets", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(payload),
});
const data = await resp.json();
if (!resp.ok) {
throw new Error(data.error || "请求失败");
}
log("已写入 targets.csv并触发 update-configs.sh。");
loadExisting();
} catch (e) {
log("保存失败:" + e.message);
}
};
loadExisting();
</script>

View File

@@ -0,0 +1,267 @@
const express = require('express');
const fs = require('fs');
const path = require('path');
const http = require('http');
const { exec } = require('child_process');
const multer = require('multer');
const app = express();
const PORT = process.env.PORT || 4080;
const TILE_CACHE_URL = (process.env.TILE_CACHE_URL || '').trim();
const ROOT_DIR = path.join(__dirname, '..');
const CONFIG_DIR = process.env.CONFIG_DIR || null;
const TARGETS_CSV = CONFIG_DIR ? path.join(CONFIG_DIR, 'targets.csv') : null;
const upload = multer({ storage: multer.memoryStorage() });
// 内存模式(与 central-server 一起跑、无挂载时):存一份 targets 的解析结果
const DEFAULT_HEADER = ['type', 'ip', 'name', 'role', 'parent', 'uplink_type', 'network', 'device_type', 'model', 'location', 'username', 'password', 'onvif_port', 'lat', 'lon'];
let memoryStore = {
comments: ['# 统一监控 + 拓扑目标配置文件\n', '# 格式: type,ip,name,role,parent,uplink_type,...\n'],
header: DEFAULT_HEADER,
rows: [],
};
function isFileMode() {
return CONFIG_DIR && TARGETS_CSV && fs.existsSync(TARGETS_CSV);
}
app.use(express.json());
app.use(express.static(path.join(__dirname, 'public')));
function parseCsv(text) {
const lines = text.split(/\r?\n/);
const comments = [];
let headerLineIndex = -1;
for (let i = 0; i < lines.length; i++) {
const line = lines[i].trim();
if (!line || line.startsWith('#')) {
comments.push(lines[i]);
continue;
}
headerLineIndex = i;
break;
}
if (headerLineIndex === -1) {
return { comments: lines, header: DEFAULT_HEADER, rows: [] };
}
const header = lines[headerLineIndex].split(',').map(s => s.trim());
const rows = [];
for (let i = headerLineIndex + 1; i < lines.length; i++) {
const raw = lines[i];
if (!raw || raw.trim().startsWith('#')) continue;
const parts = raw.split(',');
const obj = {};
header.forEach((h, idx) => {
obj[h] = (parts[idx] || '').trim();
});
if (Object.values(obj).every(v => v === '')) continue;
rows.push(obj);
}
return { comments, header, rows };
}
function stringifyCsv(comments, header, rows) {
const lines = [];
if (comments && comments.length) {
lines.push(...comments);
}
if (header && header.length) {
lines.push(header.join(','));
}
for (const row of rows) {
const line = header.map(h => (row[h] || '').replace(/,/g, ' ')).join(',');
lines.push(line);
}
return lines.join('\n') + '\n';
}
function loadTargets() {
if (isFileMode()) {
const text = fs.readFileSync(TARGETS_CSV, 'utf8');
return parseCsv(text);
}
return { ...memoryStore, rows: [...memoryStore.rows] };
}
function saveTargets(parsed) {
if (isFileMode()) {
const text = stringifyCsv(parsed.comments, parsed.header, parsed.rows);
fs.writeFileSync(TARGETS_CSV, text, 'utf8');
return;
}
memoryStore = {
comments: parsed.comments || memoryStore.comments,
header: parsed.header || memoryStore.header,
rows: parsed.rows || memoryStore.rows,
};
}
function rebuildConfigs() {
if (!CONFIG_DIR) return;
const cmd = `cd "${CONFIG_DIR}" && ./update-configs.sh`;
exec(cmd, (err, stdout, stderr) => {
if (err) {
console.error('重建配置失败:', err.message);
if (stderr) console.error(stderr);
return;
}
if (stdout) console.log(stdout);
});
}
app.get('/api/targets', (req, res) => {
try {
const parsed = loadTargets();
res.json(parsed.rows);
} catch (e) {
console.error(e);
res.status(500).json({ error: '读取 targets 失败' });
}
});
app.get('/api/mode', (req, res) => {
res.json({ mode: isFileMode() ? 'file' : 'memory' });
});
app.get('/api/map-config', (req, res) => {
res.json({ cacheBaseUrl: TILE_CACHE_URL ? '/tiles' : '' });
});
function proxyToTileCache(pathname, res) {
const url = TILE_CACHE_URL + pathname;
const u = new URL(url);
const client = u.protocol === 'https:' ? require('https') : require('http');
client.get(url, (proxyRes) => {
res.status(proxyRes.statusCode || 200);
if (proxyRes.headers['content-type']) res.setHeader('Content-Type', proxyRes.headers['content-type']);
if (proxyRes.headers['cache-control']) res.setHeader('Cache-Control', proxyRes.headers['cache-control']);
proxyRes.pipe(res);
}).on('error', (err) => {
res.status(502).json({ error: 'Tile cache unreachable: ' + err.message });
});
}
app.get('/tiles/vec/:z/:x/:y', (req, res) => {
if (!TILE_CACHE_URL) return res.status(503).send('Tile cache not configured');
proxyToTileCache(`/vec/${req.params.z}/${req.params.x}/${req.params.y}`, res);
});
app.get('/tiles/cva/:z/:x/:y', (req, res) => {
if (!TILE_CACHE_URL) return res.status(503).send('Tile cache not configured');
proxyToTileCache(`/cva/${req.params.z}/${req.params.x}/${req.params.y}`, res);
});
app.get('/api/download', (req, res) => {
try {
const parsed = loadTargets();
const text = stringifyCsv(parsed.comments, parsed.header, parsed.rows);
res.setHeader('Content-Type', 'text/csv; charset=utf-8');
res.setHeader('Content-Disposition', 'attachment; filename=targets.csv');
res.send(text);
} catch (e) {
console.error(e);
res.status(500).json({ error: '生成下载失败' });
}
});
app.post('/api/upload', upload.single('file'), (req, res) => {
try {
if (!req.file || !req.file.buffer) {
return res.status(400).json({ error: '请选择 CSV 文件上传' });
}
const text = req.file.buffer.toString('utf8');
const parsed = parseCsv(text);
if (!isFileMode()) {
memoryStore = parsed;
} else {
saveTargets(parsed);
}
res.json({ ok: true, rows: parsed.rows.length });
} catch (e) {
console.error(e);
res.status(500).json({ error: '解析 CSV 失败' });
}
});
app.post('/api/targets', (req, res) => {
try {
const {
type = '',
ip = '',
name = '',
role = '',
parent = '',
uplink_type = '',
network = '',
device_type = '',
model = '',
location = '',
username = '',
password = '',
onvif_port = '',
lat = '',
lon = '',
} = req.body || {};
if (!type || !name) {
return res.status(400).json({ error: 'type 与 name 为必填字段' });
}
const parsed = loadTargets();
const { header, rows } = parsed;
const idx = rows.findIndex((r) => r.name === name);
const row = {};
header.forEach((h) => {
row[h] = '';
});
Object.assign(row, {
type,
ip,
name,
role,
parent,
uplink_type,
network,
device_type,
model,
location,
username,
password,
onvif_port,
lat,
lon,
});
if (idx >= 0) {
rows[idx] = row;
} else {
rows.push(row);
}
saveTargets({ ...parsed, rows });
rebuildConfigs();
res.json({ ok: true, row });
} catch (e) {
console.error(e);
res.status(500).json({ error: '写入失败' });
}
});
app.listen(PORT, '0.0.0.0', () => {
console.log(`Topology editor listening on http://0.0.0.0:${PORT}`);
if (CONFIG_DIR) {
console.log(`CONFIG_DIR=${CONFIG_DIR} (file mode)`);
} else {
console.log('Running in memory mode: use Upload CSV / Download CSV');
}
});

View File

@@ -1,10 +1,25 @@
# Prometheus 中央服务器配置模板
# ============================================
# 说明:
# - 本文件为配置模板,包含 ${变量名} 占位符
# - 部署时由 deploy.sh 从 .env 读取变量,用 envsubst 生成 prometheus.yml
# - 请勿直接编辑 prometheus.yml修改应在此模板或 .env 中进行
#
# 变量来源central-server/.env参考 env.example本文件位于 config/prometheus/
# 涉及变量PROMETHEUS_SCRAPE_INTERVAL, PROMETHEUS_EVALUATION_INTERVAL,
# PROMETHEUS_CLUSTER_NAME, VICTORIAMETRICS_PORT,
# PROMETHEUS_REMOTE_WRITE_MAX_SAMPLES, PROMETHEUS_REMOTE_WRITE_CAPACITY,
# PROMETHEUS_REMOTE_WRITE_MAX_SHARDS
# ============================================
global: global:
scrape_interval: 15s scrape_interval: 15s
evaluation_interval: 15s evaluation_interval: 15s
external_labels: external_labels:
cluster: 'central-monitoring' cluster: 'central-monitoring'
# 远程写入配置 - 接收来自边缘节点的数据 # 远程写入:将中央 Prometheus 抓取到的本地服务指标推送到 VictoriaMetrics
# (边缘节点由 vmagent 直接 remote_write 到 VictoriaMetrics
remote_write: remote_write:
- url: http://victoria-metrics:8428/api/v1/write - url: http://victoria-metrics:8428/api/v1/write
queue_config: queue_config:
@@ -12,7 +27,7 @@ remote_write:
capacity: 20000 capacity: 20000
max_shards: 10 max_shards: 10
# 抓取配置 - 主要抓取本地服务 # 抓取配置:仅抓取中央本机 Docker 容器Prometheus/VM/Alertmanager/Grafana
scrape_configs: scrape_configs:
# 抓取中央Prometheus自身 # 抓取中央Prometheus自身
- job_name: 'prometheus-central' - job_name: 'prometheus-central'
@@ -40,11 +55,11 @@ scrape_configs:
static_configs: static_configs:
- targets: ['grafana:3000'] - targets: ['grafana:3000']
# 告警规则配置 # 告警规则alert_rules.yml 与 prometheus.yml 同目录
rule_files: rule_files:
- "alert_rules.yml" - "alert_rules.yml"
# Alertmanager配置 # Alertmanager:告警路由与静默
alerting: alerting:
alertmanagers: alertmanagers:
- static_configs: - static_configs:

View File

@@ -1,10 +1,25 @@
# Prometheus 中央服务器配置模板
# ============================================
# 说明:
# - 本文件为配置模板,包含 ${变量名} 占位符
# - 部署时由 deploy.sh 从 .env 读取变量,用 envsubst 生成 prometheus.yml
# - 请勿直接编辑 prometheus.yml修改应在此模板或 .env 中进行
#
# 变量来源central-server/.env参考 env.example本文件位于 config/prometheus/
# 涉及变量PROMETHEUS_SCRAPE_INTERVAL, PROMETHEUS_EVALUATION_INTERVAL,
# PROMETHEUS_CLUSTER_NAME, VICTORIAMETRICS_PORT,
# PROMETHEUS_REMOTE_WRITE_MAX_SAMPLES, PROMETHEUS_REMOTE_WRITE_CAPACITY,
# PROMETHEUS_REMOTE_WRITE_MAX_SHARDS
# ============================================
global: global:
scrape_interval: ${PROMETHEUS_SCRAPE_INTERVAL}s scrape_interval: ${PROMETHEUS_SCRAPE_INTERVAL}s
evaluation_interval: ${PROMETHEUS_EVALUATION_INTERVAL}s evaluation_interval: ${PROMETHEUS_EVALUATION_INTERVAL}s
external_labels: external_labels:
cluster: '${PROMETHEUS_CLUSTER_NAME}' cluster: '${PROMETHEUS_CLUSTER_NAME}'
# 远程写入配置 - 接收来自边缘节点的数据 # 远程写入:将中央 Prometheus 抓取到的本地服务指标推送到 VictoriaMetrics
# (边缘节点由 vmagent 直接 remote_write 到 VictoriaMetrics
remote_write: remote_write:
- url: http://victoria-metrics:${VICTORIAMETRICS_PORT}/api/v1/write - url: http://victoria-metrics:${VICTORIAMETRICS_PORT}/api/v1/write
queue_config: queue_config:
@@ -12,7 +27,7 @@ remote_write:
capacity: ${PROMETHEUS_REMOTE_WRITE_CAPACITY} capacity: ${PROMETHEUS_REMOTE_WRITE_CAPACITY}
max_shards: ${PROMETHEUS_REMOTE_WRITE_MAX_SHARDS} max_shards: ${PROMETHEUS_REMOTE_WRITE_MAX_SHARDS}
# 抓取配置 - 主要抓取本地服务 # 抓取配置:仅抓取中央本机 Docker 容器Prometheus/VM/Alertmanager/Grafana
scrape_configs: scrape_configs:
# 抓取中央Prometheus自身 # 抓取中央Prometheus自身
- job_name: 'prometheus-central' - job_name: 'prometheus-central'
@@ -40,11 +55,11 @@ scrape_configs:
static_configs: static_configs:
- targets: ['grafana:3000'] - targets: ['grafana:3000']
# 告警规则配置 # 告警规则alert_rules.yml 与 prometheus.yml 同目录
rule_files: rule_files:
- "alert_rules.yml" - "alert_rules.yml"
# Alertmanager配置 # Alertmanager:告警路由与静默
alerting: alerting:
alertmanagers: alertmanagers:
- static_configs: - static_configs:

View File

@@ -45,6 +45,36 @@ PROMETHEUS_REMOTE_WRITE_CAPACITY=${PROMETHEUS_REMOTE_WRITE_CAPACITY:-20000}
PROMETHEUS_REMOTE_WRITE_MAX_SHARDS=${PROMETHEUS_REMOTE_WRITE_MAX_SHARDS:-10} PROMETHEUS_REMOTE_WRITE_MAX_SHARDS=${PROMETHEUS_REMOTE_WRITE_MAX_SHARDS:-10}
GRAFANA_DEFAULT_LANGUAGE=${GRAFANA_DEFAULT_LANGUAGE:-zh-Hans} GRAFANA_DEFAULT_LANGUAGE=${GRAFANA_DEFAULT_LANGUAGE:-zh-Hans}
GRAFANA_DEFAULT_THEME=${GRAFANA_DEFAULT_THEME:-light} GRAFANA_DEFAULT_THEME=${GRAFANA_DEFAULT_THEME:-light}
TRAEFIK_PROVIDER=${TRAEFIK_PROVIDER:-external}
# 根据 TRAEFIK_ENABLED 与 TRAEFIK_PROVIDER 设置网络
if [ "${TRAEFIK_ENABLED:-false}" = "true" ]; then
case "${TRAEFIK_PROVIDER}" in
internal)
export NETWORK_NAME=${NETWORK_NAME:-central_default}
export EXTERNAL_NETWORK=${EXTERNAL_NETWORK:-false}
export TRAEFIK_NETWORK=${TRAEFIK_NETWORK:-central_default}
export COMPOSE_PROFILES="${COMPOSE_PROFILES:-},traefik-internal"
export COMPOSE_PROFILES="${COMPOSE_PROFILES#,}"
;;
external)
export NETWORK_NAME=${NETWORK_NAME:-traefik}
export EXTERNAL_NETWORK=${EXTERNAL_NETWORK:-true}
export TRAEFIK_NETWORK=${TRAEFIK_NETWORK:-traefik}
;;
*)
echo "⚠️ TRAEFIK_PROVIDER 应为 internal 或 external当前为 ${TRAEFIK_PROVIDER}"
export NETWORK_NAME=${NETWORK_NAME:-traefik}
export EXTERNAL_NETWORK=${EXTERNAL_NETWORK:-true}
export TRAEFIK_NETWORK=${TRAEFIK_NETWORK:-traefik}
;;
esac
else
# 不使用 Traefik使用 compose 默认网络,直连端口访问
export NETWORK_NAME=${NETWORK_NAME:-central_default}
export EXTERNAL_NETWORK=${EXTERNAL_NETWORK:-false}
export TRAEFIK_NETWORK=${TRAEFIK_NETWORK:-central_default}
fi
# 将相对路径转换为绝对路径Docker 需要绝对路径) # 将相对路径转换为绝对路径Docker 需要绝对路径)
# 获取脚本所在目录的绝对路径 # 获取脚本所在目录的绝对路径
@@ -140,12 +170,12 @@ fi
echo "" echo ""
# 从模板生成 prometheus.yml # 从模板生成 prometheus.yml
if [ -f "prometheus.yml.template" ]; then if [ -f "config/prometheus/prometheus.yml.template" ]; then
echo "📝 从模板生成 prometheus.yml..." echo "📝 从模板生成 config/prometheus/prometheus.yml..."
# 检查是否有 envsubst 命令 # 检查是否有 envsubst 命令
if command -v envsubst &> /dev/null; then if command -v envsubst &> /dev/null; then
envsubst < prometheus.yml.template > prometheus.yml envsubst < config/prometheus/prometheus.yml.template > config/prometheus/prometheus.yml
echo "✅ prometheus.yml 已生成" echo "✅ config/prometheus/prometheus.yml 已生成"
else else
echo "⚠️ envsubst 命令未找到,尝试使用 sed 替换..." echo "⚠️ envsubst 命令未找到,尝试使用 sed 替换..."
# 使用 sed 进行简单的变量替换 # 使用 sed 进行简单的变量替换
@@ -156,22 +186,22 @@ if [ -f "prometheus.yml.template" ]; then
-e "s/\${PROMETHEUS_REMOTE_WRITE_MAX_SAMPLES}/${PROMETHEUS_REMOTE_WRITE_MAX_SAMPLES}/g" \ -e "s/\${PROMETHEUS_REMOTE_WRITE_MAX_SAMPLES}/${PROMETHEUS_REMOTE_WRITE_MAX_SAMPLES}/g" \
-e "s/\${PROMETHEUS_REMOTE_WRITE_CAPACITY}/${PROMETHEUS_REMOTE_WRITE_CAPACITY}/g" \ -e "s/\${PROMETHEUS_REMOTE_WRITE_CAPACITY}/${PROMETHEUS_REMOTE_WRITE_CAPACITY}/g" \
-e "s/\${PROMETHEUS_REMOTE_WRITE_MAX_SHARDS}/${PROMETHEUS_REMOTE_WRITE_MAX_SHARDS}/g" \ -e "s/\${PROMETHEUS_REMOTE_WRITE_MAX_SHARDS}/${PROMETHEUS_REMOTE_WRITE_MAX_SHARDS}/g" \
prometheus.yml.template > prometheus.yml config/prometheus/prometheus.yml.template > config/prometheus/prometheus.yml
echo "✅ prometheus.yml 已生成(使用 sed" echo "✅ config/prometheus/prometheus.yml 已生成(使用 sed"
fi fi
elif [ ! -f "prometheus.yml" ]; then elif [ ! -f "config/prometheus/prometheus.yml" ]; then
echo "❌ 配置文件 prometheus.yml 不存在,且未找到模板文件" echo "❌ 配置文件 config/prometheus/prometheus.yml 不存在,且未找到模板文件"
exit 1 exit 1
fi fi
# 检查配置文件 # 检查配置文件
if [ ! -f "alert_rules.yml" ]; then if [ ! -f "config/prometheus/alert_rules.yml" ]; then
echo "❌ 配置文件 alert_rules.yml 不存在" echo "❌ 配置文件 config/prometheus/alert_rules.yml 不存在"
exit 1 exit 1
fi fi
if [ ! -f "alertmanager/alertmanager.yml" ]; then if [ ! -f "config/alertmanager/alertmanager.yml" ]; then
echo "❌ 配置文件 alertmanager/alertmanager.yml 不存在" echo "❌ 配置文件 config/alertmanager/alertmanager.yml 不存在"
exit 1 exit 1
fi fi
@@ -199,18 +229,23 @@ export GRAFANA_DOMAIN
export PROMETHEUS_DOMAIN export PROMETHEUS_DOMAIN
export ALERTMANAGER_DOMAIN export ALERTMANAGER_DOMAIN
# 检查 Traefik 网络(docker-compose.yml 中总是会引用此网络,无论是否启用 # 检查 Traefik 网络(仅 TRAEFIK_PROVIDER=external 时需已存在
echo "🔍 检查 Traefik 网络..." echo "🔍 检查 Traefik 网络..."
TRAEFIK_NET=${TRAEFIK_NETWORK:-traefik} TRAEFIK_NET=${TRAEFIK_NETWORK:-traefik}
if ! docker network inspect "$TRAEFIK_NET" &> /dev/null; then if [ "${TRAEFIK_ENABLED:-false}" != "true" ]; then
echo "✅ 未启用 Traefik使用 compose 默认网络"
elif [ "${TRAEFIK_PROVIDER}" = "internal" ]; then
echo "✅ 本编排启动 Traefik将自动创建网络 $TRAEFIK_NET"
elif ! docker network inspect "$TRAEFIK_NET" &> /dev/null; then
echo "⚠️ Traefik 网络 '$TRAEFIK_NET' 不存在,正在创建..." echo "⚠️ Traefik 网络 '$TRAEFIK_NET' 不存在,正在创建..."
if docker network create "$TRAEFIK_NET" 2>/dev/null; then if docker network create "$TRAEFIK_NET" 2>/dev/null; then
echo "✅ Traefik 网络 '$TRAEFIK_NET' 已创建" echo "✅ Traefik 网络 '$TRAEFIK_NET' 已创建"
else else
echo "❌ 无法创建 Traefik 网络 '$TRAEFIK_NET'" echo "❌ 无法创建 Traefik 网络 '$TRAEFIK_NET'"
echo " 请确保:" echo " 请确保:"
echo " 1. Traefik 已运行并创建了网络" echo " 1. 外部 Traefik 已运行并创建了网络"
echo " 2. 或手动创建网络: docker network create $TRAEFIK_NET" echo " 2. 或改为 TRAEFIK_PROVIDER=internal 由本编排启动 Traefik"
echo " 3. 或手动创建网络: docker network create $TRAEFIK_NET"
echo "" echo ""
read -p "是否继续部署?(y/N): " -n 1 -r read -p "是否继续部署?(y/N): " -n 1 -r
echo echo
@@ -220,7 +255,7 @@ if ! docker network inspect "$TRAEFIK_NET" &> /dev/null; then
fi fi
fi fi
else else
echo "✅ Traefik 网络 '$TRAEFIK_NET' 已存在" echo "✅ Traefik 网络 '$TRAEFIK_NET' 已存在(外部 Traefik"
fi fi
echo "" echo ""
@@ -229,9 +264,9 @@ echo "📁 创建数据目录..."
mkdir -p "${PROMETHEUS_DATA_DIR}" mkdir -p "${PROMETHEUS_DATA_DIR}"
mkdir -p "${GRAFANA_DATA_DIR}" mkdir -p "${GRAFANA_DATA_DIR}"
mkdir -p "${VICTORIAMETRICS_DATA_DIR}" mkdir -p "${VICTORIAMETRICS_DATA_DIR}"
mkdir -p grafana/dashboards mkdir -p config/grafana/dashboards
mkdir -p grafana/provisioning/datasources mkdir -p config/grafana/provisioning/datasources
mkdir -p grafana/provisioning/dashboards mkdir -p config/grafana/provisioning/dashboards
# 设置目录权限 # 设置目录权限
# Prometheus 需要写权限 # Prometheus 需要写权限
@@ -293,15 +328,17 @@ echo ""
# 检查是否启用 Traefik # 检查是否启用 Traefik
if [ "${TRAEFIK_ENABLED:-false}" = "true" ]; then if [ "${TRAEFIK_ENABLED:-false}" = "true" ]; then
echo "🔗 访问地址(通过 Traefik 反向代理):" echo "🔗 访问地址(通过 Traefik 反向代理):"
if [ "${TRAEFIK_PROVIDER}" = "internal" ]; then
echo " - Traefik 由本编排启动,监听 80/443 端口"
fi
echo " - Grafana仪表板: http://${GRAFANA_DOMAIN:-grafana.example.com} (admin/${GRAFANA_ADMIN_PASSWORD}) [${GRAFANA_DEFAULT_LANGUAGE}界面]" echo " - Grafana仪表板: http://${GRAFANA_DOMAIN:-grafana.example.com} (admin/${GRAFANA_ADMIN_PASSWORD}) [${GRAFANA_DEFAULT_LANGUAGE}界面]"
echo " - Prometheus: http://${PROMETHEUS_DOMAIN:-prometheus.example.com} [英文界面]" echo " - Prometheus: http://${PROMETHEUS_DOMAIN:-prometheus.example.com} [英文界面]"
echo " - Alertmanager: http://${ALERTMANAGER_DOMAIN:-alertmanager.example.com} [英文界面]" echo " - Alertmanager: http://${ALERTMANAGER_DOMAIN:-alertmanager.example.com} [英文界面]"
echo " - VictoriaMetrics: http://localhost:${VICTORIAMETRICS_PORT} [英文界面,边缘节点直接连接]" echo " - VictoriaMetrics: http://localhost:${VICTORIAMETRICS_PORT} [英文界面,边缘节点直接连接]"
echo "" echo ""
echo "⚠️ 请确保:" echo "⚠️ 请确保:"
echo " 1. DNS 已正确解析域名到 Traefik 服务器" echo " 1. DNS 已正确解析域名到本机"
echo " 2. Traefik 网络 (${TRAEFIK_NETWORK:-traefik_default}) 已创建" echo " 2. 边缘节点可以访问此服务器的${VICTORIAMETRICS_PORT}端口VictoriaMetrics 不通过 Traefik"
echo " 3. 边缘节点可以访问此服务器的${VICTORIAMETRICS_PORT}端口VictoriaMetrics 不通过 Traefik"
else else
echo "🔗 访问地址:" echo "🔗 访问地址:"
echo " - Grafana仪表板: http://localhost:${GRAFANA_PORT} (admin/${GRAFANA_ADMIN_PASSWORD}) [${GRAFANA_DEFAULT_LANGUAGE}界面]" echo " - Grafana仪表板: http://localhost:${GRAFANA_PORT} (admin/${GRAFANA_ADMIN_PASSWORD}) [${GRAFANA_DEFAULT_LANGUAGE}界面]"

View File

@@ -4,12 +4,13 @@ services:
image: prom/prometheus:latest image: prom/prometheus:latest
container_name: prometheus-central container_name: prometheus-central
restart: unless-stopped restart: unless-stopped
mem_limit: "128m"
ports: ports:
- "${PROMETHEUS_PORT:-9091}:9090" - "${PROMETHEUS_PORT:-9091}:9090"
volumes: volumes:
- ${PROMETHEUS_DATA_DIR:-./data/prometheus-data}:/prometheus - ${PROMETHEUS_DATA_DIR:-./data/prometheus-data}:/prometheus
- ./prometheus.yml:/etc/prometheus/prometheus.yml:ro - ./config/prometheus/prometheus.yml:/etc/prometheus/prometheus.yml:ro
- ./alert_rules.yml:/etc/prometheus/alert_rules.yml:ro - ./config/prometheus/alert_rules.yml:/etc/prometheus/alert_rules.yml:ro
command: command:
- '--config.file=/etc/prometheus/prometheus.yml' - '--config.file=/etc/prometheus/prometheus.yml'
- "--storage.tsdb.retention.time=${PROMETHEUS_RETENTION_TIME:-30d}" - "--storage.tsdb.retention.time=${PROMETHEUS_RETENTION_TIME:-30d}"
@@ -29,6 +30,7 @@ services:
image: grafana/grafana:latest image: grafana/grafana:latest
container_name: grafana container_name: grafana
restart: unless-stopped restart: unless-stopped
mem_limit: "128m"
ports: ports:
- "${GRAFANA_PORT:-3000}:3000" - "${GRAFANA_PORT:-3000}:3000"
environment: environment:
@@ -41,8 +43,8 @@ services:
- GF_SERVER_ROOT_URL=${GRAFANA_ROOT_URL:-http://localhost:3000} - GF_SERVER_ROOT_URL=${GRAFANA_ROOT_URL:-http://localhost:3000}
volumes: volumes:
- ${GRAFANA_DATA_DIR:-./data/grafana-data}:/var/lib/grafana - ${GRAFANA_DATA_DIR:-./data/grafana-data}:/var/lib/grafana
- ./grafana/provisioning:/etc/grafana/provisioning - ./config/grafana/provisioning:/etc/grafana/provisioning
- ./grafana/dashboards:/var/lib/grafana/dashboards - ./config/grafana/dashboards:/var/lib/grafana/dashboards
labels: labels:
- "traefik.enable=${TRAEFIK_ENABLED:-true}" - "traefik.enable=${TRAEFIK_ENABLED:-true}"
- "traefik.http.routers.grafana.rule=Host(`${GRAFANA_DOMAIN:-grafana.example.com}`)" - "traefik.http.routers.grafana.rule=Host(`${GRAFANA_DOMAIN:-grafana.example.com}`)"
@@ -56,10 +58,11 @@ services:
image: prom/alertmanager:latest image: prom/alertmanager:latest
container_name: alertmanager container_name: alertmanager
restart: unless-stopped restart: unless-stopped
mem_limit: "32m"
ports: ports:
- "${ALERTMANAGER_PORT:-9093}:9093" - "${ALERTMANAGER_PORT:-9093}:9093"
volumes: volumes:
- ./alertmanager/alertmanager.yml:/etc/alertmanager/alertmanager.yml:ro - ./config/alertmanager/alertmanager.yml:/etc/alertmanager/alertmanager.yml:ro
labels: labels:
- "traefik.enable=${TRAEFIK_ENABLED:-true}" - "traefik.enable=${TRAEFIK_ENABLED:-true}"
- "traefik.http.routers.alertmanager.rule=Host(`${ALERTMANAGER_DOMAIN:-alertmanager.example.com}`)" - "traefik.http.routers.alertmanager.rule=Host(`${ALERTMANAGER_DOMAIN:-alertmanager.example.com}`)"
@@ -73,6 +76,7 @@ services:
image: victoriametrics/victoria-metrics:latest image: victoriametrics/victoria-metrics:latest
container_name: victoria-metrics container_name: victoria-metrics
restart: unless-stopped restart: unless-stopped
mem_limit: "64m"
ports: ports:
- "${VICTORIAMETRICS_PORT:-8428}:8428" - "${VICTORIAMETRICS_PORT:-8428}:8428"
volumes: volumes:
@@ -82,11 +86,47 @@ services:
- "--retentionPeriod=${VICTORIAMETRICS_RETENTION_PERIOD:-30d}" - "--retentionPeriod=${VICTORIAMETRICS_RETENTION_PERIOD:-30d}"
- "--httpListenAddr=:${VICTORIAMETRICS_PORT:-8428}" - "--httpListenAddr=:${VICTORIAMETRICS_PORT:-8428}"
# GPS 标注助手(上传/下载 targets.csvH5 采集 GPS + 天地图校验)
topology-editor:
build:
context: .
dockerfile: apps/topology-editor/Dockerfile
image: topology-editor:local
container_name: topology-editor
restart: unless-stopped
environment:
- PORT=4080
- TILE_CACHE_URL=http://tile-cache:4090
ports:
- "${TOPOLOGY_EDITOR_PORT:-4080}:4080"
mem_limit: "128m"
# Traefik 反向代理(仅 TRAEFIK_PROVIDER=internal 时启动)
traefik:
image: traefik:v2.10
container_name: traefik-central
restart: unless-stopped
profiles:
- traefik-internal
command:
- "--api.insecure=true"
- "--providers.docker=true"
- "--providers.docker.exposedbydefault=false"
- "--providers.docker.network=${TRAEFIK_NETWORK:-central_default}"
- "--entrypoints.web.address=:80"
- "--entrypoints.websecure.address=:443"
ports:
- "${TRAEFIK_HTTP_PORT:-80}:80"
- "${TRAEFIK_HTTPS_PORT:-443}:443"
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
mem_limit: "64m"
# 天地图瓦片缓存(节省 key 免费量;可手动清空缓存后重新拉取) # 天地图瓦片缓存(节省 key 免费量;可手动清空缓存后重新拉取)
tile-cache: tile-cache:
build: build:
context: .. context: .
dockerfile: tile-cache/Dockerfile dockerfile: apps/tile-cache/Dockerfile
image: tile-cache:local image: tile-cache:local
container_name: tile-cache container_name: tile-cache
restart: unless-stopped restart: unless-stopped
@@ -100,7 +140,7 @@ services:
- ${TILE_CACHE_DATA_DIR:-./data/tile-cache}:/cache - ${TILE_CACHE_DATA_DIR:-./data/tile-cache}:/cache
ports: ports:
- "${TILE_CACHE_PORT:-4090}:4090" - "${TILE_CACHE_PORT:-4090}:4090"
mem_limit: "128m" mem_limit: "32m"
# 定义网络配置(默认使用已存在的 traefik 网络) # 定义网络配置(默认使用已存在的 traefik 网络)

View File

@@ -1,55 +1,85 @@
# 中央服务器环境变量配置 # =============================================================================
# 复制此文件为 .env 并根据实际情况修改 # 中央服务器环境变量配置模板
# =============================================================================
#
# 【用途】
# 本文件为 central-server 所有可配置参数的模板,供 deploy.sh 和 docker-compose 使用。
# 部署脚本 deploy.sh 会读取 .env并将部分变量代入 prometheus.yml.template 生成 prometheus.yml。
#
# 【使用方式】
# 1. 复制为 .env cp env.example .env
# 2. 编辑 .env按实际环境修改参数
# 3. 运行部署脚本: ./deploy.sh
#
# 若不存在 .envdeploy.sh 会自动从 env.example 创建,并提示修改后重试。
#
# 【变量去向】
# - deploy.sh加载 .env生成 prometheus.yml创建数据目录启动 docker-compose
# - docker-compose端口、数据目录、容器环境变量、Traefik 标签等
# - prometheus.yml.templatePROMETHEUS_*、VICTORIAMETRICS_PORT 等(见模板头部)
#
# 【修改生效】
# 修改 .env 后需重新运行 ./deploy.sh。不要直接编辑 prometheus.yml其由模板生成。
#
# =============================================================================
# ============================================ # ============================================
# 端口配置 # 端口配置
# ============================================ # ============================================
# 宿主机映射端口,对应各服务容器内端口。端口冲突时修改此处。
# Prometheus 端口(避免与 cockpit 冲突 # Prometheus Web UI 端口(避免与 cockpit 9090 冲突,故默认 9091
# 访问http://localhost:${PROMETHEUS_PORT}
PROMETHEUS_PORT=9091 PROMETHEUS_PORT=9091
# Grafana 端口 # Grafana Web UI 端口
# 访问http://localhost:${GRAFANA_PORT}
GRAFANA_PORT=3000 GRAFANA_PORT=3000
# Alertmanager 端口 # Alertmanager Web UI 端口
ALERTMANAGER_PORT=9093 ALERTMANAGER_PORT=9093
# VictoriaMetrics 端口(边缘节点推送数据到此端口) # VictoriaMetrics 端口(边缘 vmagent 通过 remote_write 推送到此端口)
# 必须与边缘侧 CENTRAL_VM_URL 中的端口一致;通常不通过 Traefik边缘直连
VICTORIAMETRICS_PORT=8428 VICTORIAMETRICS_PORT=8428
# ============================================ # ============================================
# Grafana 配置 # Grafana 配置
# ============================================ # ============================================
# Grafana 管理员密码 # Grafana 管理员密码(生产环境必须修改,建议 12 位以上强密码)
GRAFANA_ADMIN_PASSWORD=admin123 GRAFANA_ADMIN_PASSWORD=admin123
# Grafana 默认语言 # Grafana 默认语言zh-Hans 简体中文en 英文
GRAFANA_DEFAULT_LANGUAGE=zh-Hans GRAFANA_DEFAULT_LANGUAGE=zh-Hans
# Grafana 默认主题 # Grafana 默认主题light 浅色dark 深色
GRAFANA_DEFAULT_THEME=light GRAFANA_DEFAULT_THEME=light
# Grafana 根 URL用于 Traefik 反向代理,如果使用 Traefik设置为 https://grafana.example.com # Grafana 根 URL使用 Traefik 时设为对外访问地址,如 https://grafana.example.com
# 影响登录跳转、OAuth 回调等
GRAFANA_ROOT_URL=http://localhost:3000 GRAFANA_ROOT_URL=http://localhost:3000
# ============================================ # ============================================
# Prometheus 配置 # Prometheus 配置
# ============================================ # ============================================
# 部分变量会代入 prometheus.yml.template 生成 prometheus.yml
# Prometheus 数据保留时间 # Prometheus 本地 TSDB 数据保留时间(如 30d、7d、1y
PROMETHEUS_RETENTION_TIME=30d PROMETHEUS_RETENTION_TIME=30d
# Prometheus 抓取间隔(秒) # 抓取间隔(秒),影响中央 Prometheus 抓取本机服务的频率
# 建议 1560越小越实时负载越高
PROMETHEUS_SCRAPE_INTERVAL=15 PROMETHEUS_SCRAPE_INTERVAL=15
# Prometheus 告警评估间隔(秒) # 告警规则评估间隔(秒)
PROMETHEUS_EVALUATION_INTERVAL=15 PROMETHEUS_EVALUATION_INTERVAL=15
# Prometheus 集群标识 # 集群标识,作为 external_labels 中的 cluster 标签,用于区分多集群
PROMETHEUS_CLUSTER_NAME=central-monitoring PROMETHEUS_CLUSTER_NAME=central-monitoring
# 远程写入队列配置 # remote_write 到 VictoriaMetrics 的队列参数(中央 Prometheus 将抓取数据推送到 VM
# 边缘写入量大时可适当调大;一般保持默认即可
PROMETHEUS_REMOTE_WRITE_MAX_SAMPLES=10000 PROMETHEUS_REMOTE_WRITE_MAX_SAMPLES=10000
PROMETHEUS_REMOTE_WRITE_CAPACITY=20000 PROMETHEUS_REMOTE_WRITE_CAPACITY=20000
PROMETHEUS_REMOTE_WRITE_MAX_SHARDS=10 PROMETHEUS_REMOTE_WRITE_MAX_SHARDS=10
@@ -57,81 +87,83 @@ PROMETHEUS_REMOTE_WRITE_MAX_SHARDS=10
# ============================================ # ============================================
# VictoriaMetrics 配置 # VictoriaMetrics 配置
# ============================================ # ============================================
# VM 接收边缘 remote_write 并存储Grafana 数据源通常指向 VM
# VictoriaMetrics 数据保留时间 # VM 数据保留时间(如 30d、90d
VICTORIAMETRICS_RETENTION_PERIOD=30d VICTORIAMETRICS_RETENTION_PERIOD=30d
# ============================================ # ============================================
# 数据存储路径 # 数据存储路径
# ============================================ # ============================================
# 相对于 central-server 目录deploy.sh 会转换为绝对路径供 Docker 使用
# 数据存储根目录(所有数据存储在此目录下,相对于 central-server 目录 # 数据存储根目录(可选,部分脚本可能引用
# 使用相对路径,数据将存储在 central-server 目录下的 data 子目录中
DATA_STORAGE_ROOT=./data DATA_STORAGE_ROOT=./data
# Prometheus 数据目录 # Prometheus 本地 TSDB 数据目录
PROMETHEUS_DATA_DIR=./data/prometheus-data PROMETHEUS_DATA_DIR=./data/prometheus-data
# Grafana 数据目录 # Grafana 数据库与插件数据目录
GRAFANA_DATA_DIR=./data/grafana-data GRAFANA_DATA_DIR=./data/grafana-data
# VictoriaMetrics 数据目录 # VictoriaMetrics 时序数据目录
VICTORIAMETRICS_DATA_DIR=./data/victoria-metrics-data VICTORIAMETRICS_DATA_DIR=./data/victoria-metrics-data
# 天地图瓦片缓存(密钥与缓存参数均在 .env 中配置 # 天地图瓦片缓存(供 topology-editor、Grafana Geomap 使用
# 在 .env 中设置 TIANDITU_TK 后tile-cache 与拓扑助手「使用服务器缓存」、Grafana Geomap 方可使用天地图 # 在 .env 中设置 TIANDITU_TK 后tile-cache 才可正常工作
# TIANDITU_TK=您的天地图密钥 # TIANDITU_TK=您的天地图密钥
# TILE_CACHE_PORT=4090 # TILE_CACHE_PORT=4090
# TILE_CACHE_DATA_DIR=./data/tile-cache # TILE_CACHE_DATA_DIR=./data/tile-cache
# 缓存老化时间(天),超过后该瓦片下次请求时会重新向天地图拉取;默认 7可改为 15 等
# TILE_CACHE_TTL_DAYS=7 # TILE_CACHE_TTL_DAYS=7
# 向天地图请求单瓦片超时(毫秒),默认 15000网络或上游慢时可适当调大
# TILE_CACHE_UPSTREAM_TIMEOUT_MS=15000 # TILE_CACHE_UPSTREAM_TIMEOUT_MS=15000
# ============================================ # ============================================
# Traefik 反向代理配置 # Traefik 反向代理配置
# ============================================ # ============================================
# 启用后docker-compose 会为各服务添加 Traefik 标签,通过域名访问
# 是否启用 Traefik 反向代理true/false # 是否启用 Traefiktrue/false。为 false 时通过宿主机端口直接访问
# 如果启用,服务将通过 Traefik 访问,不再直接暴露端口
TRAEFIK_ENABLED=true TRAEFIK_ENABLED=true
# Traefik 网络名称(通常为 traefik # Traefik 来源internal=本编排启动 Traefik包含 traefik 服务external=使用已有外部 Traefik
# internal本 compose 内启动 Traefik自动创建网络无需外部 Traefik
# external接入已有 Traefik需 traefik 网络已存在(如单独部署的 Traefik
TRAEFIK_PROVIDER=external
# Traefik 所在 Docker 网络名称
# external 时通常为 traefikinternal 时为 central_defaultcompose 自动创建)
TRAEFIK_NETWORK=traefik TRAEFIK_NETWORK=traefik
# 域名配置(需要配置 DNS 解析到 Traefik 服务器) # 域名(需 DNS 解析到 Traefik 所在机器)
# Grafana 域名
GRAFANA_DOMAIN=grafana.example.com GRAFANA_DOMAIN=grafana.example.com
# Prometheus 域名
PROMETHEUS_DOMAIN=prometheus.example.com PROMETHEUS_DOMAIN=prometheus.example.com
# Alertmanager 域名
ALERTMANAGER_DOMAIN=alertmanager.example.com ALERTMANAGER_DOMAIN=alertmanager.example.com
# VictoriaMetrics 域名(通常不需要通过 Traefik 访问,边缘节点直接连接)
VICTORIAMETRICS_DOMAIN=vm.example.com VICTORIAMETRICS_DOMAIN=vm.example.com
# Traefik EntryPoint通常为 web 或 websecure # Traefik EntryPointweb=80, websecure=443
TRAEFIK_ENTRYPOINT=web TRAEFIK_ENTRYPOINT=web
# 是否启用 HTTPS要配置 Traefik TLS # 是否启用 HTTPS需 Traefik 配置 TLS
TRAEFIK_HTTPS_ENABLED=false TRAEFIK_HTTPS_ENABLED=false
# TRAEFIK_PROVIDER=internal 时Traefik 监听的宿主机端口
# TRAEFIK_HTTP_PORT=80
# TRAEFIK_HTTPS_PORT=443
# ============================================ # ============================================
# Docker 网络配置 # Docker 网络配置
# ============================================ # ============================================
# 由 TRAEFIK_PROVIDER 决定一般无需手动改deploy.sh 会自动设置
# Compose 项目名称用于区分同一目录下的多套部署,避免与旧状态冲突) # Compose 项目名称用于区分同一目录多套部署
COMPOSE_PROJECT_NAME=central COMPOSE_PROJECT_NAME=central
# 使用已存在的 traefik 网络(由 Traefik 创建,不在此项目中创建) # TRAEFIK_PROVIDER=external 时:
# 保持以下两项即可接入现有 Traefik
NETWORK_NAME=traefik NETWORK_NAME=traefik
EXTERNAL_NETWORK=true EXTERNAL_NETWORK=true
# 仅在不使用 Traefik、仅本地直连时改为: # TRAEFIK_PROVIDER=internal 时deploy.sh 会自动改为
# NETWORK_NAME=central-server_default # NETWORK_NAME=central_default
# EXTERNAL_NETWORK=false # EXTERNAL_NETWORK=false
# 是否启用 IPv6true/false # 是否启用 IPv6true/false

View File

@@ -6,7 +6,7 @@
## 告警规则alert_rules.yml ## 告警规则alert_rules.yml
中央已内置 `central-server/alert_rules.yml`,主要包含: 中央已内置 `central-server/config/prometheus/alert_rules.yml`,主要包含:
| 规则 | 条件 | 说明 | | 规则 | 条件 | 说明 |
|------|------|------| |------|------|------|
@@ -16,13 +16,13 @@
**为何显示 Inactive**:规则依赖边缘推送的指标。需先部署边缘、配置 Ping/ONVIF 目标,数据经 remote_write 到 VictoriaMetrics 后,规则才会评估;无数据时保持 inactive。 **为何显示 Inactive**:规则依赖边缘推送的指标。需先部署边缘、配置 Ping/ONVIF 目标,数据经 remote_write 到 VictoriaMetrics 后,规则才会评估;无数据时保持 inactive。
**激活步骤**:完成 [README.md#第二步](README.md) 边缘部署 → 在 Grafana 选 VictoriaMetrics 数据源确认有 `probe_success{job="network-ping"}` 等 → Prometheus 会从 VictoriaMetrics 取数并评估规则。 **激活步骤**:完成边缘部署(见 [README](README.md)、[DEPLOYMENT_GUIDE](DEPLOYMENT_GUIDE.md)→ 在 Grafana 选 VictoriaMetrics 数据源确认有 `probe_success{job="network-ping"}` 等 → Prometheus 会从 VictoriaMetrics 取数并评估规则。
--- ---
## Alertmanager 配置alertmanager.yml ## Alertmanager 配置alertmanager.yml
路径:`central-server/alertmanager/alertmanager.yml` 路径:`central-server/config/alertmanager/alertmanager.yml`
- **route**分组group_by、等待时间group_wait、重复间隔repeat_interval、默认接收器receiver - **route**分组group_by、等待时间group_wait、重复间隔repeat_interval、默认接收器receiver
- **receivers**:当前示例为 webhook `http://127.0.0.1:5001/` - **receivers**:当前示例为 webhook `http://127.0.0.1:5001/`
@@ -37,7 +37,7 @@
## 自定义告警规则 ## 自定义告警规则
`alert_rules.yml` 中追加或修改规则,例如: `config/prometheus/alert_rules.yml` 中追加或修改规则,例如:
```yaml ```yaml
- alert: ExampleAlert - alert: ExampleAlert

View File

@@ -3,78 +3,22 @@
## 容器关系图 ## 容器关系图
``` ```
┌─────────────────────────────────────────────────────────────────┐ ┌─ 边缘节点 (Edge Node 1/2/…/N) ─────────────────┐
边缘节点 (Edge Agents) vmagent | ONVIF Exporter | Blackbox Exporter
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ ──────────────────────────────────────────────┘
│ Edge Node 1 │ Edge Node 2 │ Edge Node N │ │ │ remote_write (HTTP POST)
│ │ │ │ │ │ │ │
│ │ Prometheus │ │ Prometheus │ │ Prometheus │ │
│ │ Edge │ │ Edge │ │ Edge │ │
│ │ │ │ │ │ │ │
│ │ ONVIF │ │ ONVIF │ │ ONVIF │ │
│ │ Exporter │ │ Exporter │ │ Exporter │ │
│ │ │ │ │ │ │ │
│ │ Blackbox │ │ Blackbox │ │ Blackbox │ │
│ │ Exporter │ │ Exporter │ │ Exporter │ │
│ └──────┬───────┘ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │ │
│ └──────────────────┼──────────────────┘ │
│ │ │
│ remote_write │
│ (HTTP POST) │
└────────────────────────────┼────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────────┐ ┌─ 中央服务器 ───────────────────────────────────┐
中央服务器 (Central Server) VictoriaMetrics (8428) 接收边缘推送、存储
│ │
│ ┌──────────────────────────────────────────────────────────┐ │
│ │ VictoriaMetrics (8428) │ │
│ │ ┌────────────────────────────────────────────────────┐ │ │
│ │ │ 远程写入接收器 │ │ │
│ │ │ - 接收边缘节点推送的指标数据 │ │ │
│ │ │ - 存储时序数据 │ │ │
│ │ │ - 提供查询接口 │ │ │
│ │ └────────────────────────────────────────────────────┘ │ │
│ └────────────────────┬───────────────────────────────────────┘ │
│ │ │
│ │ 数据查询 │ │ │ 数据查询 │
┌────────────────────▼───────────────────────────────────────┐ Prometheus (9091) 抓取本地、告警评估
│ Prometheus Central (9091) ├── 告警 ──> Alertmanager (9093) │
┌────────────────────────────────────────────────────┐ └── 查询 ──> Grafana (3000)
│ │ │ 指标收集和查询引擎 │ │ │ └──────────────────┬─────────────────────────────┘
│ │ │ - 从 VictoriaMetrics 读取数据 │ │ │
│ │ │ - 抓取本地服务指标 (自身、Grafana、Alertmanager) │ │ │
│ │ │ - 评估告警规则 │ │ │
│ │ │ - 提供 PromQL 查询接口 │ │ │
│ │ └────────────────────────────────────────────────────┘ │ │
│ └────────────┬───────────────────────────┬───────────────────┘ │
│ │ │ │
│ │ 告警触发 │ 数据查询 │
│ │ │ │
│ ┌────────────▼──────────┐ ┌─────────────▼──────────────┐ │
│ │ Alertmanager (9093) │ │ Grafana (3000) │ │
│ │ ┌──────────────────┐ │ │ ┌──────────────────────┐ │ │
│ │ │ 告警管理 │ │ │ │ 可视化仪表板 │ │ │
│ │ │ - 接收告警 │ │ │ │ - 从 Prometheus 查询 │ │ │
│ │ │ - 告警分组 │ │ │ │ - 创建图表和仪表板 │ │ │
│ │ │ - 发送通知 │ │ │ │ - 多用户管理 │ │ │
│ │ │ - 告警抑制 │ │ │ │ - 中文界面 │ │ │
│ │ └──────────────────┘ │ │ └──────────────────────┘ │ │
│ └───────────────────────┘ │ └──────────────────────────┘ │
│ │ │
└──────────────────────────────┼──────────────────────────────────┘
│ HTTP 访问 │ HTTP 访问
┌───────────────┼───────────────┐ 管理员 / 用户组A / 用户组B
│ │ │
▼ ▼ ▼
┌─────────────┐ ┌─────────────┐ ┌─────────────┐
│ 管理员 │ │ 用户组A │ │ 用户组B │
│ (Admin) │ │ (Org A) │ │ (Org B) │
└─────────────┘ └─────────────┘ └─────────────┘
``` ```
## 数据流向 ## 数据流向
@@ -173,19 +117,11 @@ Alertmanager 处理告警
## 网络关系 ## 网络关系
``` ```
monitoring_net (Docker Bridge Network) monitoring_net (Docker Bridge)
├─ prometheus-central:9090 -> 宿主机 9091
├─ prometheus-central:9090 (内部) ├─ grafana:3000 -> 宿主机 3000
│ └─> 映射到宿主机:9091 ├─ alertmanager:9093 -> 宿主机 9093
└─ victoria-metrics:8428 -> 宿主机 8428
├─ grafana:3000 (内部)
│ └─> 映射到宿主机:3000
├─ alertmanager:9093 (内部)
│ └─> 映射到宿主机:9093
└─ victoria-metrics:8428 (内部)
└─> 映射到宿主机:8428
``` ```
## 端口映射 ## 端口映射
@@ -199,25 +135,19 @@ monitoring_net (Docker Bridge Network)
## 数据存储 ## 数据存储
所有数据存储在 `/storage` 分区:
``` ```
/storage/ central-server/data/
├── prometheus-data/ # Prometheus 时序数据 ├── prometheus-data/ # Prometheus 时序数据
├── grafana-data/ # Grafana 配置仪表板 ├── grafana-data/ # Grafana 配置仪表板
── victoria-metrics-data/ # VictoriaMetrics 时序数据 ── victoria-metrics-data/ # VictoriaMetrics 时序数据
└── docker/ # Docker 数据
``` ```
## 依赖关系 ## 依赖关系
``` ```
VictoriaMetrics VictoriaMetrics <── Prometheus
↑ (数据查询) ├─ 告警 ──> Alertmanager
└─ 查询 ──> Grafana
Prometheus
├─> (告警触发) ──> Alertmanager
└─> (数据查询) ──> Grafana
``` ```
**启动顺序** **启动顺序**

View File

@@ -164,11 +164,8 @@ firewall-cmd --reload
```bash ```bash
# 备份所有配置文件 # 备份所有配置文件
tar -czf config-backup-$(date +%Y%m%d).tar.gz \ tar -czf config-backup-$(date +%Y%m%d).tar.gz \
central-server/*.yml \ central-server/config/ \
central-server/alertmanager/*.yml \ edge-agent/config/
central-server/grafana/provisioning/ \
edge-agent/*.yml \
edge-agent/prometheus-edge/*.yml
``` ```
#### 数据备份 #### 数据备份

View File

@@ -6,13 +6,14 @@
central-server/ central-server/
├── docker-compose.yml # 服务编排 ├── docker-compose.yml # 服务编排
├── deploy.sh # 部署脚本 ├── deploy.sh # 部署脚本
├── prometheus.yml # Prometheus 主配置 ├── config/ # 配置目录
├── alert_rules.yml # 告警规则 │ ├── prometheus/ # Prometheus 配置prometheus.yml、alert_rules.yml
├── alertmanager/alertmanager.yml ├── alertmanager/ # Alertmanager 配置
└── grafana/ └── grafana/ # Grafana 配置provisioning、dashboards
├── setup-users.sh ├── apps/ # 自建应用源码
├── provisioning/datasources/ # prometheus.yml, victoriametrics.yml ├── tile-cache/ # 天地图瓦片缓存
└── dashboards/ └── topology-editor/ # GPS 标注助手
└── data/ # 运行时数据gitignore
``` ```
## 主要服务与端口 ## 主要服务与端口
@@ -26,16 +27,16 @@ central-server/
## 关键配置摘要 ## 关键配置摘要
- **prometheus.yml**`remote_write` 指向 VictoriaMetrics`rule_files: alert_rules.yml`抓取自身、VM、Alertmanager、Grafana。 - **config/prometheus/prometheus.yml**`remote_write` 指向 VictoriaMetrics`rule_files: alert_rules.yml`抓取自身、VM、Alertmanager、Grafana。
- **告警规则与通知**:见 [ALERTING.md](ALERTING.md)。 - **告警规则与通知**:见 [ALERTING.md](ALERTING.md)。
- **Grafana 数据源**Provisioning 下配置 Prometheus、VictoriaMetrics查边缘指标请选 **VictoriaMetrics** - **Grafana 数据源**Provisioning 下配置 Prometheus、VictoriaMetrics查边缘指标请选 **VictoriaMetrics**
- **Grafana Geomap 使用天地图缓存**:在 Geomap 面板中将 Base layer 选为 **XYZ Tile layer**,底图 URL 填 `http://<central>:4090/tiles/vec/{z}/{x}/{y}`,再添加一层 XYZ 填 `http://<central>:4090/tiles/cva/{z}/{x}/{y}`中文注记。key 仅需在 central 配置 `TIANDITU_TK`,无需在 Grafana 中填写。详见 [TIANDITU_CONFIG.md](TIANDITU_CONFIG.md)。 - **Grafana Geomap 使用天地图缓存**:在 Geomap 面板中将 Base layer 选为 **XYZ Tile layer**,底图 URL 填 `http://<central>:4090/tiles/vec/{z}/{x}/{y}`,再添加一层 XYZ 填 `http://<central>:4090/tiles/cva/{z}/{x}/{y}`中文注记。key 仅需在 central 配置 `TIANDITU_TK`,无需在 Grafana 中填写。详见 [TIANDITU_CONFIG.md](TIANDITU_CONFIG.md)。
- **多用户**`grafana/setup-users.sh`,见 [USER_MANAGEMENT.md](USER_MANAGEMENT.md)。 - **多用户**`config/grafana/setup-users.sh`,见 [USER_MANAGEMENT.md](USER_MANAGEMENT.md)。
## 修改与重载 ## 修改与重载
- Prometheus`prometheus.yml``alert_rules.yml``docker compose restart prometheus-central`,或 `curl -X POST http://localhost:9091/-/reload`(若启用 lifecycle - Prometheus`config/prometheus/prometheus.yml``config/prometheus/alert_rules.yml``docker compose restart prometheus-central`,或 `curl -X POST http://localhost:9091/-/reload`(若启用 lifecycle
- Alertmanager`alertmanager/alertmanager.yml``docker compose restart alertmanager` - Alertmanager`config/alertmanager/alertmanager.yml``docker compose restart alertmanager`
- Grafana改 provisioning 后重启;或通过 Web UI 修改(持久化到库)。 - Grafana改 provisioning 后重启;或通过 Web UI 修改(持久化到库)。
## 相关文档 ## 相关文档

View File

@@ -1,21 +1,23 @@
# 部署指南 # 部署指南
部署顺序**[doc/README.md](README.md)#部署顺序**:中央 → 边缘 → 多用户/告警(可选)。本文为各步操作与验证要点 部署顺序:中央 → 边缘 → 多用户/告警(可选)。详见 [README](README.md)。
--- ---
## 第一步:部署中央服务器 ## 第一步:部署中央服务器
**前置**Docker、Docker Compose端口 3000、9091、8428、9093、4090 未被占用;磁盘充足。 **前置**Docker、Docker Compose端口 3000、9091、8428、9093 未被占用;磁盘充足。
```bash ```bash
cd central-server cd central-server
cp env.example .env # 可选 cp env.example .env # 可选按需改端口、Traefik 等
bash deploy.sh bash deploy.sh
``` ```
**验证**Grafana http://localhost:3000admin/admin123、Prometheus http://localhost:9091、VictoriaMetrics http://localhost:8428。 **验证**Grafana http://localhost:3000admin/admin123、Prometheus http://localhost:9091、VictoriaMetrics http://localhost:8428。
**详细**[CENTRAL_SERVER_CONFIG](CENTRAL_SERVER_CONFIG.md)、[central-server/CONFIGURATION.md](../central-server/CONFIGURATION.md)。
--- ---
## 第二步:部署边缘节点 ## 第二步:部署边缘节点
@@ -23,29 +25,31 @@ bash deploy.sh
**前提**中央已运行VictoriaMetrics 8428 可访问。 **前提**中央已运行VictoriaMetrics 8428 可访问。
- **本机同机**`cd edge-agent && bash deploy.sh --local`(中央地址设为 host.docker.internal:8428 - **本机同机**`cd edge-agent && bash deploy.sh --local`(中央地址设为 host.docker.internal:8428
- **边缘在另一台机器** - **边缘跨机**`cd edge-agent` → 编辑 `.env``CENTRAL_SERVER_HOST=中央IP``bash deploy.sh`
- 在 edge-agent 下 `cp env.example .env`,编辑 `CENTRAL_SERVER_HOST``CENTRAL_SERVER_PORT=8428`
- `bash deploy.sh`(会自动调用 update-configs
**验证**:边缘 Prometheus http://localhost:9092(或边缘机 IP:9092;中央 Grafana 选数据源 **VictoriaMetrics**,查询 `probe_success{job="network-ping"}` 可见边缘数据。 **验证**:边缘 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。 - 看不到边缘数据:确认 `.env` 中为中央 IP跨机不能用 host.docker.internal`curl -s -o /dev/null -w "%{http_code}" http://<中央IP>:8428/health` 应为 200。
- 端口冲突:边缘 Prometheus 已映射 9092避免与中央 9091 冲突 - 端口冲突:边缘已映射 9092与中央 9091 区分
**详细**[EDGE_AGENT_CONFIG](EDGE_AGENT_CONFIG.md)、[TARGETS_AND_MONITORING](TARGETS_AND_MONITORING.md)。
--- ---
## 第三步(可选):多用户与告警 ## 第三步(可选):多用户与告警
- **Grafana 多用户**`cd central-server/grafana && bash setup-users.sh`见 [USER_MANAGEMENT.md](USER_MANAGEMENT.md)。 - **Grafana 多用户**`cd central-server/config/grafana && bash setup-users.sh`,见 [USER_MANAGEMENT](USER_MANAGEMENT.md)。
- **告警**:规则见 [ALERTING.md](ALERTING.md);通知渠道编辑 `central-server/alertmanager/alertmanager.yml` - **告警**:规则见 [ALERTING](ALERTING.md);通知渠道编辑 `central-server/config/alertmanager/alertmanager.yml`
--- ---
## 部署后检查清单 ## 部署后检查清单
- **中央**`docker compose ps` 中相关服务 UpGrafana Prometheus 数据源可查 `up` - **中央**`docker compose ps` 中相关服务 UpGrafana Prometheus 数据源可查 `up`
- **边缘**prometheus-edge、blackbox-exporter UpGrafana 选 VictoriaMetrics 可查 `probe_success{job="network-ping"}` 等。 - **边缘**prometheus-edge、blackbox-exporter UpGrafana 选 VictoriaMetrics 可查 `probe_success{job="network-ping"}`
- **磁盘/端口**端口冲突用 `ss -tulpn` 查;空间不足时清理或扩容数据目录 - **磁盘/端口**`ss -tulpn`端口;空间不足时清理或扩容。
详见 [TROUBLESHOOTING.md](TROUBLESHOOTING.md)、[README.md](README.md) 详见 [TROUBLESHOOTING](TROUBLESHOOTING.md)。

View File

@@ -26,25 +26,27 @@
- **config/targets.csv**统一监控目标ping/onvif/topology格式与脚本见 [TARGETS_AND_MONITORING.md](TARGETS_AND_MONITORING.md)。 - **config/targets.csv**统一监控目标ping/onvif/topology格式与脚本见 [TARGETS_AND_MONITORING.md](TARGETS_AND_MONITORING.md)。
- **config/update-configs.sh**:从 targets.csv 生成 `target-onvif.json``target-ping.json``target-topology.geojson` - **config/update-configs.sh**:从 targets.csv 生成 `target-onvif.json``target-ping.json``target-topology.geojson`
- **prometheus-edge (vmagent)**:使用 `vmagent-scrape.yml.template` 抓取;`CENTRAL_SERVER_HOST`/`PORT` 来自 `.env`;磁盘缓存卷 `vmagent-cache-data` - **prometheus-edge (vmagent)**:使用 `config/vmagent/vmagent-scrape.yml.template` 抓取;`CENTRAL_SERVER_HOST`/`PORT` 来自 `.env`;磁盘缓存卷 `vmagent-cache-data`
- **.env**`CENTRAL_SERVER_HOST``CENTRAL_SERVER_PORT=8428``EDGE_NODE_ID`。本机同机用 `./deploy.sh --local`;跨机配 `.env``./deploy.sh` - **.env**`CENTRAL_SERVER_HOST``CENTRAL_SERVER_PORT=8428``EDGE_NODE_ID`。本机同机用 `./deploy.sh --local`;跨机配 `.env``./deploy.sh`
## 常用操作 ## 常用操作
- 改监控目标:编辑 `config/targets.csv``cd config && ./update-configs.sh`,必要时重启 prometheus-edge - 改监控目标:编辑 `config/targets.csv``cd config && ./update-configs.sh`vmagent 每 5 分钟自动重载 JSON无需重启
- 改中央地址:编辑 `.env``docker compose restart prometheus-edge` - 改中央地址:编辑 `.env``docker compose restart prometheus-edge`
## 中心宕机 / 断网时的缓存 ## 中心宕机 / 断网时的缓存
`docker-compose.yaml` 使用 vmagent 统一实现: `docker-compose.yaml` 使用 vmagent 实现:
- **短时内存缓存**:中心短暂不可达时在内存中缓冲 | 层级 | 机制 | 说明 |
- **长时磁盘缓存**:长时间离线时写入磁盘队列(默认 512MB恢复后自动补传 |------|------|------|
- **冗余重试**:失败自动重试,边缘重启后从磁盘恢复未上传数据 | **短时内存缓存** | 内存队列 | 中心短暂不可达时在内存中缓冲(约 30 分钟量级) |
| **长时磁盘缓存** | 持久化队列 | 长时间离线写入磁盘(默认 512MB恢复后自动补传 |
| **冗余重试** | 失败重试 | 边缘重启后从磁盘恢复未上传数据 |
详见 [EDGE_CACHE.md](EDGE_CACHE.md) **参数**(修改 prometheus-edge 的 `command` 可调):`-remoteWrite.maxDiskUsagePerURL=512MB``-remoteWrite.tmpDataPath=/cache/remotewrite``-memory.allowedPercent=80`。监控指标:`vmagent_remotewrite_pending_bytes``vmagent_remotewrite_packets_dropped_total`
## 相关文档 ## 相关文档
- [EDGE_CACHE.md](EDGE_CACHE.md) | [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) | [TARGETS_AND_MONITORING.md](TARGETS_AND_MONITORING.md) | [ONVIF_ALTERNATIVES.md](ONVIF_ALTERNATIVES.md) | [ARCHITECTURE.md](ARCHITECTURE.md) - [DEPLOYMENT_GUIDE](DEPLOYMENT_GUIDE.md) | [TARGETS_AND_MONITORING](TARGETS_AND_MONITORING.md) | [ONVIF_ALTERNATIVES](ONVIF_ALTERNATIVES.md) | [ARCHITECTURE](ARCHITECTURE.md)

View File

@@ -1,34 +0,0 @@
# 边缘节点缓存
## 架构
`docker-compose.yaml` 使用 **vmagent** 统一实现:
| 层级 | 机制 | 说明 |
|------|------|------|
| **短时内存缓存** | 内存队列 | 中心短暂不可达时在内存中缓冲(~30 分钟量级) |
| **长时磁盘缓存** | 持久化队列 | 长时间离线时写入磁盘(默认 512MB恢复后自动补传 |
| **冗余重试** | 失败重试 | 自动重试,边缘重启后从磁盘恢复未上传数据 |
## 部署
```bash
cd edge-agent
bash deploy.sh
# 本机同机: bash deploy.sh --local
```
## 配置
| 参数 | 默认值 | 说明 |
|------|--------|------|
| `-remoteWrite.maxDiskUsagePerURL` | 512MB | 每 URL 最大磁盘缓存 |
| `-remoteWrite.tmpDataPath` | /cache/remotewrite | 磁盘队列路径 |
| `-memory.allowedPercent` | 80 | 内存队列可用比例 |
修改 `docker-compose.yaml``prometheus-edge``command` 可调整上述参数。
## 监控
- `vmagent_remotewrite_pending_bytes`:待发送字节数
- `vmagent_remotewrite_packets_dropped_total`:丢包数

View File

@@ -11,7 +11,7 @@
| **SNMP Exporter** | 摄像头/设备支持 SNMP | 用官方 `prom/snmp_exporter`,按设备 MIB 配置 OID无 ONVIF 协议 | | **SNMP Exporter** | 摄像头/设备支持 SNMP | 用官方 `prom/snmp_exporter`,按设备 MIB 配置 OID无 ONVIF 协议 |
| **Frigate** | 已用或可部署 Frigate NVR | Frigate 暴露 `/api/metrics`Prometheus 直接抓取或通过 frigate-exporter | | **Frigate** | 已用或可部署 Frigate NVR | Frigate 暴露 `/api/metrics`Prometheus 直接抓取或通过 frigate-exporter |
| **UniFi Protect Exporter** | UniFi 摄像头/Protect | 使用专有 exporter非 ONVIF 通用方案 | | **UniFi Protect Exporter** | UniFi 摄像头/Protect | 使用专有 exporter非 ONVIF 通用方案 |
| **ONVIF 自建** | 必须用 ONVIF 协议 | **本项目已提供**:见 **edge-agent/onvif-exporter/**Go + use-go/onvif读取 `onvif-targets.json`GetDeviceInformation 探测,暴露 `onvif_device_up``onvif_probe_duration_seconds``docker compose --profile onvif up -d --build` 即可。 | | **ONVIF 自建** | 必须用 ONVIF 协议 | **本项目已提供**:见 **edge-agent/apps/onvif-exporter/**Go + use-go/onvif读取 `target-onvif.json`GetDeviceInformation 探测,暴露 `onvif_device_up``onvif_probe_duration_seconds``docker compose --profile onvif up -d --build` 即可。 |
| **仅 Ping/HTTP 探测** | 只关心在线与可达性 | 用 Blackbox Exporter 对摄像头 IP 做 ICMP/HTTP 探测,不解析 ONVIF | | **仅 Ping/HTTP 探测** | 只关心在线与可达性 | 用 Blackbox Exporter 对摄像头 IP 做 ICMP/HTTP 探测,不解析 ONVIF |
--- ---
@@ -63,19 +63,19 @@
## 4. ONVIF 自建 Exporter必须走 ONVIF 时) ## 4. ONVIF 自建 Exporter必须走 ONVIF 时)
**本项目已在 edge-agent/onvif-exporter/ 提供自建容器**,无需再找第三方镜像。 **本项目已在 edge-agent/apps/onvif-exporter/ 提供自建容器**,无需再找第三方镜像。
- **实现**Go + [use-go/onvif](https://github.com/use-go/onvif),读取 `config/target-onvif.json`(与 `targets.csv` 中 onvif 行一致),轮询 ONVIF `GetDeviceInformation`,暴露 Prometheus 指标 `onvif_device_up`、`onvif_probe_duration_seconds`。 - **实现**Go + [use-go/onvif](https://github.com/use-go/onvif),读取 `config/target-onvif.json`(与 `targets.csv` 中 onvif 行一致),轮询 ONVIF `GetDeviceInformation`,暴露 Prometheus 指标 `onvif_device_up`、`onvif_probe_duration_seconds`。
- **启用**:在边缘节点执行 `docker compose --profile onvif up -d --build`,会构建并启动 ONVIF exporter无需设置 `ONVIF_EXPORTER_IMAGE`。 - **启用**:在边缘节点执行 `docker compose --profile onvif up -d --build`,会构建并启动 ONVIF exporter无需设置 `ONVIF_EXPORTER_IMAGE`。
- **配置**:在 `config/targets.csv` 中增加 onvif 行ip、device_type、model、location、username、password、onvif_port运行 `config/update-configs.sh` 生成 `target-onvif.json`。 - **配置**:在 `config/targets.csv` 中增加 onvif 行ip、device_type、model、location、username、password、onvif_port运行 `config/update-configs.sh` 生成 `target-onvif.json`。
- 若需自行修改或扩展,见 **edge-agent/onvif-exporter/README.md**。 - 若需自行修改或扩展,见 **edge-agent/apps/onvif-exporter/README.md**。
--- ---
## 在本项目中的建议 ## 在本项目中的建议
- **边缘默认部署**:不依赖不存在的 ONVIF 镜像;默认只跑 **prometheus-edge** + **blackbox-exporter**Ping/探测),可选用 **snmp-exporter** 或 Frigate 抓取。 - **边缘默认部署**:不依赖不存在的 ONVIF 镜像;默认只跑 **prometheus-edge** + **blackbox-exporter**Ping/探测),可选用 **snmp-exporter** 或 Frigate 抓取。
- **若需要 ONVIF**:使用本项目自建的 **edge-agent/onvif-exporter**,执行 `docker compose --profile onvif up -d --build` 即可构建并启动;无需再设 `ONVIF_EXPORTER_IMAGE`。 - **若需要 ONVIF**:使用本项目自建的 **edge-agent/apps/onvif-exporter**,执行 `docker compose --profile onvif up -d --build` 即可构建并启动;无需再设 `ONVIF_EXPORTER_IMAGE`。
- **摄像头支持 SNMP 时**:优先考虑 **SNMP Exporter** 作为“Prometheus 监控摄像头”的替代方案,再根据需要补充 Frigate 或 Blackbox。 - **摄像头支持 SNMP 时**:优先考虑 **SNMP Exporter** 作为“Prometheus 监控摄像头”的替代方案,再根据需要补充 Frigate 或 Blackbox。
具体边缘配置与 compose 变更见 **[EDGE_AGENT_CONFIG.md](EDGE_AGENT_CONFIG.md)** 及 `edge-agent/docker-compose.yaml`。 具体边缘配置与 compose 变更见 **[EDGE_AGENT_CONFIG.md](EDGE_AGENT_CONFIG.md)** 及 `edge-agent/docker-compose.yaml`。

View File

@@ -1,112 +1,63 @@
# Distributed-Prometheus 文档 # 文档索引
本目录为项目文档入口。**先按部署顺序做完第一步、第二步,再按需查阅其他文档。** 本目录为项目文档入口。**首次部署**按「部署顺序」先中央、后边缘;**修改配置**按需查阅对应文档。
--- ---
## 部署顺序(必读) ## 部署顺序
整体顺序:**先中央,后边缘**。边缘向中央主动上报数据,中央必须先就绪。 | 步骤 | 操作 | 验证 |
|------|------|------|
| **1. 中央** | `cd central-server && cp env.example .env && bash deploy.sh` | Grafana http://localhost:3000、Prometheus http://localhost:9091 |
| **2. 边缘** | `cd edge-agent && bash deploy.sh`(本机同机加 `--local` | 边缘 http://localhost:9092Grafana 选 VictoriaMetrics 可见 `probe_success{job="network-ping"}` |
| **3. 可选** | 多用户、告警通知 | [USER_MANAGEMENT](USER_MANAGEMENT.md)、[ALERTING](ALERTING.md) |
| 步骤 | 部署 / 操作对象 | 做什么 | 验证 | **边缘跨机**:编辑 `edge-agent/.env``CENTRAL_SERVER_HOST` 为中央 IP`bash deploy.sh`
|------|------------------|--------|------|
| **第一步** | 中央服务器 | 部署 Prometheus、Grafana、VictoriaMetrics、Alertmanager | Grafana http://localhost:3000、Prometheus http://localhost:9091 | **targets.csv**:部署时自动从 targets.csv 生成 target-onvif.json、target-ping.json修改 targets.csv 后需手动 `cd config && ./update-configs.sh`vmagent 每 5 分钟自动重载。
| **第二步** | 边缘节点(可选,可多台) | 配置中央地址与监控目标,部署边缘 Prometheus + Exporter | 边缘 UI http://localhost:9092Grafana 选 VictoriaMetrics 数据源可见边缘数据 |
| **第三步** | 多用户 / 告警(可选) | 配置 Grafana 组织与用户、Alertmanager 通知 | 按 [USER_MANAGEMENT.md](USER_MANAGEMENT.md)、[ALERTING.md](ALERTING.md) 验证 |
--- ---
### 第一步:部署中央服务器 ## 文档列表
**必须先做**。中央提供 VictoriaMetrics接收边缘数据、Prometheus、Grafana、Alertmanager。
```bash
cd central-server
cp env.example .env # 可选按需改端口、Traefik、网络等
bash deploy.sh
```
- **前置**:已安装 Docker、Docker Compose端口 3000、9091、8428、9093 未被占用。
- **验证**:访问 http://localhost:3000Grafanaadmin/admin123、http://localhost:9091Prometheus
- **详细**[DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md)、[CENTRAL_SERVER_CONFIG.md](CENTRAL_SERVER_CONFIG.md)、[central-server/CONFIGURATION.md](../central-server/CONFIGURATION.md)。
---
### 第二步:部署边缘节点
**在中央已运行后**进行。边缘将指标推送到中央 VictoriaMetrics端口 8428
边缘必选:**remote_write**prometheus-edge、**Blackbox** 容器可选ONVIF/SNMP 等容器(见 [EDGE_AGENT_CONFIG.md](EDGE_AGENT_CONFIG.md))。
- **本机同机**(中央与边缘在同一台机器):
```bash
cd edge-agent
bash deploy.sh --local
```
脚本会设置中央地址为 `host.docker.internal:8428` 并执行部署。
- **边缘在另一台机器**
```bash
cd edge-agent
cp env.example .env
# 编辑 .envCENTRAL_SERVER_HOST=中央服务器IPCENTRAL_SERVER_PORT=8428
cd config && ./update-configs.sh && cd .. # 从 targets.csv 生成 JSON
bash deploy.sh
```
- **验证**:边缘 Prometheus UI http://localhost:9092端口 9092 避免与中央 9091 冲突)。在中央 Grafana 中**选择数据源「VictoriaMetrics」**,查询如 `up{job="network-ping"}` 可见边缘数据中央自身指标在数据源「Prometheus」。
- **摄像头/ONVIF**:默认不拉取 ONVIF 镜像(公共镜像不存在)。监控摄像头可选:**SNMP Exporter**、**Frigate**、**Blackbox 探测** 或自建 ONVIF 镜像,见 **[ONVIF_ALTERNATIVES.md](ONVIF_ALTERNATIVES.md)**。
- **监控目标**:编辑 `edge-agent/config/targets.csv`Ping / ONVIF / 拓扑),详见 [TARGETS_AND_MONITORING.md](TARGETS_AND_MONITORING.md)。
- **详细**[EDGE_AGENT_CONFIG.md](EDGE_AGENT_CONFIG.md)、[DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md)。
---
### 第三步(可选):多用户与告警
- **Grafana 多用户**`cd central-server/grafana && bash setup-users.sh`,然后按 [USER_MANAGEMENT.md](USER_MANAGEMENT.md) 配置组织与数据源。
- **告警通知**:编辑 `central-server/alertmanager/alertmanager.yml` 配置接收端;告警规则与说明见 [ALERTING.md](ALERTING.md)。
---
## 文档列表(按用途)
### 架构与数据流 ### 架构与数据流
| 文档 | 说明 | | 文档 | 说明 |
|------|------| |------|------|
| [ARCHITECTURE.md](ARCHITECTURE.md) | 系统架构、容器关系、数据流向、端口与依赖 | | [ARCHITECTURE](ARCHITECTURE.md) | 容器关系、数据流向、端口与依赖 |
### 配置说明 ### 中央节点
| 文档 | 说明 | | 文档 | 说明 |
|------|------| |------|------|
| [CENTRAL_SERVER_CONFIG.md](CENTRAL_SERVER_CONFIG.md) | 中央服务器配置文件说明 | | [CENTRAL_SERVER_CONFIG](CENTRAL_SERVER_CONFIG.md) | 中央目录结构、服务端口、关键配置 |
| [../central-server/CONFIGURATION.md](../central-server/CONFIGURATION.md) | 中央服务器环境变量(.env说明 | | [../central-server/CONFIGURATION.md](../central-server/CONFIGURATION.md) | 中央环境变量(.env说明 |
| [EDGE_AGENT_CONFIG.md](EDGE_AGENT_CONFIG.md) | 边缘节点配置文件说明 |
| [TARGETS_AND_MONITORING.md](TARGETS_AND_MONITORING.md) | 监控目标与 targets.csv格式、脚本、数据流 |
| [TIANDITU_CONFIG.md](TIANDITU_CONFIG.md) | 天地图配置(底图 vec_w、标识图 cva_w、WMTS 地址) |
| [ONVIF_ALTERNATIVES.md](ONVIF_ALTERNATIVES.md) | **摄像头/ONVIF 监控替代方案**SNMP、Frigate、Blackbox、自建 |
### 用户与告警 ### 边缘节点
| 文档 | 说明 | | 文档 | 说明 |
|------|------| |------|------|
| [USER_MANAGEMENT.md](USER_MANAGEMENT.md) | Grafana 多用户、组织与数据隔离 | | [EDGE_AGENT_CONFIG](EDGE_AGENT_CONFIG.md) | 边缘目录结构、vmagent、blackbox、缓存机制 |
| [ALERTING.md](ALERTING.md) | 告警规则、Alertmanager 配置与通知渠道 | | [TARGETS_AND_MONITORING](TARGETS_AND_MONITORING.md) | targets.csv 格式、update-configs.sh、监控类型 |
### 部署与运维 ### 告警与多用户
| 文档 | 说明 | | 文档 | 说明 |
|------|------| |------|------|
| [DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) | 完整部署步骤、检查清单、验证与常见问题 | | [ALERTING](ALERTING.md) | 告警规则、Alertmanager 配置、通知渠道 |
| [TROUBLESHOOTING.md](TROUBLESHOOTING.md) | 故障排查 | | [USER_MANAGEMENT](USER_MANAGEMENT.md) | Grafana 多用户、组织与数据隔离 |
| [BEST_PRACTICES.md](BEST_PRACTICES.md) | 最佳实践与生产环境建议 |
--- ### 扩展功能
## 快速导航 | 文档 | 说明 |
|------|------|
| [ONVIF_ALTERNATIVES](ONVIF_ALTERNATIVES.md) | ONVIF 摄像头监控方案SNMP、Frigate、Blackbox、自建 |
| [TIANDITU_CONFIG](TIANDITU_CONFIG.md) | 天地图底图、Grafana Geomap、tile-cache |
- **第一次部署**:按上面「部署顺序」先做第一步,再做第二步。 ### 运维
- **只改中央配置**:看 [CENTRAL_SERVER_CONFIG.md](CENTRAL_SERVER_CONFIG.md)、[CONFIGURATION.md](../central-server/CONFIGURATION.md)。
- **只改边缘 / 监控目标**:看 [EDGE_AGENT_CONFIG.md](EDGE_AGENT_CONFIG.md)、[TARGETS_AND_MONITORING.md](TARGETS_AND_MONITORING.md)。 | 文档 | 说明 |
- **多用户 / 告警**:看 [USER_MANAGEMENT.md](USER_MANAGEMENT.md)、[ALERTING.md](ALERTING.md)。 |------|------|
- **出问题**:看 [TROUBLESHOOTING.md](TROUBLESHOOTING.md)、[DEPLOYMENT_GUIDE.md](DEPLOYMENT_GUIDE.md) | [DEPLOYMENT_GUIDE](DEPLOYMENT_GUIDE.md) | 完整部署步骤、检查清单、常见问题 |
| [TROUBLESHOOTING](TROUBLESHOOTING.md) | 故障排查 |
| [BEST_PRACTICES](BEST_PRACTICES.md) | 最佳实践与生产建议 |

View File

@@ -2,6 +2,8 @@
边缘监控目标统一由 `edge-agent/config/targets.csv` 配置,经 `update-configs.sh` 生成 `target-onvif.json``target-ping.json``target-topology.geojson` 边缘监控目标统一由 `edge-agent/config/targets.csv` 配置,经 `update-configs.sh` 生成 `target-onvif.json``target-ping.json``target-topology.geojson`
**更新流程**:部署时 deploy.sh 自动从 targets.csv 生成 target-*.json修改 targets.csv 后需手动执行 `cd edge-agent/config && ./update-configs.sh`vmagent 每 5 分钟自动重载 JSON无需重启。
--- ---
## targets.csv 格式 ## targets.csv 格式

View File

@@ -116,10 +116,10 @@ docker compose logs prometheus-edge
# 查询: probe_success{job="network-ping"} # 查询: probe_success{job="network-ping"}
# 2. 检查告警规则文件 # 2. 检查告警规则文件
cat central-server/alert_rules.yml cat central-server/config/prometheus/alert_rules.yml
# 3. 检查 Prometheus 配置 # 3. 检查 Prometheus 配置
cat central-server/prometheus.yml cat central-server/config/prometheus/prometheus.yml
``` ```
**常见原因** **常见原因**
@@ -130,7 +130,7 @@ cat central-server/prometheus.yml
**解决方案** **解决方案**
- 部署边缘节点并配置监控目标 - 部署边缘节点并配置监控目标
- 检查告警规则表达式 - 检查告警规则表达式
- 确认 `prometheus.yml` 中引用了 `alert_rules.yml` - 确认 `config/prometheus/prometheus.yml` 中引用了 `alert_rules.yml`
- 重启 Prometheus 容器 - 重启 Prometheus 容器
--- ---
@@ -374,7 +374,7 @@ ls -lh /storage/prometheus-data
ls -lh /storage/victoria-metrics-data ls -lh /storage/victoria-metrics-data
# 检查数据保留配置 # 检查数据保留配置
grep retention prometheus.yml grep retention config/prometheus/prometheus.yml
``` ```
**解决** **解决**

View File

@@ -1,8 +1,8 @@
# 多阶段构建:在镜像内编译,无需本机安装 Go # 多阶段构建:在镜像内编译,无需本机安装 Go
FROM golang:1.21-alpine AS builder FROM golang:1.21-alpine AS builder
WORKDIR /app WORKDIR /app
COPY go.mod ./ COPY apps/onvif-exporter/go.mod ./
COPY main.go ./ COPY apps/onvif-exporter/main.go ./
RUN go mod tidy && CGO_ENABLED=0 GOOS=linux go build -o /onvif-exporter . RUN go mod tidy && CGO_ENABLED=0 GOOS=linux go build -o /onvif-exporter .
FROM alpine:3.19 FROM alpine:3.19

View File

@@ -1,6 +1,10 @@
#!/bin/bash #!/bin/bash
# 边缘节点部署vmagent + 内存/磁盘缓存 # 边缘节点部署vmagent + 内存/磁盘缓存
# 用法: ./deploy.sh [--local] --local = 本机同机(中央与边缘同机) # 用法: ./deploy.sh [--local] --local = 本机同机(中央与边缘同机)
#
# targets.csv部署时自动从 targets.csv 生成 target-onvif.json、target-ping.json
# 修改 targets.csv 后需手动执行 config/update-configs.sh或重新 deploy
# vmagent 每 5 分钟自动重载 JSON无需重启。
set -e set -e
cd "$(dirname "${BASH_SOURCE[0]}")" cd "$(dirname "${BASH_SOURCE[0]}")"
@@ -24,7 +28,7 @@ command -v jq &>/dev/null || { echo "❌ 需要 jq"; exit 1; }
[ -f config/targets.csv ] && (cd config && ./update-configs.sh) || true [ -f config/targets.csv ] && (cd config && ./update-configs.sh) || true
[ ! -f config/target-onvif.json ] && echo '[]' > config/target-onvif.json [ ! -f config/target-onvif.json ] && echo '[]' > config/target-onvif.json
[ ! -f config/target-ping.json ] && echo '[]' > config/target-ping.json [ ! -f config/target-ping.json ] && echo '[]' > config/target-ping.json
[ ! -f prometheus-edge/vmagent-scrape.yml.template ] && { echo "❌ 缺少 vmagent-scrape.yml.template"; exit 1; } [ ! -f config/vmagent/vmagent-scrape.yml.template ] && { echo "❌ 缺少 config/vmagent/vmagent-scrape.yml.template"; exit 1; }
# .env # .env
[ ! -f .env ] && cp env.example .env [ ! -f .env ] && cp env.example .env

View File

@@ -13,7 +13,7 @@ services:
- CENTRAL_SERVER_PORT=${CENTRAL_SERVER_PORT:-8428} - CENTRAL_SERVER_PORT=${CENTRAL_SERVER_PORT:-8428}
volumes: volumes:
- vmagent-cache-data:/cache - vmagent-cache-data:/cache
- ./prometheus-edge/vmagent-scrape.yml.template:/etc/vmagent/scrape.yml:ro - ./config/vmagent/vmagent-scrape.yml.template:/etc/vmagent/scrape.yml:ro
- ./config/target-onvif.json:/etc/prometheus/target-onvif.json:ro - ./config/target-onvif.json:/etc/prometheus/target-onvif.json:ro
- ./config/target-ping.json:/etc/prometheus/target-ping.json:ro - ./config/target-ping.json:/etc/prometheus/target-ping.json:ro
mem_limit: "256m" mem_limit: "256m"
@@ -38,8 +38,8 @@ services:
- onvif - onvif
image: onvif-exporter:local image: onvif-exporter:local
build: build:
context: ./onvif-exporter context: .
dockerfile: Dockerfile dockerfile: apps/onvif-exporter/Dockerfile
container_name: onvif-exporter container_name: onvif-exporter
restart: unless-stopped restart: unless-stopped
environment: environment:
@@ -57,7 +57,7 @@ services:
container_name: blackbox-exporter container_name: blackbox-exporter
restart: unless-stopped restart: unless-stopped
volumes: volumes:
- ./blackbox/config.yml:/etc/blackbox_exporter/config.yml:ro - ./config/blackbox/config.yml:/etc/blackbox_exporter/config.yml:ro
mem_limit: "64m" mem_limit: "64m"
cpus: "0.5" cpus: "0.5"
networks: networks:

View File

@@ -19,9 +19,10 @@ EDGE_NODE_ID=workernode_1
# 格式: http://域名或IP:端口/api/v1/write # 格式: http://域名或IP:端口/api/v1/write
# 默认端口: 8428 (VictoriaMetrics) # 默认端口: 8428 (VictoriaMetrics)
# 边缘缓存docker-compose.yaml 使用 vmagent含内存+磁盘缓存,详见 doc/EDGE_CACHE.md # 边缘缓存docker-compose 使用 vmagent含内存+磁盘缓存,详见 doc/EDGE_AGENT_CONFIG.md
# 注意ONVIF 设备在 config/targets.csv 中配置(每行 ip、username、password 等) # 注意ONVIF 设备在 config/targets.csv 中配置(每行 ip、username、password 等)
# 配置与自建应用结构config/vmagent、blackbox、targets; apps/onvif-exporter
# ONVIF Exporter 镜像(仅在使用 --profile onvif 时需要) # ONVIF Exporter 镜像(仅在使用 --profile onvif 时需要)
# 公共 registry 无现成镜像,需自建或使用第三方镜像,参见 doc/ONVIF_ALTERNATIVES.md # 公共 registry 无现成镜像,需自建或使用第三方镜像,参见 doc/ONVIF_ALTERNATIVES.md

View File

@@ -1,45 +0,0 @@
global:
scrape_interval: 120s
evaluation_interval: 120s
external_labels:
region: workernode_1 # 设置一个唯一边缘节点名称
remote_write:
- url: http://192.168.2.106:8428/api/v1/write
queue_config:
max_samples_per_send: 5000
capacity: 5000
max_shards: 5
scrape_configs:
- job_name: 'onvif-devices'
scrape_interval: 120s
file_sd_configs:
- files: ['/etc/prometheus/onvif-targets.json']
refresh_interval: 5m
metrics_path: /metrics
static_configs:
- targets: ['onvif-exporter:9600']
- job_name: 'network-ping'
scrape_interval: 300s
file_sd_configs:
- files: ['/etc/prometheus/ping-targets.json']
refresh_interval: 5m
metrics_path: /probe
params:
module: [icmp]
static_configs:
- targets: ['blackbox-exporter:9115']
relabel_configs:
- source_labels: [__address__]
target_label: __param_target
- source_labels: [__param_target]
target_label: instance
- target_label: __address__
replacement: blackbox-exporter:9115
- job_name: 'prometheus-edge'
scrape_interval: 60s
static_configs:
- targets: ['localhost:9090']

View File

@@ -1,45 +0,0 @@
global:
scrape_interval: 120s
evaluation_interval: 120s
external_labels:
region: workernode_1 # 设置一个唯一边缘节点名称
remote_write:
- url: http://${CENTRAL_SERVER_HOST}:${CENTRAL_SERVER_PORT}/api/v1/write
queue_config:
max_samples_per_send: 5000
capacity: 10000
max_shards: 8
scrape_configs:
- job_name: 'onvif-devices'
scrape_interval: 120s
file_sd_configs:
- files: ['/etc/prometheus/onvif-targets.json']
refresh_interval: 5m
metrics_path: /metrics
static_configs:
- targets: ['onvif-exporter:9600']
- job_name: 'network-ping'
scrape_interval: 300s
file_sd_configs:
- files: ['/etc/prometheus/ping-targets.json']
refresh_interval: 5m
metrics_path: /probe
params:
module: [icmp]
static_configs:
- targets: ['blackbox-exporter:9115']
relabel_configs:
- source_labels: [__address__]
target_label: __param_target
- source_labels: [__param_target]
target_label: instance
- target_label: __address__
replacement: blackbox-exporter:9115
- job_name: 'prometheus-edge'
scrape_interval: 60s
static_configs:
- targets: ['localhost:9090']

View File

@@ -1,6 +0,0 @@
{
"name": "tianditu-tile-cache",
"version": "1.0.0",
"description": "Cache Tianditu WMTS tiles to reduce API key usage",
"main": "server.js"
}