deploy.stack/grafana

Grafana 部署说明

Grafana 是一个开源的可观测性平台，支持 Prometheus、InfluxDB、Loki、Elasticsearch 等多种数据源，提供丰富的仪表盘和告警能力，适用于基础设施监控、应用性能分析和日志可视化等场景。

目录结构

文件	说明
compose.yml	Docker Compose 部署配置
env.cfg	环境变量（镜像版本）
env.cfg.example	环境变量模板（不含敏感信息）

部署命令

# 拉取镜像
docker compose -p grafana --env-file ./grafana/env.cfg -f ./grafana/compose.yml pull

# 启动服务
docker compose -p grafana --env-file ./grafana/env.cfg -f ./grafana/compose.yml up -d

# 停止服务
docker compose -p grafana --env-file ./grafana/env.cfg -f ./grafana/compose.yml down

# 查看日志
docker compose -p grafana --env-file ./grafana/env.cfg -f ./grafana/compose.yml logs -f

环境变量说明

变量	说明	示例
IMAGE_TAG_VER	Grafana 镜像版本	13.0.2
IMAGE_TAG	完整镜像标签	grafana/grafana:13.0.2

访问服务

• 默认端口：3000
• 访问地址：http://<主机IP>:3000
• 默认登录凭据：admin / admin（首次登录后建议修改密码）

持久化

当前配置使用无状态模式，容器重启后仪表盘和配置会丢失。如需持久化，建议在 compose.yml 中添加卷挂载：

services:
  grafana:
    volumes:
      - ${Volumes_Path:-/data/volumes/grafana}:/var/lib/grafana   # 数据持久化

并确保宿主机目录权限正确：

# 创建数据目录
mkdir -pv /data/volumes/grafana

# 设置目录属主为 Grafana 容器用户（UID 472）
chown -R 472:472 /data/volumes/grafana

注意事项

• Grafana 和 Gitea 默认都使用 3000 端口，部署在同一宿主机时需通过 env.cfg 或 compose 调整端口映射避免冲突
• 容器使用 restart: unless-stopped 策略，宿主机重启后自动拉起
• 默认使用匿名用户访问，如需接入 LDAP/OAuth 等认证，需挂载自定义 grafana.ini 配置文件
• 生产环境建议配置数据源和告警渠道的持久化存储
• 当前 env.cfg.example 版本为 13.0.2，实际部署版本以 env.cfg 为准