🌐 Cloudflare Named Tunnel セットアップ手順書¶

📁 docs/dev-environment/artifact/cloudflare-named-tunnel-setup.md

[!NOTE] Quick Tunnel（毎回URLがランダム）を Named Tunnel（固定サブドメイン）に移行するための手順書。 親Issue: #287

📋 前提条件¶

• Cloudflare アカウント登録済み
• ドメインを Cloudflare Registrar で取得済み（または既存ドメインを Cloudflare に移管済み）
• macOS（Apple Silicon）環境

🗺️ サブドメイン設計表¶

[!TIP] サービスを追加する場合は projects/iac/cloudflare/config.yml の ingress セクションに追記し、Cloudflare Dashboard で CNAME レコードも追加する。

🚀 セットアップ手順¶

Step 1: cloudflared のインストール¶

brew install cloudflare/cloudflare/cloudflared
cloudflared --version

Step 2: Cloudflare にログイン¶

ブラウザが開くので、Cloudflare アカウントでログインして認証する。

cloudflared tunnel login
# → ~/.cloudflared/cert.pem が生成される

Step 3: Named Tunnel を作成¶

<TUNNEL_NAME> は任意の名前（例: mylab-tunnel）。

cloudflared tunnel create <TUNNEL_NAME>
# → Tunnel ID（UUID）が発行される
# → ~/.cloudflared/<TUNNEL_ID>.json が生成される（認証情報ファイル）

[!IMPORTANT] 発行された Tunnel ID をメモしておくこと。次のステップで使用する。

Step 4: 設定ファイルを配置¶

# テンプレートをコピーして編集
cp projects/iac/cloudflare/config.yml ~/.cloudflared/config.yml

~/.cloudflared/config.yml を開き、以下を実際の値に書き換える：

Step 5: DNS レコードを登録（サブドメインごとに実行）¶

cloudflared tunnel route dns <TUNNEL_NAME> gallery.<YOUR_DOMAIN>
cloudflared tunnel route dns <TUNNEL_NAME> n8n.<YOUR_DOMAIN>
cloudflared tunnel route dns <TUNNEL_NAME> api.<YOUR_DOMAIN>

[!NOTE] Cloudflare Dashboard → DNS タブで CNAME レコードが自動追加されていることを確認できる。

Step 6: 動作確認（フォアグラウンド実行）¶

cloudflared tunnel --config ~/.cloudflared/config.yml run <TUNNEL_NAME>

ブラウザで https://gallery.<YOUR_DOMAIN> にアクセスしてローカルサービスが表示されることを確認。

Step 7: 常駐化（launchd サービス登録）¶

確認が取れたらバックグラウンド常駐に切り替える。

sudo cloudflared service install
sudo launchctl start com.cloudflare.cloudflared

起動状態の確認：

sudo launchctl list | grep cloudflare

停止・再起動：

sudo launchctl stop com.cloudflare.cloudflared
sudo launchctl start com.cloudflare.cloudflared

🔧 よく使うコマンド¶

# トンネル一覧
cloudflared tunnel list

# ルーティング状況確認
cloudflared tunnel info <TUNNEL_NAME>

# ログ確認
tail -f /tmp/cloudflared.log

🐛 トラブルシューティング¶

📁 関連ファイル¶