NagiLog

小さく作って、試して、学んだ記録。

Articles

🐇 nginx + サブドメイン公開 チートシート

🐇 nginx + サブドメイン公開 チートシート 目的 blog.example.com のようなサブドメインへのアクセスをVPSへ向け、 nginxで受け取ってWebアプリへ渡し、HTTPSで公開する。 🌐 全体の流れ ブラウザ │ │ https://blog.example.com ▼ DNS │ 「このドメインは、このVPSだよ」 ▼ VPS │ ▼ nginx │ 「blog.example.com 宛てだね」 ▼ proxy_pass │ 「このアプリへ渡すよ」 ▼ Webアプリ ① DNS:サブドメインをVPSへ向ける ドメイン管理側で、サブドメインを VPSのIPアドレス に向ける。 例 blog.example.com ↓ xxx.xxx.xxx.xxx Aレコードならイメージはこんな感じ。 名前:blog 種類:A 値 :VPSのIPアドレス 🐇 覚え方 DNS = 住所案内 「blog.example.com に行きたい!」 ↓ 「その住所なら、このVPSですよ」 ② nginx:サブドメインの受付を作る nginxの設定に server_name を書く。 server { listen 80; server_name blog.example.com; location / { proxy_pass http://127.0.0.1:8000; } } server_name server_name blog.example.com; このドメイン宛てのアクセスを、この設定で受け取る。 proxy_pass proxy_pass http://127.0.0.1:8000; nginxが受け取ったリクエストを、内部で動いているWebアプリへ渡す。 🐇 イメージ blog.example.com ↓ nginx ↓ 127.0.0.1:8000 ↓ Webアプリ ③ nginx設定を有効化する Ubuntu系でよく使われる構成: /etc/nginx/sites-available/ に設定ファイルを置く。 そして、 /etc/nginx/sites-enabled/ から使えるようにする。 シンボリックリンクを作成 sudo ln -s /etc/nginx/sites-available/blog \ /etc/nginx/sites-enabled/blog 🐇 覚え方 sites-available → 設定ファイル置き場 sites-enabled → 実際に使う設定 ln -s はコピーではなく、 「この設定を使います!」というリンクを作る イメージ。 ④ nginxの構文チェック 設定を書いたら、いきなり反映しない。 まずチェック。 sudo nginx -t 成功すると、おおむね以下のような結果になる。 syntax is ok test is successful ⚠️ ここでエラーが出たら反映せず、設定を修正する。 🐇 sudo nginx -t ↓ GREEN? ↙ ↘ YES NO ↓ ↓ 反映 修正 ⑤ nginxへ設定を反映 構文チェックが通ったら、 sudo systemctl reload nginx nginxに新しい設定を読み直してもらう。 🐇 覚え方 nginx -t 「この設定、大丈夫?」 reload nginx 「じゃあこの設定使って!」 ⑥ HTTPS化 Certbot + Let's Encrypt を使う場合。 代表的な例: sudo certbot --nginx -d blog.example.com 役割 Let's Encrypt → TLS証明書を発行する。 Certbot → 証明書の取得・設定・更新などを助けてくれる。 結果: http://blog.example.com ↓ https://blog.example.com 🧠 ここだけ覚える 項目 役割 DNS サブドメインをVPSへ向ける nginx / server_name どのドメイン宛ての通信を受けるか決める proxy_pass 受け取った通信をWebアプリへ渡す nginx -t nginx設定の構文チェック systemctl reload nginx nginxへ設定を反映 Certbot / Let's Encrypt HTTPS化 🐇 最短ルート ① DNS ↓ サブドメイン → VPS ② nginx ↓ server_name を設定 ③ 有効化 ↓ sites-available → sites-enabled ④ チェック ↓ sudo nginx -t ⑤ 反映 ↓ sudo systemctl reload nginx ⑥ HTTPS ↓ Certbot / Let's Encrypt ⚠️ 今回のNagiLogでは、なぜあんなに大変だった? このチートシートは、 「nginx + サブドメイン公開」 だけを抜き出した基本ルート。 NagiLogでは、これだけではなく、 Djangoアプリをまっさらな本番Linux環境へ持っていき、 実行環境を整え、Webサーバーへ接続し、HTTPSで公開する ところまで行った。 そのため、実際には以下も登場した。 Python ↓ venv ↓ pip / requirements.txt ↓ PostgreSQL ↓ Django ↓ Gunicorn ↓ systemd ↓ nginx ↓ DNS ↓ Certbot / HTTPS さらに途中で、 Pythonのバージョン調整 pip・依存パッケージの調整 Linuxのファイル・ディレクトリ権限 PostgreSQLの設定 Djangoの本番設定 Gunicornの起動 systemdによる常駐化 なども必要になった。 💡 つまり サブドメイン公開そのものが巨大だったわけではない。 ❌ サブドメインを切るだけで大量の作業が必要だった ⭕ Djangoアプリの本番環境をゼロから構築したため、 大量の作業が必要だった 📌 別チートシートへ 次に整理するもの: 「Django 本番デプロイ正式ルート」 Python → venv → pip → PostgreSQL → Django → Gunicorn → systemd → nginx → DNS → HTTPS それぞれ、 「何をする?」 「なぜ必要?」 「どのコマンド?」 の3点で整理する。

チートシート
続きを読む →