容器方式的特点
用容器运行 Grafana 是最快的上手方式：拉取镜像、映射端口、挂载数据目录即可访问。关键点全在挂载与配置注入上——数据目录决定看板与用户信息能否持久，环境变量决定初始配置，端口映射决定访问入口。
容器重建的数据风险
容器重建会丢失未挂载的数据：调整参数或升级镜像时通常要删掉旧容器再重建，如果数据目录没有落到持久化卷上，全部看板、用户与数据源配置都会一并消失。因此部署的第一步就是规划数据目录，而不是先把服务跑起来。
基本信息
| 默认端口 | 3000 |
|---|---|
| 数据目录 | 存放数据库、插件与快照 |
| 配置注入 | 用环境变量覆盖配置文件中的同名项 |
| 配置文件 | 可挂载自定义文件替代默认配置 |
典型使用场景
- 快速验证：几分钟内起一个实例试用看板功能
- 小型部署：单机运行，数据目录落在本地持久化存储
- 升级与回滚：镜像版本随配置管理升级，回滚只需换标签
- 多实例隔离：按团队或环境各起一套，数据目录互不影响
- 配置固化：把数据源与看板做成配置文件随部署下发
启动命令
启动命令
docker run -d --name=grafana \
-p 3000:3000 \
-v grafana-storage:/var/lib/grafana \
-e GF_SECURITY_ADMIN_PASSWORD='<设置强密码>' \
-e GF_USERS_ALLOW_SIGN_UP=false \
grafana/grafana:latest
docker logs -f grafana # 确认启动日志无报错关键挂载与变量
| 项 | 作用 | 注意 |
|---|---|---|
| 数据目录挂载 | 保存数据库与配置 | 不挂载则重建即丢失 |
| 配置文件挂载 | 覆盖默认配置 | 改动前先备份原文件 |
| 管理员密码变量 | 设置初始管理员密码 | 仅在首次初始化时生效 |
| 时区变量 | 统一时间显示口径 | 需与数据源时区一致 |
部署后的检查
- 确认数据目录落在持久化存储上，而不是匿名卷
- 用非默认密码登录并检查初始配置是否生效
- 重启一次容器，确认看板与数据源仍然存在
环境变量按节名与键名的大写形式书写，写错不会报错、配置只是不生效，排查时很容易在错误的方向上花时间。
升级前先备份数据目录：跨大版本升级会涉及数据结构迁移，出问题时必须能回退到旧版本。