grafana.ini 是什么
grafana.ini 是 Grafana 的主配置文件，按 [节] 组织：server 管监听端口与外部访问地址，database 管元数据库，security 管密钥，users 与 auth.* 控制用户接入与匿名访问。同一份配置可以用环境变量逐项覆盖，规则是 GF_ 加节名加键名并全部大写，容器化部署通常只写环境变量而不落文件。
基本信息
| 默认路径 | /etc/grafana/grafana.ini |
|---|---|
| 组织方式 | [节] + 键值 |
| 环境变量覆盖 | GF_SERVER_HTTP_PORT=3000 |
| 常用节 | server / database / security / users / auth.* |
| 生效方式 | 改完重启 Grafana 进程 |
| 关键键 | root_url、secret_key、allow_sign_up |
典型使用场景
- 改监听端口或绑定地址，与反向代理配合对外提供服务
- 设置 root_url，让分享链接与告警图片指向正确的外部域名
- 关闭自助注册（allow_sign_up=false），避免公网实例被随意注册
- 把元数据库从 SQLite 换成 MySQL 或 PostgreSQL，支撑多实例部署
- 开启匿名访问用于大屏展示，同时限制为只读角色
- 通过环境变量注入密钥，避免把密码写进镜像与仓库
常用配置片段
常用配置片段
[server]
http_port = 3000
root_url = https://grafana.example.com/ # 外部访问地址
[database]
type = mysql
host = 127.0.0.1:3306
name = grafana
[users]
allow_sign_up = false # 关闭自助注册
[security]
secret_key = <32 位以上随机串>
[auth.anonymous]
enabled = false常用节与键
| 节 | 键 | 作用 |
|---|---|---|
| server | http_port / root_url | 监听与外部地址 |
| database | type / host / name | 元数据库连接 |
| security | secret_key | 加密数据源密码等敏感内容 |
| users | allow_sign_up | 是否允许自助注册 |
| auth.anonymous | enabled / org_role | 匿名访问与角色 |
环境变量覆盖规则：GF_ + 节名 + 键名并使用大写，例如 GF_SERVER_HTTP_PORT=3000；节名里的点用下划线替换（auth.anonymous 对应 GF_AUTH_ANONYMOUS_ENABLED）。
root_url 与实际访问地址不一致时，分享链接、快照与告警通知里的图片地址都会指向错误域名，是最常见的「配了但不对」问题。
secret_key 变化会使已加密的数据源密码无法解密，需要重新录入；多实例部署时各实例必须使用同一个 secret_key。
配置项默认值会随版本变化，升级后建议核对官方样例配置，只保留确有需要的键，避免沿用旧默认值。