できない.dev

Docker のボリュームマウントで permission denied になり書き込めない

bind mount したホストディレクトリに対しコンテナ側の uid/gid が一致しないと書き込めない。
--user で uid を揃える、:Z で SELinux ラベルを付ける、named volume に切り替える、の 3 系統で対処する。

公開: 更新:

症状できない · exit 1
docker run --rm -u 999:999 -v /var/tmp/dk-volume-perm-demo:/work alpine:3 touch /work/hello
touch: /work/hello: Permission denied
解決後できた · exit 0
docker run --rm -u 1000:1000 -v /var/tmp/dk-volume-perm-demo:/work alpine:3 touch /work/hello

2026-10-05 に local host (Windows 11 Home, Docker 29.8.0)(Docker 29.8.0 / Node.js 22.14.0) で実際に打って取った出力。検証環境の詳細

要約

Permission denied が bind mount の中で起きる原因の大半は、コンテナ内プロセスの uid/gid とホスト側ディレクトリの所有者が一致していない ことにある。
--user で実行 uid を揃える、:Z で SELinux ラベルを付ける、もしくは named volume に切り替えれば解消する。

実行例

所有者が 1000:1000 のディレクトリを bind mount して -u 999:999 で touch すると、Permission denied(終了コード 1)になった。
-u 1000:1000 に揃えると書き込めて、できたファイルの所有者も 1000:1000 になった。

$ docker run --rm -v /var/tmp/dk-volume-perm-demo:/work alpine:3 ls -ldn /work
drwxr-xr-x    2 1000     1000            40 Oct  5 01:10 /work
$ docker run --rm -u 999:999 -v /var/tmp/dk-volume-perm-demo:/work alpine:3 touch /work/hello
touch: /work/hello: Permission denied
$ echo $?
1
$ docker run --rm -u 1000:1000 -v /var/tmp/dk-volume-perm-demo:/work alpine:3 touch /work/hello
$ echo $?
0
$ docker run --rm -v /var/tmp/dk-volume-perm-demo:/work alpine:3 ls -ln /work
total 0
-rw-r--r--    1 1000     1000             0 Oct  5 01:10 hello

— 2026-10-05 時点の出力

検証環境Node.js 22.14.0 / npm 10.9.2 / Git 2.48.1.windows.1 / 2026-10-05 検証(ほか 1 件)
検証日
実行環境
local host (Windows 11 Home, Docker 29.8.0)
バージョン
  • Node.js 22.14.0
  • npm 10.9.2
  • Git 2.48.1.windows.1
  • Docker 29.8.0

この記事の「実行例」は、上記の環境で実際にコマンドを実行して得られた出力をそのまま掲載しています。 再現手順はリポジトリの検証スクリプトとして管理し、定期的に再実行して出力を更新しています。

解決策

1. ホストの uid/gid で実行

docker run --rm \
  -u "$(id -u):$(id -g)" \
  -v "$PWD:/work" \
  alpine sh -c 'touch /work/hello'

コンテナ内で書いたファイルが ホスト側でも自分の所有 で残る。
開発端末では、これが最も手早い対処である。

2. SELinux ラベルを付ける

docker run -v "$PWD:/work:Z" alpine ...

:Z は そのコンテナ専用 にラベルを付け、:z は他のコンテナと共有可能にする。
詳しい仕様は bind mount の公式ドキュメント(新しいタブで開く) に書かれている。

3. コンテナ内で所有者を揃える

RUN useradd -u 1000 -m appuser && \
    mkdir -p /data && chown appuser:appuser /data
USER appuser

イメージ側で uid 1000 を作っておけば、ホスト側のユーザー(多くの Linux で uid 1000)とぶつからない。

4. named volume を使う

docker volume create app-data
docker run -v app-data:/data myimage

named volume はホスト側のディレクトリの権限には左右されない。
ただし書き込めるかどうかは volume の中の所有者で決まる。
空の named volume を初めてマウントすると、イメージ側のそのディレクトリの中身がコピーされ、所有者も引き継がれる(volumes の公式ドキュメント(新しいタブで開く) の「Mounting a volume over existing data」)。
そのため、解決策 3 のようにイメージ側で chown しておけば、非 root のユーザーでも書ける。
イメージ側にそのディレクトリが無いと volume は root:root の 755 で作られ、-u 999:999 のような非 root のユーザーでは Permission denied になる(Docker 29.8.0 で確認)。
永続化目的なら bind mount より移植性が高い。

よくある原因

  1. uid が一致していない。
    コンテナの実行ユーザー(イメージ既定の root 以外)の uid が、ホスト側のファイル所有者と違う。
  2. SELinux が拒否している。
    RHEL / Fedora 系で avc: denied が出る(bind mount にラベルが無い)。
  3. userns-remap で uid がずれている。
    rootless / Docker Desktop で uid が再マップされ、ホスト側の uid と食い違う(公式の userns-remap ドキュメント(新しいタブで開く) 参照)。
  4. mount の種別を取り違えている。
    macOS / Windows でホストパスを直接 bind し、所有権の概念が崩れる。