DNS と TLS のセットアップランブック
ドメイン要件
本番導入では、Yabanin に 3 つのサブドメインが必要です(すべて Caddy が管理する TLS)。
| サブドメイン | 用途 | サービス | ポート |
|---|---|---|---|
api.yourdomain.com | ゲートウェイ — OpenAI 互換 API | gateway | 8082 → Caddy → 443 |
admin.yourdomain.com | 管理パネルと請求 UI | admin | 8086 → Caddy → 443 |
dash.yourdomain.com | コストダッシュボード(React SPA) | dashboard-web | nginx → 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.comADMIN_DOMAIN→ 既定値はadmin.yourdomain.comDASHBOARD_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
デプロイ手順
- ドメインを購入し、VPS の IP アドレスを控えます
- DNS の A レコードを追加します(3 つのサブドメイン → VPS の IP)
- 実際のドメインで
deploy/secrets/envを編集します - デプロイを実行します:
./scripts/deploy.sh - ヘルスチェックを確認します — スクリプトがすべてのサービスを自動で確認します
# 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)