如何在Docker Swarm部署的开源Grafana中持久化用户数据

核心问题定位 #

Grafana的用户、权限等核心数据默认存储在/var/lib/grafana/grafana.db（SQLite数据库文件）中。你当前的持久化配置未正确覆盖该路径，导致重新部署栈时数据库被重置；而删除服务后卷仍保留旧数据库文件，所以用户还能登录。

实现用户持久化的具体操作 #

1. 修正Swarm栈的卷挂载配置 #

确保容器的/var/lib/grafana目录挂载到Swarm持久化卷，示例栈配置片段：

services:
  grafana:
    image: grafana/grafana:9.0
    volumes:
      - grafana-data:/var/lib/grafana
      # 保留你已有的仪表板、数据源、LDAP配置挂载
volumes:
  grafana-data:
    driver: local

优先使用Swarm命名卷而非主机绑定挂载，避免节点间路径不一致问题。

2. 确认数据库配置未被篡改 #

检查grafana.ini的数据库配置段，确保指向持久化路径：

[database]
type = sqlite3
path = /var/lib/grafana/grafana.db

若之前手动修改过path，改回默认值，保证该路径在挂载的卷范围内。

3. 排查卷权限与重置问题 #

• 权限检查：Grafana容器默认以UID 472的grafana用户运行，确保卷权限允许该用户读写。执行以下命令修复权限：

  docker run --rm -v grafana-data:/data alpine chown 472:472 /data
  

• 卷重置排查：若重新部署后数据丢失，检查是否使用--force参数导致卷被重建。用docker volume inspect grafana-data确认卷的存在及数据完整性。

关于配置文件实现用户持久化 #

Grafana不支持通过配置文件直接定义用户和权限（LDAP同步除外），这类数据必须存储在数据库中。因此唯一可靠的方式是持久化grafana.db所在的/var/lib/grafana目录。

解释"删除服务后仍能登录"现象 #

删除Swarm服务后，对应的持久化卷不会自动删除，grafana.db仍保留。若重新部署后数据丢失，大概率是卷未被正确关联，导致Grafana初始化了新的数据库；而删除服务后能登录，可能是Swarm服务副本在其他节点未完全停止，用docker service ps grafana确认所有副本状态。

内容的提问来源于stack exchange，提问作者akshatha prakash