🐇 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点で整理する。