Debian 13 講座 / DNS・ポート・HTTPの障害を切り分ける

Debian 13サーバーに接続できない場合は、アドレスとルート、DNS(Domain Name System)による名前解決、待受ソケット、およびHTTP(Hypertext Transfer Protocol)の応答を個別に確認してください。ゲスト内で動作するリクエストは、ホストがNAT経由で到達できることを示すものではありません。HTTP 404はHTTPサーバーがリクエストに応答したことを意味するため、基本的な接続障害として扱うのではなく、要求されたパスと応答しているサーバーを確認してください。

テストされている接続パスを特定する

このチュートリアルでは、VirtualBoxのNAT(Network Address Translation:ネットワークアドレス変換)に接続された Debian 13 仮想マシンと Windows ホストを使用します。ゲストのアドレスは 10.0.2.15 で、ゲートウェイは 10.0.2.2 です。これは単一の NAT アダプター構成の場合です。以下のクエリ結果で実際の環境のアドレスを確認し、例のアドレスを他のネットワークに適用しないでください。

ip -br address
ip route
ip route get 10.0.2.2
getent ahostsv4 deb.debian.org
sudo ss -lntp

ip route get は、指定された宛先に送信する際にカーネルが選択するルート、インターフェース、および送信元アドレスを確認します。これは、パケットが実際に宛先に到達したことを確認するコマンドではありません。getent はシステムの名前解決設定を使用し、解決されたCDN(Content Delivery Network:コンテンツ配信ネットワーク)のアドレスは時間によって異なる場合があります。ss の -l はリスニングを指し、-n は数値アドレスとポートを指し、-t はTCPを指し、-p はプロセス情報を指します。

テスト結果 最初に確認するターゲット
名前をアドレスに解決できません 名前のタイプミス、DNSおよびシステムの名前解決設定
宛先へのルートがありません インターフェイスアドレス、接続ルート、およびデフォルトゲートウェイ
ゲスト内でのみ成功 待受アドレス、ポート転送先、ファイアウォール
HTTP 404 レスポンス URL パス、ファイルの場所、仮想ホスト、およびアプリケーションルーティング
接続タイムアウト 宛先、ポート、パス、フィルタリングを再確認してください。この結果だけでは原因を判断できません。

ホストの 127.0.0.1 とゲストの 127.0.0.1 は、それぞれ別のコンピュータのループバックアドレスです。NATゲストが通常のホスト接続を受信できるようにするには、ポートフォワーディングのような経路が必要です。既存のSSH転送ルールを保持しながら、HTTP演習用の個別ルールを追加します。管理ツールの決定は ネットワークとDNSの管理元の確認 の条件に従い、アドレスの変更は 固定IPv4・DNS設定とDHCP復元 に従います。

テストファイルおよびループバックのみのサーバーを準備する

2つのDebianターミナルとホストのPowerShellを用意してください。PythonのHTTPサーバーは接続確認のためだけに使用し、本番用のウェブサーバーとしては使用しません。既存のサービスがポート8080を使用している場合は停止せず、未使用の練習用ポートを選び、その後のすべてのコマンドや転送ルールで一貫して使用してください。

sudo ss -lntp 'sport = :8080'
sudo apt update
sudo apt install --no-install-recommends python3 curl
python3 --version
curl --version

もしssがヘッダー以外にリスニングの行を表示していなければ、その時点でそのポートにTCPリスナーは登録されていません。インストールの実行を承認する前に、APTが表示する依存関係とパッケージの変更内容を確認してください。ラボのゲストはPython 3.13.5とcurl 8.14.1を使用しました。Debianのセキュリティ更新によってそれらのパッケージのバージョンが変わることがあります。

通常ユーザ端末Aで以下を実行します。mkdir は同名のフォルダが存在する場合に失敗するように書かれています。既存のフォルダを上書きせず、まずその内容を確認してください。

mkdir "$HOME/lf-net-demo" &&
printf 'debian-network-lab\n' > "$HOME/lf-net-demo/probe.txt" &&
python3 -m http.server 8080 --bind 127.0.0.1 --directory "$HOME/lf-net-demo"

フォルダ作成に失敗した場合、サーバーコマンドを実行しないでください。正常に起動した場合、端末Aはサーバー稼働状態のままになります。ドキュメントルートは専用フォルダに制限されているため、ホームディレクトリ全体は提供されません。ポート8080は通常ユーザがバインドできるポートのため、sudo を実行してサーバーを起動する必要はありません。

ゲスト端末Bで以下を実行します。サーバーが起動メッセージを出力した後にリクエストを行ってください。

sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8080/probe.txt
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:8081/probe.txt

最初のリクエストは debian-network-lab を出力します。ssのローカルアドレスは127.0.0.1:8080です。8081 に他にサービスがなければ、2 番目のリクエストは接続に失敗します。この実習ではcurlの終了コード7が観測されました。この比較は、実行中のサービスのポートの重要性を示しており、失敗すると予想されるポート上のサービスが存在する場合もあるため、クエリ結果を優先してください。

--noproxy '*' は、このリクエストをプロキシ環境変数をバイパスできるようにします。--connect-timeout は接続ステップでの制限であり、--max-time は全体の動作時間の制限です。このオプションによるプロキシ回避は今回のリクエストに限られます。組織で必要なプロキシ設定をシステム全体から削除しないでください。

バインドアドレスのみを変更してホストアクセスを比較する

VirtualBox で、対象の VM の 設定 → ネットワーク → NAT アダプター → 詳細 → ポートフォワーディング を開きます。UI の場所はバージョンによって異なる場合があります。新しいルールのみを追加し、既存の SSH ルールはそのままにしてください。ホストポート 18080 が使用中の場合は、空いているポートを選択してください。

項目 設定
名前 / プロトコル lf-debian13-http15 / TCP
ホスト IP / ポート 127.0.0.1 / 18080
ゲスト IP / ポート 単一 NAT ゲストのデフォルトアドレスを使用する場合、IP は空欄のままにしてください / 8080

ゲストアドレスを指定する場合は、現在のゲストアドレスと一致する必要があります。この演習ではデフォルトのNATアドレス 10.0.2.15 を使用しており、アドレスを変更したVMは転送先を再確認する必要があります。ホストIPをループバックに制限すると、LAN上の他のコンピュータが練習用サーバーにアクセスすることを防げます。詳細な操作については、VirtualBox NATおよびポートフォワーディングのドキュメント を参照してください。

これをホストPowerShellで実行します。curl.exe はWindows PowerShellエイリアスと区別するために指定されています。

curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://127.0.0.1:18080/probe.txt
$LASTEXITCODE

ゲスト内のリクエストは成功しましたが、ホスト側のリクエストは失敗しました。これはサーバーがゲストのループバックのみで待ち受けており、NAT転送されたトラフィックを受け取るゲストのNIC(Network Interface Card:ネットワーク接続装置)に割り当てられたアドレスでは待ち受けていなかったためです。ラボでは接続リセットとcurlの終了ステータス56が観測されました。仮想化の他のバージョンや接続状態では、異なるエラーやタイムアウトが発生する可能性がありますが、ステータス56と正確に一致させる必要はありません。

ゲストのターミナルAで、 Ctrl+C でサーバーを停止します。同じファイル、ポート、転送ルールを保持し、バインドアドレスだけを変更します。

python3 -m http.server 8080 --bind 0.0.0.0 --directory "$HOME/lf-net-demo"

サーバーの起動メッセージを確認した後、ゲストBから待受アドレスおよびNICアドレスへのリクエストをチェックします。

sudo ss -lntp 'sport = :8080'
curl --noproxy '*' --connect-timeout 3 --max-time 6 -sS http://10.0.2.15:8080/probe.txt

0.0.0.0:8080 はすべてのローカルIPv4アドレスで待ち受けることを意味します。IPv6の待受も自動的に有効になるわけではありません。ゲストNICアドレスへのリクエストが成功した後、ホストで同じcurl.exeコマンドを繰り返して、ファイルの内容と終了ステータス0を確認します。起動直後にリクエストがすぐに失敗する場合は、まずプロセスがまだ実行中で、待受ソケットが存在することを確認してください。

この比較は待受アドレスの影響を分離します。リクエストがまだ失敗する場合は、単にファイアウォールを無効にするのではなく、転送、ゲストアドレス、待受ソケット、フィルタリングルールを確認してください。ping の失敗だけでは、インターネット制御メッセージプロトコル(ICMP)のポリシーを反映している可能性があります。それはすべてのトランスミッション制御プロトコル(TCP)サービスが利用できないことを証明するものではありません。

HTTPステータスとcurl終了ステータスを区別する

サーバーはすべてのIPv4アドレスで実行されており、ホストのPowerShellは存在しないファイルをリクエストします。-wはレスポンスコードを出力し、-o NULはWindowsでボディを破棄します。

curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --fail -o NUL -w "%{http_code}\n" http://127.0.0.1:18080/missing.txt
$LASTEXITCODE

最初のリクエストのHTTPコードは404ですが、curlの終了コードは0です。デフォルトでは、curlはHTTPエラーステータス自体を通信失敗とは見なしません。2回目のリクエストは同じHTTP 404を受信し、--failのため終了コード22を返します。自動チェックでは、終了コードのみを見るか、HTTPステータスも判断するかは目的に応じて決定する必要があります。リダイレクション、認証、または実際のレスポンス内容の確認を必要とする運用チェックを単に200チェックだけで置き換えないでください。

この実習では、応答とPythonサーバーのログを照合することで、404でもHTTPの要求と応答が行われたと確認できます。URL パスとドキュメントルートを確認し、サーバーログの GET /missing.txt とステータス 404 を比較してください。実運用では、どのサーバーやプロキシが応答を返したかも確認してください。公式 curl マニュアル は HTTP 処理と転送終了コードを別々に文書化しています。

今回のリクエストだけ接続先を指定し、DNSを切り分ける

RFC 6761 の特殊用途名ルール は、解決されないことが期待される名前に .invalid を予約しています。サーバーと転送ルールを変更せず、以下のテストホスト名を Windows ホストからリクエストしてください。

curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE
curl.exe --noproxy "*" --connect-timeout 3 --max-time 6 -sS --resolve "lf-debian13-net15.invalid:18080:127.0.0.1" http://lf-debian13-net15.invalid:18080/probe.txt
$LASTEXITCODE

一般的なクエリパスでは、最初のリクエストは名前の検索に失敗し、終了コード6を返します。2回目のリクエストでは、そのホスト名とポートのアドレスを今回のcurl実行のためだけに指定するので、ファイルを受信し、終了コード0を返します。--resolveはDNSサーバやhostsファイルを変更せず、URLのホスト名を保持します。HTTPS(TLSで保護するHTTP)では、URLホスト名の証明書検証が依然として必要ですので、このオプションを証明書検証をスキップするものと混同しないでください。

もし2回目のリクエストだけが成功する場合、それは指定されたアドレスへの送信経路が機能していることを示しており、元の名前解決経路をさらに調査する根拠となります。実際のサービスで正しいIPかどうかを確認せずに任意のアドレスを指定すると、別のサーバーをチェックすることになる可能性があります。また、特定のプログラムのプロキシ、キャッシュ、または名前解決方法がシステムgetentの結果と同じであると仮定してはいけません。

実習用の設定を片付け、診断結果を記録する

  1. ゲスト端末Aで、Ctrl+Cを使ってHTTPサーバーを停止します。
  2. VirtualBoxのポートフォワーディングテーブルで、今回作成したlf-debian13-http15のルールのみを削除します。SSHルールは残してください。
  3. ゲスト上で、リスニング状態と以下のファイルを確認し、今回作成されたファイルと空のフォルダのみを削除してください。
sudo ss -lntp 'sport = :8080'
cat "$HOME/lf-net-demo/probe.txt"
rm -- "$HOME/lf-net-demo/probe.txt"
rmdir -- "$HOME/lf-net-demo"

サーバーのリスニング行は消えるはずであり、ホストのテスト用HTTPリクエストも成功しなくなるはずです。rmdir が失敗した場合は、フォルダ内に他のファイルがないか確認し、強制的に再帰削除しないでください。インストールされたcurlやPythonは他の管理作業に使用できるため、必要性を確認せずに一括削除は行わないでください。

問題を記録する際には、検査する場所(ホスト/ゲスト)、リクエストURL、実際の宛先アドレスとポート、待ち受けアドレス、curlの終了コード、およびHTTPコードを含めると便利です。アドレスと経路の確認方法はDebian 13 ip-routeドキュメント で確認でき、待ち受けソケットはssドキュメント で、テストサーバーのオプションはPython 3.13 http.serverドキュメント で確認できます。