Dockerのトラブルシューティング
このページでは、Unraid上のDockerコンテナに関するトラブルシューティングのガイダンスを、Unraidチームが管理する内容に限定して提供します。高度なトラブルシューティング、詳細な技術情報、またはUnraid固有の実装を超えるトピックについては、公式Dockerドキュメントを参照してください。
Dockerを使用すると、Unraidサーバー上でさまざまなアプリケーションを簡単に実行できますが、コンテナが起動しない、Dockerイメージファイルが破損する、ネットワークに問題が発生するなどの不具合が起こることがあります。このページでは、Unraid上のDockerに関連する一般的な問題を取り上げ、効果的に解決するためのベストプラクティスを紹介します。
Dockerイメージファイルを再作成する
破損したDockerイメージファイル（docker.img）はよくある問題で、原因としてはcache poolの空き容量不足や不適切なシャットダウンが挙げられます。幸い、適切に設定されたコンテナでは、可変データはすべてイメージファイルの外部（通常はappdata共有）に保存されるため、アプリケーションの設定やデータを失うことなく、イメージを安全に再作成できます。
Dockerイメージファイルを再作成するには:
- WebGUIの設定 → Dockerに移動します。
- Dockerを有効にするをいいえに設定し、適用をクリックしてDockerサービスを停止します。
- Docker vdiskファイルを削除するオプションを選択し、適用をクリックします。必要に応じて、ファイルを手動で削除することもできます。
- 新しいDocker vdiskファイルの場所とファイル名を確認します。この設定には、フォルダーのパスとファイル名の両方が含まれます。
- 新しいイメージファイルの希望サイズを設定します。通常、既定のサイズでほとんどのユーザーには十分です。
- Dockerを有効にするをはいに設定し、適用をクリックします。UnraidがBTRFSを使用して新しい
docker.imgファイルを作成し、フォーマットします。
これで、保存済みの設定を使ってコンテナを再インストールする準備が整いました。
Dockerアプリケーションを再インストールする
Unraid は、インストールされている各コンテナのテンプレートをブートデバイスに自動的に保存します。これらのテンプレートには設定が保存されるため、Docker イメージファイルを再作成した後でもコンテナを簡単に復元できます。
コンテナを再インストールするには:
- WebGUI の Apps タブに移動します。
- Previous Appsセクションを開きます。
- 再インストールしたいコンテナを選択します。
- インストールを続行します。Unraidが各コンテナを再ダウンロードし、以前の設定を自動的に適用します。
この手順により、可変データがDockerイメージファイルの外部（たとえばappdata共有）にマッピングされている限り、コンテナは以前の状態に復元されます。
再インストール後にコンテナが起動しない場合は、Dockerタブのコンテキストメニューからログを確認し、エラーメッセージやトラブルシューティングの手がかりを探してください。
コンテナを復元した後は、すべてのマッピングされたホストパスが存在し、正しい権限を持っていることを確認してください。誤ったマッピングや権限の問題は、起動失敗の一般的な原因です。
Dockerカスタムネットワークを復元する
カスタムDockerネットワークは、Dockerイメージファイルを削除すると保持されません。イメージを削除する前に、ターミナルを開いて次のコマンドを実行し、カスタムネットワーク名を記録してください:
docker network ls
作成したネットワークの名前を控えます（既定のbridge、host、noneネットワークは除きます）。
カスタムネットワークを復元するには:
-
Dockerイメージファイルを再作成した後、次のコマンドを使用して各カスタムネットワークを再作成します:
docker network create <network-name><network-name>を、前に記録した正確な名前に置き換えてください。 -
必要に応じて、復元したネットワークを使用するようにコンテナを更新します。
環境で必要な場合は、設定 → Dockerでカスタムネットワークへのホストアクセスを有効に設定すると、ホストからカスタムネットワークへのアクセスを有効にできます。
復元後にコンテナが期待どおりに通信できない場合は、Dockerのネットワーク設定を確認し、競合や接続の問題がないか調べてください。