Home Assistantのデータフォルダーで権限のずれを防ぐ方法

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

権限のずれは、Home Assistantのデータが残っていても、新たにマウントするプロセスから見た所有権、UID/GIDマッピング、アクセスモード、またはセキュリティコンテキストが、データを作成したプロセスのものと異なる場合に起こります。ホストの移行、復元、Dockerモードの変更、NASへのコピー、または手動でのchown/chmod操作後に発生することがよくあります。

変更前に想定するマウントと所有権のモデルを記録し、コピー時にメタデータを保持し、再作成後に読み取りと書き込みの両方をテストして、問題を防ぎましょう。すべての失敗に対してchmod -R 777で一律に対処しないでください。不一致が隠され、復旧時の安全性が損なわれます。

権限を変更する前にストレージの境界を記録する

まず、/configがDocker管理ボリューム、Linuxのバインドマウント、ネットワークマウント、またはVM内のパスのどれなのかを特定してください。適切な所有権の設定方法は、どのレイヤーが実際にファイルを所有しているかによって異なります。

Home Assistantの最新のコンテナインストールガイドでは、このストレージ要件が明確に示されています。選択したホストフォルダを読み書き可能な状態で/configにマウントします。フォルダ名だけに頼らず、正確なソースパス、マウント先、アクセスモードを記録してください。

Home Assistantが標準のDocker、rootless Docker、再マッピングされたユーザー名前空間、NASのコンテナ管理ツールのどれを通じて実行されているかも記録してください。コンテナ内外で認識される数値IDは同じとは限りません。

ファイルを移動しなくてもUIDとGIDのマッピングは変わることがある

ホスト上のフォルダのパスが変わらなくても、その下で有効なユーザーマッピングが変わることがあります。これは、Dockerをrootfulからrootlessに移行する場合、ユーザー名前空間の再マッピングを有効にする場合、またはローカルアカウントが異なるホストにデータを復元する場合によく起こります。

Dockerの最新のUID/GIDマッピングのドキュメントによると、rootlessモードとユーザー名前空間モードでは、コンテナ内のIDが異なるホストIDに変換されます。そのため、あるホストでは正しく所有されているように見えるファイルが、デプロイモデルの変更後に書き込み不可になることがあります。

アカウント名だけに頼らず、新しいホストでは異なる番号に対応付けられる場合があるため、ls -lnや同等のツールで数値の所有者を比較してください。

Home Assistantのデータをコピーする際にメタデータを保持する

移行ツールやGUIでのファイルコピーでは、ファイルの内容は保持されても、所有権、モードビット、ACL、拡張属性、セキュリティラベルが保持されない場合があります。その結果、YAMLは読み取り可能でも、データベース、隠しストレージ、証明書、または書き込みに必要なディレクトリーで後から問題が発生することがあります。

お使いのプラットフォームで実際に使用するメタデータを保持できる方法でコピーしてください。転送後、Home Assistantを起動する前に、移行元と移行先から代表的なファイルとディレクトリーを比較します。

The ZimaSpace guide to treating accounts and permissions as repeatable household policy applies here: ownership should be deliberate infrastructure, not a sequence of one-off fixes.

Home Assistantが書き込みを必要とする場所だけ、マウントを書き込み可能にする

Home Assistantは、永続化された設定とデータベースを更新できる必要があります。マウントが誤って読み取り専用として再作成されると、起動や読み取りはできても、その後の書き込み、バックアップ、データベースのコミット、設定の変更に失敗することがあります。

ホストのバインドマウントパスは、読み書き可能または読み取り専用として公開できます。Dockerのファイル共有ガイドでは、実際のマウントモードによって、コンテナーがホストディレクトリーを変更できるかどうかが決まると説明されています。Composeファイルが意図どおりに適用されたと思い込まず、実行中のマウントを確認してください。

反対に、Home Assistantが1つの設定パスへのアクセスを必要とするからといって、無関係なホストディレクトリーを書き込み可能にしないでください。権限の境界は狭く保ちます。

復元または再作成のたびに権限受け入れテストを実施する

正常な起動で確認できるのは、ファイルシステムに関する要件の一部だけです。Home Assistantは既存のファイルを読み取れても、後でデータベースへの書き込み、バックアップの作成、レジストリーの更新、ダッシュボードの保存が必要になったときに失敗する場合があります。

  • 想定どおりの設定とインテグレーションが読み込まれることを確認します。
  • UIから影響の小さい変更を1つ行い、再起動後も保持されることを確認します。
  • Recorderが新しい状態変更を書き込むことを確認します。
  • インストール方式が対応している場合は、小規模なバックアップを作成します。
  • アクセス拒否、読み取り専用ファイルシステム、またはデータベース書き込みエラーがないか、ログを確認します。

テストに失敗した場合は、そのパスを所有する所有者、グループ、ACL、名前空間マッピング、またはマウントモードを修正します。文書化されたデプロイ手順で手動の緊急コマンドを使わずに正しいアクセス権を再現できれば、権限の不整合は解消されています。

サポートとヒント

続きを読む

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.