← 記事一覧へ戻る

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