ルーティング

Cloudflare Tunnel は、Cloudflare のネットワークから cloudflared の背後で動くサービスへトラフィックをルーティングします。アプリケーションを公開する と、公開ホスト名をローカルサービスに対応付けます。たとえば app.example.com を http://localhost:8080 に対応付けます。Cloudflare はリクエストをオリジンへ転送する前に、CDN キャッシュ、WAF、DDoS 防御を適用します。

公開アプリケーションは、トンネル設定で定義するホスト名とサービスの対応です。各対応は、指定した公開ホスト名のトラフィックを、どのローカルサービスが受け取るかを cloudflared に伝えます。

1 つのトンネルで複数のアプリケーションを公開できます。アプリケーションごとに次を指定します。

• 公開ホスト名 — ユーザーがアクセスするドメインまたはサブドメインです（例: app.example.com）。
• サービス — アプリケーションが動いているローカルアドレスまたはソケットです（例: http://localhost:8080）。

ダッシュボードからルートを追加すると、Cloudflare はそのホスト名をトンネルのサブドメイン（<UUID>.cfargotunnel.com）へ向ける DNS レコードを自動作成します。

次の表は、パブリックホスト名へルーティングできるサービスタイプの一覧です。HTTP 以外のサービスでは、エンドユーザーが接続するために クライアントへ cloudflared をインストールする 必要があります。

service の値が IPv6 リテラルの場合は、RFC 3986 ↗ の定義どおり、アドレスを角括弧で囲みます。アドレス内の : がポート区切りと混同されないように、角括弧が必要です。

ホスト名と IPv4 アドレスに角括弧は不要です。http://localhost:8000 と http://192.0.2.1:8000 はそのまま使えます。

トンネルを作成すると、Cloudflare は <UUID>.cfargotunnel.com のサブドメインを生成します。このサブドメインを指す CNAME レコードを作成すると、ホスト名へのトラフィックがトンネルへルーティングされます。

cfargotunnel.com サブドメインがプロキシするのは、同じ Cloudflare アカウント内の DNS レコード向けトラフィックだけです。トンネルの UUID が知られても、別アカウントで DNS レコードを作成して、そのトンネル経由でトラフィックをプロキシすることはできません。

Cloudflare Tunnel の DNS レコードを作成するには:

1. Cloudflare ダッシュボード ↗ にログインし、ドメインの DNS Records を開きます。

   Records を開く ↗

2. Add record を選択します。

3. 次の値を入力します。

   • Type: CNAME
   • Name: アプリケーションのサブドメイン
   • Target: <UUID>.cfargotunnel.com

4. Save を選択します。

ローカル管理トンネルでは、次のコマンドを実行して、トンネルのサブドメインを指す CNAME レコードを作成します。

cloudflared tunnel route dns <UUID or NAME> www.app.com

この操作で CNAME レコードは作成されますが、トンネルが稼働していないとトラフィックはプロキシされません。

DNS レコードとトンネルは独立しています。稼働していないトンネルを指す DNS レコードも作成できます。トンネルが停止しても DNS レコードは削除されません。訪問者には 1016 エラーが表示されます。

同じトンネルサブドメインを指す DNS レコードを複数作成することもできます。複数のホスト名から複数のサービスへトラフィックをルーティングする場合は、ホスト名ごとに CNAME エントリを作成します。すべてのエントリは同じターゲットを共有します。

公開ロードバランサー を使い、公開アプリケーションを動かすサーバーへトラフィックを分散します。ヘルスチェックに基づくフェイルオーバーと、リージョンをまたぐインテリジェントなトラフィックステアリングが得られます。

graph LR
    accTitle: Load balancing traffic to applications behind Cloudflare Tunnel

    A[Internet] --> C{Cloudflare <br> Load Balancer}
    C -- Tunnel 1 --> cf1
    C -- Tunnel 2 --> cf2
    subgraph F[Data center 2]
        cf2[cloudflared]
        S3[App server]
        S4[App server]
        cf2-->S3
        cf2-->S4
    end
    subgraph E[Data center 1]
        cf1[cloudflared]
        S1[App server]
        S2[App server]
        cf1-->S1
        cf1-->S2
    end

同じトンネル UUID で複数の cloudflared レプリカ を動かすと、基本的な冗長性が得られます。1 つのホストが故障しても、他のレプリカがトラフィックを提供し続けます。ただし、ロードバランサーは同じトンネル UUID のレプリカをすべて 1 つのエンドポイントとして扱います。

きめ細かいトラフィックステアリングと セッションアフィニティ が必要な場合は、ホストごとに異なるトンネル UUID で接続します。ロードバランサーがそれぞれを独立して扱えます。

Cloudflare Tunnel の公開アプリケーション用にロードバランサーを作成するには:

1. Cloudflare ダッシュボードで Load Balancing ページを開きます。

   Load Balancing を開く ↗

2. Create load balancer を選び、Public load balancer を選びます。

3. Select website で、公開アプリケーションルートのドメインを選びます。

4. Hostname ページで、ロードバランサーのホスト名を入力します（例: lb.example.com）。

5. Pools ページで Create a pool を選び、わかりやすい名前を入力します。

6. 次の値でトンネルエンドポイントを追加します。

   • Endpoint Name: アプリケーションを実行しているサーバーの名前
   • Endpoint Address: <UUID>.cfargotunnel.com（Tunnel ID は the [Cloudflare dashboard](https://dash.cloudflare.com/) under **Networking** > **Tunnels** で確認します）
   • Header value: 公開アプリケーションルートのホスト名（例: app.example.com）
   • Weight: 1（エンドポイントが 1 つの場合）

7. Fallback pool を選びます。ルーティングの選択肢は トラフィックステアリングポリシー を参照してください。

8. （推奨）Monitors ページで、エンドポイントにモニターを関連付けます。HTTP または HTTPS アプリケーションの場合は、次の HTTPS モニターを作成します。

   • Type: HTTPS
   • Path: /
   • Port: 443
   • Expected Code(s): 200
   • Header Name: Host
   • Value: app.example.com

9. ロードバランサーを保存してデプロイします。

テストするには、ロードバランサーのホスト名（lb.example.com）でアプリケーションにアクセスします。

公開アプリケーションは、ホスト名に設定された Cloudflare の設定を継承します。キャッシュルール、WAF ルール、その他の Rules 設定が含まれます。各ホスト名の設定は Cloudflare ダッシュボード ↗ で変更できます。

ロードバランサーを使う場合、設定はロードバランサーのホスト名に適用されます。