版数: 1.0 | 更新日: 2026-05-04
基本・詳細設計書（Phase 1-4）
基本設計書・詳細設計書（Phase 1-4: Named Tunnel設定問題解決）
1. 目的
Phase 1-4におけるCloudflare Named Tunnelの接続タイムアウト問題（ERR_CONNECTION_TIMED_OUT）を解決し、外部ドメイン（Squarespace管理）を用いた安定的なトンネル接続を確立する。
2. システム構成変更点
- DNS管理: Squarespace（実体はGoogle Cloud DNS）からCloudflare DNSへ移行（ドメイン所有権はSquarespaceのまま維持）
- Tunnelルーティング:
docker-compose.ymlのコマンド引数から、Cloudflareダッシュボード上のPublic Hostname設定へ移行
- cloudflared設定:
--urlオプションを廃止し、Named Tunnelの標準的なルーティング方式に準拠
3. 詳細設計（パラメータシート）
3.1. DNS設定（Cloudflare DNS）
| パラメータ名 |
設定値 |
備考 |
| ドメイン名 |
your-domain.com |
Squarespaceで取得・更新管理（Layer 2） |
| ネームサーバー1 |
xxxx.ns.cloudflare.com |
Squarespace管理画面で設定（Layer 3をCloudflareへ委譲） |
| ネームサーバー2 |
yyyy.ns.cloudflare.com |
Squarespace管理画面で設定 |
| プロキシステータス |
Proxied (オレンジの雲) |
CloudflareのCDN/WAFを有効化 |
3.2. Cloudflare Tunnel (Public Hostname) 設定
| パラメータ名 |
設定値 |
備考 |
| Tunnel名 |
your-tunnel-name |
|
| Subdomain |
api |
|
| Domain |
your-domain.com |
Cloudflare DNS管理移行により選択可能に |
| Service Type |
HTTP |
|
| Service URL |
http://api:8000 |
FastAPIコンテナへのルーティング（プロトコル指定必須） |
3.3. Docker Compose 設定 (docker-compose.yml)
| サービス名 |
パラメータ名 |
設定値 |
備考 |
cloudflared |
command |
tunnel --no-autoupdate run --token <YOUR-TOKEN> |
--urlオプションを削除し、トークンのみで起動 |
4. 移行時の影響評価
- Squarespaceウェブサイト: AレコードおよびCNAMEレコードがCloudflareに自動引き継ぎされたため、影響なし。
- Google Workspace (メール): 事前調査によりMXレコードが存在せず、SPFレコードも
-all（全拒否）であったため、メール送受信への影響はなしと判断。
- Google所有権確認: TXTレコードが正常に引き継がれたため影響なし。