c4825c2d27
- 对外端口统一为 18428（vmauth 入口），VM 不再直接暴露宿主机端口 - 边缘 vmagent 与中央 Prometheus remote_write 增加 basic auth - 支持 tenants.csv 驱动的 per-tenant 写入/查询隔离，并提供管理员跨租户只读查询 - 更新 Grafana provisioning 与部署/文档 Made-with: Cursor
198 lines
7.5 KiB
Plaintext
198 lines
7.5 KiB
Plaintext
# =============================================================================
|
||
# 中央服务器环境变量配置模板
|
||
# =============================================================================
|
||
#
|
||
# 【用途】
|
||
# 本文件为 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
|
||
#
|
||
# 若不存在 .env，deploy.sh 会自动从 env.example 创建，并提示修改后重试。
|
||
#
|
||
# 【变量去向】
|
||
# - deploy.sh：加载 .env，生成 prometheus.yml，创建数据目录，启动 docker-compose
|
||
# - docker-compose：端口、数据目录、容器环境变量、Traefik 标签等
|
||
# - prometheus.yml.template：PROMETHEUS_*、VICTORIAMETRICS_PORT 等（见模板头部）
|
||
#
|
||
# 【修改生效】
|
||
# 修改 .env 后需重新运行 ./deploy.sh。不要直接编辑 prometheus.yml，其由模板生成。
|
||
#
|
||
# =============================================================================
|
||
|
||
# ============================================
|
||
# 端口配置
|
||
# ============================================
|
||
# 宿主机映射端口，对应各服务容器内端口。端口冲突时修改此处。
|
||
|
||
# Prometheus Web UI 端口（避免与 cockpit 9090 冲突，故默认 9091）
|
||
# 访问：http://localhost:${PROMETHEUS_PORT}
|
||
PROMETHEUS_PORT=9091
|
||
|
||
# Grafana Web UI 端口
|
||
# 访问：http://localhost:${GRAFANA_PORT}
|
||
GRAFANA_PORT=3000
|
||
|
||
# Alertmanager Web UI 端口
|
||
ALERTMANAGER_PORT=9093
|
||
|
||
# VictoriaMetrics 端口（边缘 vmagent 通过 remote_write 推送到此端口）
|
||
# 必须与边缘侧 CENTRAL_SERVER_PORT 一致；通常不通过 Traefik，边缘直连
|
||
VICTORIAMETRICS_PORT=18428
|
||
|
||
# ============================================
|
||
# Grafana 配置
|
||
# ============================================
|
||
|
||
# Grafana 管理员密码（生产环境必须修改，建议 12 位以上强密码）
|
||
GRAFANA_ADMIN_PASSWORD=admin123
|
||
|
||
# Grafana 默认语言：zh-Hans 简体中文，en 英文
|
||
GRAFANA_DEFAULT_LANGUAGE=zh-Hans
|
||
|
||
# Grafana 默认主题：light 浅色，dark 深色
|
||
GRAFANA_DEFAULT_THEME=light
|
||
|
||
# Grafana 根 URL（使用 Traefik 时设为对外访问地址，如 https://grafana.example.com）
|
||
# 影响登录跳转、OAuth 回调等
|
||
GRAFANA_ROOT_URL=http://localhost:3000
|
||
|
||
# ============================================
|
||
# Prometheus 配置
|
||
# ============================================
|
||
# 部分变量会代入 prometheus.yml.template 生成 prometheus.yml
|
||
|
||
# Prometheus 本地 TSDB 数据保留时间（如 30d、7d、1y）
|
||
PROMETHEUS_RETENTION_TIME=30d
|
||
|
||
# 抓取间隔（秒），影响中央 Prometheus 抓取本机服务的频率
|
||
# 建议 15–60；越小越实时，负载越高
|
||
PROMETHEUS_SCRAPE_INTERVAL=15
|
||
|
||
# 告警规则评估间隔（秒）
|
||
PROMETHEUS_EVALUATION_INTERVAL=15
|
||
|
||
# 集群标识，作为 external_labels 中的 cluster 标签，用于区分多集群
|
||
PROMETHEUS_CLUSTER_NAME=central-monitoring
|
||
|
||
# remote_write 到 VictoriaMetrics 的队列参数（中央 Prometheus 将抓取数据推送到 VM）
|
||
# 边缘写入量大时可适当调大；一般保持默认即可
|
||
PROMETHEUS_REMOTE_WRITE_MAX_SAMPLES=10000
|
||
PROMETHEUS_REMOTE_WRITE_CAPACITY=20000
|
||
PROMETHEUS_REMOTE_WRITE_MAX_SHARDS=10
|
||
|
||
# ============================================
|
||
# VictoriaMetrics 配置
|
||
# ============================================
|
||
# VM 接收边缘 remote_write 并存储；Grafana 数据源通常指向 VM
|
||
|
||
# VM 数据保留时间（如 30d、90d）
|
||
VICTORIAMETRICS_RETENTION_PERIOD=30d
|
||
|
||
# ============================================
|
||
# vmauth（鉴权 / 多租户入口）
|
||
# ============================================
|
||
# vmauth 作为 VictoriaMetrics 的统一入口：对外仅暴露 vmauth 端口；
|
||
# - 写入账号：边缘 vmagent、中央 Prometheus remote_write
|
||
# - 只读账号：Grafana 查询（建议只读）
|
||
#
|
||
# 生产环境必须修改为强口令，并避免跨环境复用。
|
||
#
|
||
# 【严格多租户（推荐）】
|
||
# 在 central-server/config/vmauth/tenants.csv 中为每个边缘节点配置独立凭据与 tenant_id；
|
||
# deploy.sh 会据此生成 vmauth.yml 与 Grafana 多数据源 provisioning。
|
||
# 可参考示例：central-server/config/vmauth/tenants.csv.example
|
||
#
|
||
# 【单租户兼容模式（可选）】
|
||
# 如果你不提供 tenants.csv，将使用下面这组单租户账号生成 vmauth 配置（不做按 tenant 隔离）。
|
||
VMAUTH_WRITE_USER=vm_write
|
||
VMAUTH_WRITE_PASSWORD=change-me-strong-write
|
||
VMAUTH_READ_USER=vm_read
|
||
VMAUTH_READ_PASSWORD=change-me-strong-read
|
||
|
||
# 【管理员只读账号（可选）】
|
||
# 允许访问所有租户的 /select/<tenant_id>/prometheus/... 查询接口（只读）。
|
||
# 用途：管理员在同一套 Grafana 下查看所有租户（可在仪表盘用“数据源变量”切换租户）。
|
||
VMAUTH_ADMIN_USER=vm_admin
|
||
VMAUTH_ADMIN_PASSWORD=change-me-strong-admin
|
||
|
||
# ============================================
|
||
# 数据存储路径
|
||
# ============================================
|
||
# 相对于 central-server 目录；deploy.sh 会转换为绝对路径供 Docker 使用
|
||
|
||
# 数据存储根目录（可选，部分脚本可能引用）
|
||
DATA_STORAGE_ROOT=./data
|
||
|
||
# Prometheus 本地 TSDB 数据目录
|
||
PROMETHEUS_DATA_DIR=./data/prometheus-data
|
||
|
||
# Grafana 数据库与插件数据目录
|
||
GRAFANA_DATA_DIR=./data/grafana-data
|
||
|
||
# VictoriaMetrics 时序数据目录
|
||
VICTORIAMETRICS_DATA_DIR=./data/victoria-metrics-data
|
||
|
||
# 天地图瓦片缓存（供 topology-editor、Grafana Geomap 使用）
|
||
# 在 .env 中设置 TIANDITU_TK 后，tile-cache 才可正常工作
|
||
# TIANDITU_TK=您的天地图密钥
|
||
# TILE_CACHE_PORT=4090
|
||
# TILE_CACHE_DATA_DIR=./data/tile-cache
|
||
# TILE_CACHE_TTL_DAYS=7
|
||
# TILE_CACHE_UPSTREAM_TIMEOUT_MS=15000
|
||
|
||
# ============================================
|
||
# Traefik 反向代理配置
|
||
# ============================================
|
||
# 启用后，docker-compose 会为各服务添加 Traefik 标签，通过域名访问
|
||
|
||
# 是否启用 Traefik（true/false）。为 false 时通过宿主机端口直接访问
|
||
TRAEFIK_ENABLED=true
|
||
|
||
# Traefik 来源：internal=本编排启动 Traefik（包含 traefik 服务）；external=使用已有外部 Traefik
|
||
# internal：本 compose 内启动 Traefik，自动创建网络，无需外部 Traefik
|
||
# external：接入已有 Traefik，需 traefik 网络已存在（如单独部署的 Traefik）
|
||
TRAEFIK_PROVIDER=external
|
||
|
||
# Traefik 所在 Docker 网络名称
|
||
# external 时通常为 traefik；internal 时为 central_default（compose 自动创建）
|
||
TRAEFIK_NETWORK=traefik
|
||
|
||
# 域名（需 DNS 解析到 Traefik 所在机器）
|
||
GRAFANA_DOMAIN=grafana.example.com
|
||
PROMETHEUS_DOMAIN=prometheus.example.com
|
||
ALERTMANAGER_DOMAIN=alertmanager.example.com
|
||
VICTORIAMETRICS_DOMAIN=vm.example.com
|
||
|
||
# Traefik EntryPoint（web=80, websecure=443）
|
||
TRAEFIK_ENTRYPOINT=web
|
||
|
||
# 是否启用 HTTPS（需 Traefik 配置 TLS）
|
||
TRAEFIK_HTTPS_ENABLED=false
|
||
|
||
# TRAEFIK_PROVIDER=internal 时，Traefik 监听的宿主机端口
|
||
# TRAEFIK_HTTP_PORT=80
|
||
# TRAEFIK_HTTPS_PORT=443
|
||
|
||
# ============================================
|
||
# Docker 网络配置
|
||
# ============================================
|
||
# 由 TRAEFIK_PROVIDER 决定；一般无需手动改，deploy.sh 会自动设置
|
||
|
||
# Compose 项目名称，用于区分同一目录多套部署
|
||
COMPOSE_PROJECT_NAME=central
|
||
|
||
# TRAEFIK_PROVIDER=external 时：
|
||
NETWORK_NAME=traefik
|
||
EXTERNAL_NETWORK=true
|
||
|
||
# TRAEFIK_PROVIDER=internal 时（deploy.sh 会自动改为）：
|
||
# NETWORK_NAME=central_default
|
||
# EXTERNAL_NETWORK=false
|
||
|
||
# 是否启用 IPv6（true/false）
|
||
ENABLE_IPV6=false
|