👻

【最短】EC2 上の FastAPI を Caddy で HTTPS 化する(Route53 + Let’s Encrypt)

に公開

【最短】EC2 上の FastAPI を Caddy で HTTPS 化する(Route53 + Let’s Encrypt)

FastAPI を EC2 で動かした後、本番運用に乗せるために必須となるのが HTTPS 化です。
今回は、TLS 終端(暗号化の解除)や証明書管理といった面倒な作業をすべて Caddy に丸投げし、FastAPI アプリケーション自体は HTTP のままシンプルに運用する構成を作ります。

今回の構成

  • ドメイン: Route53 で取得済み(例: example.com)
  • サブドメイン: test.example.com
  • サーバー: EC2 (Ubuntu 想定)
  • Web サーバー: Caddy (HTTPS 終端 / リバースプロキシ)
  • AP サーバー: FastAPI + Uvicorn (ローカル 127.0.0.1:8000 で稼働)

構成の考え方

FastAPI 自体に SSL 証明書を持たせるのは運用がつらくなるのでやめましょう。以下のように役割を分離するのが鉄板です。

  • Caddy: インターネットからのアクセス (80/443) を受け付け、HTTPS を終端する。証明書の自動取得・更新も勝手にやってくれる。
  • FastAPI: 外部から直接アクセスさせず、ローカル (127.0.0.1) からの HTTP リクエストのみを処理する。

なぜ Caddy だと証明書が「勝手に」発行されるのか?

手順に入る前に、Caddy が裏側で何をやっているのか(Let's Encrypt の仕組み)を少しだけ解説します。これを知っておくと、トラブルシューティング(特にポート開放忘れ)で役立ちます。

Caddy は ACME プロトコル を使用して Let’s Encrypt と通信し、以下の HTTP-01 チャレンジ というフローを自動で行います。

  1. リクエスト: Caddy が Let's Encrypt に「このドメインの証明書ください」と頼む。
  2. 課題の提示: Let's Encrypt が「じゃあ、このトークンを http://ドメイン/.well-known/acme-challenge/トークン に置いてみて」と課題を出す。
  3. 配置と検証: Caddy がその URL でトークンを配信し、Let's Encrypt が外部から HTTP(ポート 80)でアクセスして確認する。
  4. 発行: 確認が取れたら証明書が発行される。

1. Route53 で DNS を設定する(必須)

まずはドメイン解決です。Caddy が起動した瞬間に証明書を取りに行くため、先に DNS が浸透している必要があります。

Route53 の Hosted Zone で、サブドメイン(例: test)の A レコードを追加します。

  • Record name: test
  • Type: A
  • Value: EC2 の Public IP (XXX.XXX.XXX.XXX)

手元の PC(Windows/Mac)で名前解決できるか確認しておきましょう。

nslookup test.example.com

IP アドレスが返ってくれば OK です。

2. セキュリティグループの設定

前述の通り、Let’s Encrypt の検証にはポート 80 が使われます。EC2 のセキュリティグループで Inbound(受信)ルールを許可してください。

Protocol Port Source 用途
TCP 22 My IP SSH 接続用
TCP 80 0.0.0.0/0 Let’s Encrypt 検証用 / HTTP リダイレクト用
TCP 443 0.0.0.0/0 HTTPS 通信本番用

もし Ubuntu 内部で UFW (ファイアウォール) を有効にしている場合は、そちらも開けます。

sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw reload

3. FastAPI を用意する

まずは HTTP で動く最小限の FastAPI 環境を作ります。

# プロジェクトディレクトリ作成
cd /opt
sudo mkdir fastapi
sudo chown ubuntu:ubuntu fastapi
cd fastapi

# 仮想環境とインストール
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install fastapi "uvicorn[standard]"

main.py 作成

# main.py
from fastapi import FastAPI

app = FastAPI()

@app.get("/")
def read_root():
    return {"message": "Hello EC2 from FastAPI!"}

動作確認(手動)

# ローカルホストの 8000 番のみで待受
uvicorn main:app --host 127.0.0.1 --port 8000

別のターミナルから curl を叩いてレスポンスがあれば OK です。

curl http://127.0.0.1:8000/
# -> {"message":"Hello EC2 from FastAPI!"}

4. Systemd で FastAPI を常駐化

SSH を切っても動くように、Systemd のサービスとして登録します。

/etc/systemd/system/fastapi.service を作成:

[Unit]
Description=FastAPI (Uvicorn)
After=network.target

[Service]
Type=simple
User=ubuntu
WorkingDirectory=/opt/fastapi
Environment="PATH=/opt/fastapi/.venv/bin"
# プロキシヘッダーを正しく扱うためのオプションを追加
ExecStart=/opt/fastapi/.venv/bin/uvicorn main:app --host 127.0.0.1 --port 8000 --proxy-headers --forwarded-allow-ips=127.0.0.1
Restart=always
RestartSec=3

[Install]
WantedBy=multi-user.target

起動と自動起動設定:

sudo systemctl daemon-reload
sudo systemctl enable --now fastapi
sudo systemctl status fastapi --no-pager

5. Caddy のインストール

ここからが本番です。公式リポジリから最新版を入れます。

sudo apt update
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/gpg.key' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg
curl -1sLf 'https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt' | sudo tee /etc/apt/sources.list.d/caddy-stable.list
sudo apt update
sudo apt install -y caddy

6. Caddyfile で HTTPS 化設定

/etc/caddy/Caddyfile を編集します。ここにドメインを書くだけで、Caddy は「あ、HTTPS したいんだな」と判断して証明書を取りに行ってくれます。

caddyfile
test.example.com {
    # 圧縮有効化
    encode gzip zstd

    # ローカルの FastAPI へ転送
    reverse_proxy 127.0.0.1:8000 {
        header_up X-Forwarded-Proto {scheme}
        header_up X-Forwarded-Host {host}
        header_up X-Forwarded-For {remote}
    }

    # ログ設定(任意)
    log {
        output file /var/log/caddy/access.log
        format console
    }
}

設定反映

# 構文チェック
sudo caddy validate --config /etc/caddy/Caddyfile

# 再読み込み
sudo systemctl reload caddy

これだけで完了です。数秒〜数十秒待てば、裏で証明書取得が完了しているはずです。


7. 動作確認

ブラウザ、または手元の PC から確認してみましょう。

curl https://test.example.com/

以下のように返ってくれば成功です!

{"message":"Hello EC2 from FastAPI!"}

ログの確認方法

もしうまくいかない場合は、Caddy のログを確認します。

sudo journalctl -u caddy -e --no-pager

よくあるエラー:no valid A records found
→ Route53 の設定が間違っているか、まだ反映されていません。nslookup で IP が引けるか再確認してください。


補足:curl -I (HEAD) が 405 になる場合

動作確認で curl -I https://test.example.com/ を叩くと 405 Method Not Allowed が返ることがあります。
これは HTTPS の問題ではなく、FastAPI の仕様です(デフォルトで HEAD メソッドのハンドラがないため)。

GET が通っていれば HTTPS 化は成功しています。もし HEAD も許可したい場合は、FastAPI 側に @app.head("/") を追加してください。


まとめ

FastAPI の HTTPS 化は、Python 側で頑張るよりも前段の Web サーバーに任せるのが楽です。特に Caddy は設定ファイルが簡潔で、証明書周りのトラブルが少ないためおすすめです。

  1. Route53 で A レコードを設定
  2. セキュリティグループで 80/443 を開ける
  3. FastAPI は 127.0.0.1 で動かす
  4. Caddyfile にドメインと reverse_proxy を書く

これだけで、自動更新される安全な HTTPS 環境が手に入ります。

Discussion