DNSがImmichの接続障害の原因かどうかをテストする方法

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

問題が発生しているクライアントが、Immichの正確なホスト名を、サービスを提供すべきアドレスに解決できない場合、またはリゾルバー、ネットワーク、時間によって応答が変わる場合に限り、DNSがImmichの問題の原因である可能性が高いといえます。

名前解決とアプリケーションへの到達性を分けてテストしてください。IPレベルで接続に成功すれば、経路とポートが存在することはわかりますが、ホスト名なしでHTTPS、リバースプロキシのルーティング、証明書、ホストベースのルールが機能するとは限りません。安全な手順は、問題が起きている正確なホスト名を記録し、影響を受けているクライアントから問い合わせ、リゾルバーを比較したうえで、DNSレイヤーの変更を一つ行ってから、元のImmich操作を再試行することです。

ホスト名と障害が起きる経路を正確に特定する

問題が発生しているImmichクライアントが実際に使用しているホスト名、接続しているネットワーク、障害の発生時刻、影響がウェブアプリ、モバイルアプリ、またはその両方のどれに及ぶかを記録してください。無関係な公開ドメインの名前解決など、一般的なテストから始めないでください。それでは、何らかのDNS経路が機能していることしか確認できません。

同じホスト名を、正常に動作するクライアントと問題が発生しているクライアントの両方から確認します。すべてのAおよびAAAAレコードの応答、応答したリゾルバー、クライアントがホームネットワーク内、モバイルデータ通信中、VPN経由のいずれかを記録してください。スプリットDNSによって応答が異なるのは意図的な場合もありますが、どのクライアントも到達可能なエンドポイントに接続できる必要があります。

対照テストとして、通常のDNSルックアップに頼らず、想定されるサーバーアドレスとポートに到達できるかを確認します。これはネットワーク経路を切り分けるためだけのテストとして扱ってください。サービスが正常でも、HTTPS証明書、SNI、リバースプロキシ、仮想ホストによって、IPアドレス宛てのリクエストが拒否される場合があります。

サーバーだけでなく、問題が発生しているクライアントからDNSを問い合わせる

実際に問題が発生しているデバイスまたは環境でDNSクエリを実行してください。ImmichクライアントがVPN、プライベートDNSプロファイル、コンテナのスタブリゾルバー、またはルーター提供のリゾルバーを経由している場合、サーバー本体からのクエリでは異なるリゾルバー経路が使われ、問題が隠れることがあります。

まず、クライアントのデフォルトリゾルバーを使って問題のホスト名を問い合わせ、次に比較用の既知のリゾルバーまたは指定された内部リゾルバーを明示して問い合わせます。digで対象を指定したクエリを実行すると、返された応答、応答したサーバー、ステータス、クエリ時間を確認でき、問題が特定のリゾルバーに起因するかどうかがわかります。

一度の成功を鵜呑みにせず、クエリを数回繰り返してください。NXDOMAIN、SERVFAIL、タイムアウト、古いアドレス、A/AAAAレコードの不一致を記録します。正しい応答が安定して返るなら、基本的なDNS名前解決ではなく、ルーティング、プロキシ、TLS、ファイアウォール、またはアプリケーションの設定に原因がある可能性が高くなります。

リゾルバーの結果とエラーの種類を比較する

設定を変更する前に、応答コードを確認してください。NXDOMAINは、問い合わせた名前がそのリゾルバーから見て存在しないことを意味します。SERVFAILは名前解決を完了できなかったことを意味し、タイムアウトはリゾルバーが時間内に応答しなかったことを意味します。構文上は成功した応答でも、古いルーターアドレスや到達不能なエンドポイントを指していれば誤りです。

ホスト名が見つからないエラーと、一時的なリゾルバー障害は別の原因です。名前解決エラーの違いを参考に、レコードの欠落、到達不能なリゾルバー、不安定なDNS経路のどれを修正すべきか判断し、すべての名前解決の失敗を同じ問題として扱わないようにします。

自宅のリゾルバーだけが古いアドレスや誤ったアドレスを返し、別のリゾルバーが想定される公開アドレスを返す場合は、ローカル上書き、スプリットDNSレコード、DHCPから配布されたDNS設定、フィルタリングサービス、キャッシュを確認します。すべてのリゾルバーが同じ正しいアドレスを返す場合は、DNSの変更をやめ、サービスへの経路の確認に進みます。

管理されたバイパスでDNSの影響を確認する

失敗するクライアントの名前解決だけを変更する、一時的で元に戻せる設定を1つ作成します。たとえば、別のリゾルバーに直接問い合わせるか、一時的なhostsファイルエントリを使って、正確なImmichホスト名を既知の想定エンドポイントに対応付けます。テスト後すぐに元に戻せるよう、元の設定を保持してください。

ホスト名が変わらず、名前解決の経路だけを変更した状態で元のImmichのワークフローが動作し始めた場合は、DNSが原因である可能性が高いといえます。同じホスト名が検証済みのエンドポイントに解決されても失敗する場合、障害はDNSより下流にあります。プロキシのルーティング、証明書、NAT、ファイアウォールルール、またはImmichサービス自体を確認してください。

1回のクエリで家庭内の障害発生時間帯を再現できない場合は、ホスト、コンテナ、ローカルリゾルバー、上流リゾルバー、DHCP、VPN、キャッシュの状態を時間を追って比較します。複数層にわたるDNS障害チェックを行うと、1回限りのテスト中に消えてしまう断続的な問題を見つけやすくなります。

適切なキャッシュをクリアして、元のImmichのワークフローを再テストする

DNSレコード、リゾルバー、DHCPオプション、スプリットDNSルール、またはローカル上書きを修正した後は、可能であれば関連するクライアントまたはリゾルバーのキャッシュだけをクリアします。何が変わったかを記録せずに、すべての層のキャッシュを何度も消去しないでください。一時的な成功の原因を説明できなくなるおそれがあります。

影響を受けているクライアントからホスト名を再度解決し、想定されるA/AAAAレコードの応答、リゾルバー、応答時間を確認します。次に、通常のホスト名でImmichを開き、古いアセットを読み込み、検索を行い、安全なアップロードなどの書き込み操作を1回実行して、ログインページ以外もテストします。

以前失敗したときと同じネットワーク状態で、確認を繰り返します。たとえば、モバイルデータ通信、自宅のWi-Fi、VPN接続中のWi-Fi、またはルーターやDHCPを更新した後です。問題の引き金となった状況でも通常のホスト名が正しく保たれる場合に限り、DNSを根本原因から除外できます。そうでなければ、新たに得られた証拠を保持し、次のネットワーク層の確認に進みます。

サポートとヒント

続きを読む

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.