快捷導(dǎo)航

Docker?部署?Grafana持久化存儲(chǔ)配置避免重啟丟失的問(wèn)題

更新時(shí)間：2026年05月19日 08:49:02 作者：茶貓?jiān)蒲?

文章介紹了將宿主機(jī)目錄掛載到容器的/var/lib/grafana路徑,以實(shí)現(xiàn)Grafana數(shù)據(jù)的持久化,詳細(xì)描述了在Docker和Docker Compose環(huán)境中實(shí)現(xiàn)這一方案的步驟,包括創(chuàng)建目錄、修正文件權(quán)限、啟動(dòng)容器等,同時(shí),文章還列舉了一些常見(jiàn)問(wèn)題及排查方法

適合：需要保留儀表盤(pán)、數(shù)據(jù)源配置、插件及用戶信息的生產(chǎn)或測(cè)試環(huán)境。
先準(zhǔn)備：在宿主機(jī)創(chuàng)建用于存儲(chǔ)數(shù)據(jù)的目錄，并確認(rèn)文件權(quán)限。
驗(yàn)收：容器重啟后，檢查原有儀表盤(pán)和數(shù)據(jù)源配置是否依然存在。

原理說(shuō)明

Docker 容器的文件系統(tǒng)是分層的，默認(rèn)情況下，容器內(nèi)產(chǎn)生的所有寫(xiě)入操作都存儲(chǔ)在可寫(xiě)層中。一旦容器被刪除（docker rm），這一層數(shù)據(jù)就會(huì)隨之消失。Grafana 的核心配置、SQLite 數(shù)據(jù)庫(kù)（默認(rèn)存儲(chǔ)方式）、插件和用戶信息都保存在容器內(nèi)的 /var/lib/grafana 目錄下。如果不將這個(gè)目錄掛載到宿主機(jī)，每次重建容器都相當(dāng)于是一次全新的安裝。

Docker CLI 部署步驟

第一步：準(zhǔn)備宿主機(jī)目錄在運(yùn)行容器前，先在宿主機(jī)創(chuàng)建一個(gè)目錄用于存放數(shù)據(jù)。例如：

mkdir -p ~/grafana-data

第二步：修正文件權(quán)限（關(guān)鍵）Grafana 官方容器默認(rèn)使用 UID 472 運(yùn)行。如果宿主機(jī)目錄權(quán)限不對(duì)，容器可能無(wú)法寫(xiě)入數(shù)據(jù)，導(dǎo)致啟動(dòng)失敗或數(shù)據(jù)無(wú)法保存。建議將目錄所有者改為 472：

chown -R 472:472 ~/grafana-data

第三步：?jiǎn)?dòng)容器使用 -v 參數(shù)掛載目錄啟動(dòng)容器。建議指定具體版本號(hào)代替 latest，避免意外升級(jí)導(dǎo)致兼容性問(wèn)題：

docker run -d -p 3000:3000 \
  `--name`=grafana \
  -v ~/grafana-data:/var/lib/grafana \
  grafana/grafana-oss

Docker Compose 部署方案

對(duì)于生產(chǎn)環(huán)境，建議使用 Docker Compose 管理服務(wù)，便于版本控制和配置維護(hù)。創(chuàng)建 docker-compose.yml 文件：

version: '3.8'
services:
  grafana:
    image: grafana/grafana-oss:latest
    container_name: grafana
    ports:
      - "3000:3000"
    volumes:
      - ./grafana-data:/var/lib/grafana
    restart: unless-stopped
    user: "472:472"

啟動(dòng)服務(wù)：

docker-compose up -d

驗(yàn)證持久化是否生效

1. 界面驗(yàn)證登錄 Grafana 網(wǎng)頁(yè)，創(chuàng)建一個(gè)測(cè)試儀表盤(pán)或添加一個(gè)測(cè)試數(shù)據(jù)源。然后重啟容器：

docker restart grafana

刷新頁(yè)面，如果剛才創(chuàng)建的儀表盤(pán)和數(shù)據(jù)源還在，說(shuō)明持久化生效。

2. 文件驗(yàn)證查看宿主機(jī)掛載目錄，應(yīng)該能看到 grafana.db 等文件生成：

ls -l ~/grafana-data

常見(jiàn)坑與排查

1. 權(quán)限拒絕（Permission Denied）這是最常見(jiàn)的問(wèn)題。如果日志中出現(xiàn) panic 或無(wú)法寫(xiě)入 sqlite 的錯(cuò)誤，通常是宿主機(jī)目錄權(quán)限不屬于容器內(nèi)的用戶（UID 472）。不要隨意 chmod 777，優(yōu)先使用 chown 修正所有者。

2. 掛載路徑錯(cuò)誤確保掛載的是 /var/lib/grafana。有些舊教程可能指向其他路徑，或者只掛載了配置目錄 /etc/grafana 而忽略了數(shù)據(jù)目錄，這會(huì)導(dǎo)致配置保留但儀表盤(pán)丟失。

3. 容器重建而非重啟使用 docker restart 不會(huì)丟失數(shù)據(jù)，但 docker rm 后重新 run 如果沒(méi)有 -v 參數(shù)則會(huì)丟失。持久化是為了應(yīng)對(duì)容器被刪除重建的場(chǎng)景。

參考來(lái)源

Grafana Labs - Install Grafana using Docker: https://grafana.com/docs/grafana/latest/setup-grafana/installation/docker/

到此這篇關(guān)于Docker 部署 Grafana持久化存儲(chǔ)配置避免重啟丟失的問(wèn)題的文章就介紹到這了,更多相關(guān)Docker部署Grafana內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: