跳至內容
For the complete documentation index, see llms.txt. This page is also available as Markdown.

掛載主機目錄

什麼是綁定掛載

Bind Mount(綁定掛載)將 Docker daemon 所在主機 上的目錄或檔案直接掛載到容器中。容器可以讀寫這台主機上的檔案系統。

目錄結構(同一份檔案):

/home/user/code/ (或 /usr/share/nginx/html/)
├── index.html
├── style.css
└── app.js

Bind Mount vs Volume

特性
Bind Mount
Volume

資料位置

宿主機任意路徑

Docker 管理的目錄

路徑指定

必須是絕對路徑

卷名

可移植性

依賴宿主機路徑

更好(Docker 管理)

效能

依賴宿主機檔案系統

最佳的儲存驅動

適用場景

開發環境、設定檔案

生產資料持久化

備份

直接存取檔案

需要透過 Docker

選擇建議

需求
推薦方案

開發時同步程式碼

Bind Mount

持久化資料庫資料

Volume

共享設定檔案

Bind Mount

容器間共享資料

Volume

備份方便

Bind Mount(直接存取)

生產環境

Volume


基本語法

使用 --mount:推薦

使用 -v:簡寫

兩種語法對比

特性
--mount
-v

語法

鍵值對,更清晰

冒號分隔,更簡潔

路徑不存在時

直接報錯 (Fail Fast)

靜默自動建立 目錄

推薦程度

✅ 推薦

常用

⚠️ 陷阱:如果不小心掛載了一個不存在的主機路徑,使用 -v 會在 daemon 主機 上靜默建立一個空目錄。對於本地 Docker Desktop 使用者,這個主機通常就是本機;對於遠端 daemon,這個主機就是遠端機器。這也是 Docker 官方更推薦使用 --mount 的原因:它會直接報錯,避免因路徑拼寫錯誤而掛錯位置。


使用場景

場景一:開發環境程式碼同步

場景二:設定檔案掛載

場景三:日誌收集

場景四:共享 SSH 金鑰

唯讀掛載可以防止容器修改主機金鑰,但不能防止容器讀取並外傳金鑰。只有在映像檔完全可信、金鑰作用域很窄且可隨時輪換時,才考慮這種做法。更穩妥的方式是使用 SSH agent socket 轉發、一次性 deploy key,或在 CI/建立場景中使用 BuildKit --ssh。


唯讀掛載

防止容器修改宿主機檔案:

容器內嘗試寫入會報錯:


掛載單個檔案

⚠️ 注意:掛載單個檔案時,如果宿主機上的檔案被編輯器替換(而非原地修改),容器內仍是舊檔案的 inode。建議重啟容器或掛載目錄。


查看掛載資訊

輸出:

欄位
說明

Type

掛載類型 (bind)

Source

宿主機路徑

Destination

容器內路徑

RW

是否可讀寫

Propagation

掛載傳播模式


常見問題

Q:路徑不存在報錯

解決:確保源路徑存在。若你確實需要自動建立目錄,可改用 -v,但要先確認建立位置就是你想要的主機路徑。

Q:權限問題

容器內使用者可能無權存取掛載的檔案:

Q:macOS/Windows 效能問題

在 Docker Desktop 上,Bind Mount 效能通常不如 Volume,因為資料需要在宿主機檔案系統和 Linux VM 之間同步:

選項
說明

:cached

宿主機權威,容器讀取可能延遲

:delegated

容器權威,宿主機讀取可能延遲

:consistent

預設,完全一致(最慢)

注意:Docker Desktop 4.6+ 預設使用 VirtioFS 檔案共享引擎,上述 :cached/:delegated 選項已被靜默忽略。如需最佳化檔案同步效能,請參考 Docker Desktop 的 Synchronized file shares 功能。


最佳實踐

1. 開發環境使用 Bind Mount

2. 生產環境使用 Volume

3. 設定檔案使用唯讀掛載

4. 注意路徑安全


最後更新於