メインコンテンツまでスキップ

DNS と TLS のセットアップランブック

ドメイン要件​

本番導入では、Yabanin に 3 つのサブドメインが必要です(すべて Caddy が管理する TLS)。

サブドメイン用途サービスポート
api.yourdomain.comゲートウェイ — OpenAI 互換 APIgateway8082 → Caddy → 443
admin.yourdomain.com管理パネルと請求 UIadmin8086 → Caddy → 443
dash.yourdomain.comコストダッシュボード(React SPA)dashboard-webnginx → Caddy → 443

DNS レコード​

ドメイン登録事業者で、VPS の IP を指す 3 つの A レコードを追加します。

Type Name Value TTL
A api <VPS_IP> 300
A admin <VPS_IP> 300
A dash <VPS_IP> 300

<VPS_IP> を、実際の VPS パブリック IP アドレスに置き換えてください。

TLS / SSL​

Caddy(deploy/caddy/Caddyfile.tmpl 経由)は、Let's Encrypt による自動 HTTPS を処理します。証明書を手動で管理する必要はありません。DNS が解決すれば、Caddy が証明書を自動で発行します。

ゲートウェイは、環境変数経由でもドメインを受け取ります。

  • API_DOMAIN → 既定値は api.yourdomain.com
  • ADMIN_DOMAIN → 既定値は admin.yourdomain.com
  • DASHBOARD_DOMAIN → 既定値は dash.yourdomain.com

デプロイ前に、.env(deploy/secrets/env へコピーされます)で環境変数を設定して上書きします。

# deploy/secrets/env
API_DOMAIN=api.example.com
ADMIN_DOMAIN=admin.example.com
DASHBOARD_DOMAIN=dash.example.com

デプロイ手順​

  1. ドメインを購入し、VPS の IP アドレスを控えます
  2. DNS の A レコードを追加します(3 つのサブドメイン → VPS の IP)
  3. 実際のドメインで deploy/secrets/env を編集します
  4. デプロイを実行します: ./scripts/deploy.sh
  5. ヘルスチェックを確認します — スクリプトがすべてのサービスを自動で確認します
# After deploy, verify:
curl -sI https://api.yourdomain.com/v1/chat/completions | head -1
# Expected: HTTP/2 401 (unauthorized — API is up, no valid key)

トラブルシューティング​

Caddy が証明書を取得しない​

  • DNS レコードが伝播していることを確認します(dig api.yourdomain.com)
  • Caddy のログを確認します: docker compose logs caddy
  • VPS のファイアウォールでポート 80/443 が開いていることを確認します
  • Let's Encrypt にはレート制限があります。リクエストを連発しないでください

ゲートウェイがドメインに到達できない​

  • .env 内のゲートウェイ環境変数(API_DOMAIN、ADMIN_DOMAIN)を確認します
  • Caddyfile.tmpl のドメインブロックが DNS レコードと一致していることを確認します