複数のNAS共有フォルダーでコンテナのユーザーIDを設定する方法

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

複数のNAS共有フォルダーにまたがってコンテナのユーザーIDを設定するには、各コンテナプロセスの実際の数値IDを、必要な各共有フォルダーの所有者、グループ、ACL、マウントモードに対応付けます。

すべてのデータセットを1つのUIDの所有にしたり、連携の手段としてchmod 777を使ったりしないでください。メディアサーバーには写真への読み取り専用アクセス、ダウンローダーには取り込み用共有フォルダーへの読み書きアクセス、バックアップコンテナには別の保護された保存先が必要な場合があります。主な責任には所有権を、共有アクセスにはグループまたはACLを使ってください。

権限を変更する前に3つのIDを記録する

各サービスについて、NAS側の所有者のUID/GID、コンテナ内プロセスの数値ユーザーIDとグループID、さらにPUID/PGIDなどイメージ固有のID規則を記録してください。ユーザー名が同じでも数値IDが異なることがあり、この3つの値は混同されがちです。

最近のPUIDとPGIDはDockerの設定項目ではないという解説では、PUIDとPGIDは一部のコンテナイメージが解釈する変数であり、Docker共通の設定項目ではないことが明確にされています。

コンテナ内でidを実行してプロセスを確認し、ホスト側のファイルは数値の所有権を表示して確認してください。イメージがその方式に対応していない限り、Composeに記述した値が実際にプロセスを制御していると思い込まないでください。

サービス間でデータを共有するには、主な所有者と共有グループを使う

1つのアプリケーションだけが使う共有フォルダーには、専用の所有者を設定できます。複数のサービスが書き込む共有フォルダーは通常、必要な操作だけをそれらのサービスに許可するよう、共有グループやACLを適切に設定すると管理しやすくなります。

数値のUIDとGIDによる所有権についての実践的な解説では、バインドマウントされたファイルがホスト側の数値上の所有権に従う理由と、これらのIDを一致させるか意図的にマッピングすることで、root所有の出力や権限エラーを防げる理由を説明しています。

たとえばメディアのワークフローでは、ダウンローダーがステージングファイルの所有者となり、ダウンローダーと整理ツールの両方をmediaグループに所属させます。ディレクトリの継承、デフォルトACL、または適切なumaskの設定により、新しいファイルにも共有アクセス権が自動的に引き継がれるようにします。

各共有フォルダーに、コンテナが必要とするマウント権限だけを付与する

IDは複数あるレイヤーのうちの1つにすぎません。UIDが正しくマッピングされていても、読み取り専用のバインドマウントには書き込めません。また、コンテナに広範なファイルシステム権限があっても、ライブラリを読み取り専用でマウントすれば、安全にアクセスを制限できます。

2026年の記事実行時のユーザーオーバーライドでは、バインドマウントがホスト側の所有権を使用する仕組みと、実行時のuser:設定でプロセスIDを一致させる方法を解説しています。また、起動時の処理が別の権限を前提としているイメージでは、ユーザーを強制的に指定すると問題が発生する可能性があることにも注意を促しています。

各ホストパス、コンテナパス、マウントモード、必要な操作、担当サービスを文書化してください。サービスが読み込むだけのライブラリは読み取り専用でマウントし、書き込みアクセスは実際に必要な最小限のパスに限ります。

複数のNAS ACLモデルを意図的に使い分ける

SMB/NFSv4 ACL、POSIX ACL、NFSのIDマッピング、単純なUnixのモードビットでは、アクセス権の見え方が異なる場合があります。あるNASユーザーとしてSMB経由で使える共有でも、ホスト上で別の数値IDを使用するコンテナプロセスからはアクセスを拒否されることがあります。

関連するZimaSpaceの記事NASの権限変更では、保存先のACL継承、SMBのID、コンテナのUID/GID、umaskを、それぞれ別のレイヤーとして診断する必要がある理由を解説しています。

複数のプロトコルで1つのデータセットにアクセスする場合は、権限モデルを1つ選び、文書化してください。NASのGUIでのACL変更と、シェルでのchmodやchownコマンドを繰り返し混在させると、次に作成されるファイルの動作が前のファイルと異なることがあります。

再帰的な適用の前に、すべての書き込み元からのファイル作成をテストする

意図した所有権とACLを設定した使い捨てのテストディレクトリを作成します。各コンテナから、そのサービスに必要な操作だけを使って、一覧表示、読み取り、作成、名前変更、削除をテストしてください。その後、NASから新しいファイルの数値の所有者、グループ、モード、継承されたACLを確認します。

以前からあるファイルは使えるのに、新しく作成したファイルを別のサービスが使えない場合は、作成経路を修正してください。グループメンバーシップ、デフォルトACL、umask、またはアプリケーション固有のファイルモードを見直します。古いデータを再帰的に修復しても、同じ不一致が明日また発生するのを防ぐことはできません。

本番環境への展開は、すべての書き込み元が、次に必要となるサービスで特権なしに使えるファイルを作成できることを確認してからにしてください。UID/GIDの適切な設計を復元できるのは、マッピングが文書化され、同じ手順を繰り返せるからであり、すべてのコンテナがたまたま同じユーザーで実行されているからではありません。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.