Debian 13 講座 / Nginxサイトを設定し、403と404を診断する

Debian 13 では、Nginx のサイト設定は sites-available に保存でき、sites-enabled にあるシンボリックリンクを通じて有効化できます。設定を確認した後、reload で適用し、ポート、Host 値、ファイルの権限、および実際の HTTP レスポンスを個別に検証してください。このチュートリアルでは、デフォルトサイトを維持しながら 127.0.0.1:8080 に静的サイトを追加し、200、403、404 レスポンスの原因を比較します。

静的サイト実習の範囲と既存の待受を確認する

Nginxは、HTTP(Hypertext Transfer Protocol)の要求を受け取り、ファイルを提供するか、リクエストを他のアプリケーションに渡すウェブサーバーです。ここでは、HTMLファイルを直接提供する静的サイトのみを構成します。Debian 13のsudo権限を持つ通常ユーザーとcurlが必要であり、すべてのHTTPチェックはDebian VM内で実行する必要があります。例ではゲストのループバック上のみで待ち受けます。ホストPCからのアクセスには、待ち受けアドレスと転送のための別の計画が必要です。このラボではすべてのリクエストをVM内にとどめます。

パッケージのインストール中に、デフォルトのサイトが起動する場合があります。実際の本番サーバーでは、まずポート80および443で既存のWebサーバーとの競合を確認し、メンテナンス手順を確立してください。127.0.0.1:8080が未使用であることも確認してください。必要なアドレスとポートを他のサービスが使用している場合は、このセットアップを停止し、そのサービスを止めるのではなく競合の原因を特定してください。

ss -ltn
dpkg-query -W nginx nginx-common 2>/dev/null
apt-cache policy nginx

インストールされていないパッケージに対してdpkg-queryを実行すると、非ゼロのステータスが返される場合があります。それだけではシステムエラーではありません。練習用VMでは、Nginxはインストールされておらず、ポート22でのみSSHが開いていました。Debianリポジトリから次のようにインストールされました。

sudo apt update
sudo apt install nginx curl
nginx -v
systemctl is-active nginx
systemctl is-enabled nginx
sudo nginx -t

このVMにインストールされているnginxおよびnginx-commonのバージョンは1.26.3-3+deb13u10であり、サービスはアクティブかつ有効になっていました。パッケージのリビジョン番号は展開時期やセキュリティアップデートによって異なる場合があります。サービスが起動しない場合は、systemctl status nginx --no-pagerおよびsudo journalctl -u nginx -n 50 --no-pagerなどでバインディング失敗などの実際の原因を確認してください。

Debianのインクルードパスを確認し、元のファイルをバックアップする

sites-availableディレクトリは設定ファイルが格納される場所であり、その中のすべてのファイルが自動的に適用されるわけではありません。演習パッケージでは、/etc/nginx/nginx.confがhttpコンテキスト内で/etc/nginx/conf.d/*.confと/etc/nginx/sites-enabled/*を含んでいました。このルールを直接確認した後に進めてください。

grep -nE 'user |include .*(conf.d|sites-enabled)' /etc/nginx/nginx.conf
ls -l /etc/nginx/sites-enabled
sudo nginx -T | less

nginx -T は、すべてのインクルードされた設定をチェックとともに出力します。認証情報や内部アドレスが含まれる場合があるため、出力をそのまま外部へ公開しないでください。less では、q で終了します。この VM では、ワーカー・ユーザーは www-data であり、デフォルトサイトリンクは維持されていました。

以下は、演習用パスが存在しないことを確認し、元の状態を保持するための準備ブロックです。同じ Bash ターミナルで実行してください。パスが既に存在する場合は、削除や上書きをせずに停止してください。読者が準備する運用設定のバックアップには、すべての関連インクルードファイルや証明書も含める必要があります。

set -euo pipefail
for p in /srv/lf-web25 /etc/nginx/sites-available/lf-web25 /etc/nginx/sites-enabled/lf-web25 /var/backups/lf-debian13-25; do
    if test -e "$p" || test -L "$p"; then
        echo "Path already exists: $p" >&2
        exit 1
    fi
done
sudo install -d -m 700 /var/backups/lf-debian13-25
sudo cp -a /etc/nginx/nginx.conf /etc/nginx/sites-available/default /var/backups/lf-debian13-25/
sudo sha256sum /etc/nginx/nginx.conf /etc/nginx/sites-available/default | sudo tee /var/backups/lf-debian13-25/original.sha256

静的ファイルと仮想ホスト設定全体を作成する

練習用サイトのファイルは /srv/lf-web25/public に配置されています。管理者がファイルを所有しており、要求を処理するNginxのワーカープロセスは、それを読み取る権限だけを持ちます。ディレクトリにはパスをたどるための実行権限が必要であり、ファイルには読み取り権限が必要です。この例は公開静的ファイルのみを対象としており、パスワードや個人資料はこのパスに置かれません。

sudo install -d -m 755 /srv/lf-web25/public /srv/lf-web25/public/empty
printf '%s
' '<!doctype html><html lang="en"><meta charset="utf-8"><title>Lab 25</title><h1>LF WEB 25</h1></html>' | sudo tee /srv/lf-web25/public/index.html
sudo chmod 644 /srv/lf-web25/public/index.html

次のブロック全体を設定ファイルに書き込みます。引用されたヒアドキュメントの終端子 CONF は、$uri をシェル変数ではなく Nginx 変数として保持します。シェルラッパーは Bash ブロックであり、CONF マーカー間の内容が完全な Nginx 設定です。

sudo tee /etc/nginx/sites-available/lf-web25 > /dev/null <<'CONF'
server {
    listen 127.0.0.1:8080 default_server;
    server_name _;
    return 404;
}
server {
    listen 127.0.0.1:8080;
    server_name lab25.test;
    root /srv/lf-web25/public;
    index index.html;
    access_log /var/log/nginx/lf-web25-access.log;
    error_log /var/log/nginx/lf-web25-error.log;
    location / {
        try_files $uri $uri/ =404;
    }
}
CONF
設定 この練習の役割
listen 127.0.0.1:8080 VM自身のループバックからの接続のみを受け入れます。インターネットから直接アクセスすることはできません。
default_server そのアドレスとポートで名前が一致しないリクエストのデフォルトサーバーを指定します。
server_name lab25.test ホストが一致するリクエストを実際のサイトに送信します。DNSレコードは作成しません。
root / index 要求されたURI(Uniform Resource Identifier)に対応するファイルパスとディレクトリのデフォルトファイルを設定します。
try_files $uri $uri/ =404 ファイルまたはディレクトリをチェックして、存在しない場合は404を返します。

server_name _ 自体は、すべての名前をキャッチする特別なワイルドカードではありません。ここで default_server がデフォルトの選択を決定します。同じアドレスとポートでこれを複製するとエラーが発生する可能性があるため、既存の設定を確認してください。Nginx のリクエスト処理に関するドキュメント では、まずアドレスとポートを選択し、その後 Host 名とデフォルトサーバを決定する順序が説明されています。

有効化用のシンボリックリンクを作成し、設定検査を通してから適用します。専用の Bash セッションで続行します。以下の && チェーンは nginx -t が成功した場合のみ reload を実行します。チェックが失敗した場合は、先に修正する必要があります。

sudo ln -s /etc/nginx/sites-available/lf-web25 /etc/nginx/sites-enabled/lf-web25
sudo nginx -t && sudo systemctl reload nginx
systemctl is-active nginx
ss -ltn | grep '127.0.0.1:8080'

Reloadは設定を再読み込みさせますが、設定ファイル自体を保存する行為は実行中のプロセスには適用されません。チェックに合格しても、ワーカーの実際のファイル読み取り権限や希望するHostの応答を保証するものではないため、HTTP検証は続行されます。nginx -t および -T オプションの適用範囲は、Debian nginx コマンドのドキュメント で確認できます。

Hostによるサイト選択とHTTP応答・DNSを比較する

以下のコマンドは、--noproxy を使用してプロキシ環境変数の影響を除外します。最初のリクエストは実際のサイトへのもので、2つ目は名前が一致しないデフォルトサーバへのもので、3つ目は存在しないファイルへのもので、4つ目はインデックスのないディレクトリへのものです。

curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/
curl --noproxy '*' -i -H 'Host: other.test' http://127.0.0.1:8080/
curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/missing
curl --noproxy '*' -i -H 'Host: lab25.test' http://127.0.0.1:8080/empty/
リクエスト 確認済みの結果 解釈
lab25.test / 200、LF WEB 25 希望のサイトと静的ファイルを選択しました。
other.test / 404 これはデフォルトサーバーの明示的な戻り値です。
lab25.test /missing 404 一致するサイトで対象ファイルが見つかりませんでした。
lab25.test /empty/ 403 ディレクトリはありますが、インデックスがなく、ディレクトリの一覧表示は許可されていません。

デフォルトでは、curlはHTTP 404の受信をプロセスの失敗として扱いません。自動チェックの場合は、-fを使用してHTTPエラー応答で失敗を返すか、-wでステータスを表示して明示的に比較してください。-wだけでステータスを表示しても、HTTPエラーがcurlの終了ステータスを失敗にすることはありません。URLにサイト名を書きつつ、パブリックDNSを変更せずにリクエストするには、次のコマンドを使用します。--resolveは、このcurlリクエストのみに名前、ポート、アドレスのマッピングを提供します。

curl --noproxy '*' -fsS --resolve lab25.test:8080:127.0.0.1 http://lab25.test:8080/

コマンドが成功しても、lab25.testはインターネットのDNSに登録されていません。外部サービスを公開するには、実際のドメイン、サーバへのパス、適切なリッスンアドレス、ファイアウォール、およびHTTPSが別々に必要です。この演習に従うだけでは、外部でポート8080を開く必要はありません。

ファイル権限の失敗をエラーログに照合する

同じ403エラーが出ても、原因は異なる場合があります。以下は、この演習で作成したルート所有のファイルを1つだけ600に変更してワーカーの読み取り権限を削除し、その後リクエストを行った場合の比較です。運用ファイルには適用しないでください。HTTPステータスを確認し、直ちに644に戻してください。

sudo chmod 600 /srv/lf-web25/public/index.html
curl --noproxy '*' -sS -o /dev/null -w '%{http_code}
' -H 'Host: lab25.test' http://127.0.0.1:8080/
namei -l /srv/lf-web25/public/index.html
sudo tail -n 10 /var/log/nginx/lf-web25-error.log
sudo chmod 644 /srv/lf-web25/public/index.html
curl --noproxy '*' -fsS -H 'Host: lab25.test' http://127.0.0.1:8080/

実際の結果は、600に設定した場合はPermission deniedで403、復元後は200でした。先の/empty/要求ではdirectory index is forbiddenと記録されており、同じ403でも原因を区別できました。nameiは中間ディレクトリまでの権限を表示します。親ディレクトリでパスをたどるためのディレクトリ実行権限がない場合、最終的なファイルが644であっても読み取ることはできません。

chmod -R 777 で解決しないでください。必要に応じて、パス、所有者、ワーカーアカウント、ACL(Access Control List:アクセス制御リスト)、AppArmor の拒否ログを確認し、必要な権限のみを付与してください。たとえ root で Nginx の設定チェックが成功しても、www-data ワーカーが読み取れることとは同じではありません。アクセスログはリクエストとステータスを確認するために使用され、エラーログは拒否の理由を絞り込むために使用されます。

サイト設定を復元し、実習用のファイルを片付ける

設定を変更する前に、このサイトの正常なバージョンの別コピーを作成してください。検証プロセス中、不明なディレクティブを含む設定が nginx -t によって拒否される場合でも、再読み込みされていない既存のワーカーは引き続き 200 を返していました。失敗したファイルを正常なバージョンに戻して再度確認してください。読者は、コピー、確認、正常なバージョンの適用を行い、運用設定でエラーを作らない習慣を身につけるべきです。

sudo cp -a /etc/nginx/sites-available/lf-web25 /var/backups/lf-debian13-25/good-site
sudo nginx -t && sudo systemctl reload nginx
curl --noproxy '*' -fsS -H 'Host: lab25.test' http://127.0.0.1:8080/

このラボファイルを復元するには、sudo diff -u /var/backups/lf-debian13-25/good-site /etc/nginx/sites-available/lf-web25 と比較してください。保存されたファイルが意図したバージョンであれば、sudo cp -a /var/backups/lf-debian13-25/good-site /etc/nginx/sites-available/lf-web25 で復元してください。上記のnginx -t成功時にだけreloadするコマンドを実行し、Hostヘッダーを指定したHTTP要求を繰り返します。コピーする前に、意図された新しい編集内容を保持してください。

変更したサイトに問題がある場合は、直前に保存した正常なバージョンと現在のファイルを比較し、そのサイト用のファイルのみを復元してください。共通設定を安易に上書きしないでください。リロード時のワーカー置き換えの挙動や障害発生時の取り扱いについては、Nginx構成リロードガイド で確認できます。

実習を終了するには、まずリンクを削除し、チェックとリロードを行って8080で専用サーバーをシャットダウンしてください。デフォルトサイトやNginx全体のサービスを停止しないでください。以下の手順を実行する前にログを保持したい場合は、専用ログ2つをバックアップフォルダにコピーしてください。

sudo cp -a /var/log/nginx/lf-web25-access.log /var/log/nginx/lf-web25-error.log /var/backups/lf-debian13-25/
sudo rm -- /etc/nginx/sites-enabled/lf-web25
sudo nginx -t && sudo systemctl reload nginx
ss -ltn
sudo sha256sum -c /var/backups/lf-debian13-25/original.sha256

リロード直後は、既存のワーカーがリクエストを完了する時間を少し取ってから、再度確認してください。127.0.0.1:8080のリスナーが消えていて、元のハッシュが問題ないことを確認した後、専用ファイルのみをクリーンアップします。本番環境では、使用中のワーカーが専用ログにアクセスしていないことも確認してください。

sudo rm -- /etc/nginx/sites-available/lf-web25 /srv/lf-web25/public/index.html
sudo rmdir /srv/lf-web25/public/empty /srv/lf-web25/public /srv/lf-web25
sudo rm -- /var/log/nginx/lf-web25-access.log /var/log/nginx/lf-web25-error.log
systemctl is-active nginx

最終確認では、専用リスナーとファイルは削除され、nginx.confとデフォルトサイトのハッシュは維持され、Nginx自体は稼働していました。インストール済みのパッケージは保持されました。パッケージの削除は、他のサイトでの使用状況や今後の使用を確認した上で、別途決定されます。