Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

Tunnel

最終更新 Markdown で表示Agent セットアップ

Wrangler から Cloudflare Tunnels を直接管理できます。ローカルのサービスを Cloudflare のネットワークに安全につなぐトンネルを作成、実行、管理します。公開 IP は不要です。

Wrangler は cloudflared バイナリを自動で管理します。初回利用時、Wrangler は cloudflared をローカルのキャッシュディレクトリへダウンロードするよう求めます。自分で cloudflared をインストールして PATH に追加するか、既存のバイナリを指すように環境変数 CLOUDFLARED_PATH を設定すれば、この手順をスキップできます。

tunnel create

リモート管理の Cloudflare Tunnel を新規作成します。

wrangler tunnel create <NAME>
  • NAME string 必須
    • トンネルの名前です。アカウント内で一意である必要があります。

Wrangler で作成したトンネルは常に リモート管理 です。設定は Cloudflare ダッシュボード ↗ または API で行います。

作成後、トンネル ID を指定して wrangler tunnel run を実行すると、トンネルを開始できます。

npx wrangler tunnel create my-app
Creating tunnel "my-app"
Created tunnel.
ID: f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
Name: my-app

To run this tunnel, configure its ingress rules in the Cloudflare dashboard, then run:
   wrangler tunnel run f70ff985-a4ef-4643-bbbc-4a0ed4fc8415

次のグローバルフラグは、すべてのコマンドで使えます。

  • --help boolean
    • ヘルプを表示します。
  • --config string（Pages では未対応）
  • --cwd string
    • 現在の作業ディレクトリではなく、指定したディレクトリで Wrangler を起動したように実行します。

tunnel delete

アカウントから Cloudflare Tunnel を削除します。

wrangler tunnel delete <TUNNEL> [OPTIONS]
  • TUNNEL string 必須
    • 削除するトンネルの名前または UUID です。
  • --force boolean 任意
    • 確認プロンプトをスキップします。
npx wrangler tunnel delete f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
Are you sure you want to delete tunnel "f70ff985-a4ef-4643-bbbc-4a0ed4fc8415"? This action cannot be undone. (y/n)
Deleting tunnel f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
Tunnel deleted.

次のグローバルフラグは、すべてのコマンドで使えます。

  • --help boolean
    • ヘルプを表示します。
  • --config string（Pages では未対応）
  • --cwd string
    • 現在の作業ディレクトリではなく、指定したディレクトリで Wrangler を起動したように実行します。

tunnel info

Cloudflare Tunnel の詳細（ID、名前、ステータス、作成時刻）を表示します。

wrangler tunnel info <TUNNEL>
  • TUNNEL string 必須
    • 確認するトンネルの名前または UUID です。
npx wrangler tunnel info f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
Getting tunnel details
ID: f70ff985-a4ef-4643-bbbc-4a0ed4fc8415
Name: my-app
Status: healthy
Created: 2025-01-15T10:30:00Z
Type: cfd_tunnel

次のグローバルフラグは、すべてのコマンドで使えます。

  • --help boolean
    • ヘルプを表示します。
  • --config string（Pages では未対応）
  • --cwd string
    • 現在の作業ディレクトリではなく、指定したディレクトリで Wrangler を起動したように実行します。

tunnel list

アカウント内のすべての Cloudflare Tunnel を一覧表示します。

wrangler tunnel list

出力には、各トンネルの ID、名前、ステータス、作成日が含まれます。削除済みでないトンネルだけが表示されます。

npx wrangler tunnel list
Listing Cloudflare Tunnels

ID                                   Name       Status    Created
f70ff985-a4ef-4643-bbbc-4a0ed4fc8415 my-app     healthy   2025-01-15T10:30:00Z
550e8400-e29b-41d4-a716-446655440000 api-tunnel inactive  2025-01-10T15:45:00Z

次のグローバルフラグは、すべてのコマンドで使えます。

  • --help boolean
    • ヘルプを表示します。
  • --config string（Pages では未対応）
  • --cwd string
    • 現在の作業ディレクトリではなく、指定したディレクトリで Wrangler を起動したように実行します。

tunnel run

cloudflared デーモンを使って Cloudflare Tunnel を実行します。ローカルマシンと Cloudflare のネットワーク間に永続的な接続を開始します。

wrangler tunnel run [TUNNEL] [OPTIONS]
  • TUNNEL string 任意
    • 実行するトンネルの名前または UUID です。--token を指定しない場合は必須です。
  • --token string 任意
    • 直接使うトンネルトークンです。API 認証をスキップします。
  • --log-level string (デフォルト: info) 任意
    • cloudflared のログレベルです。Wrangler のログ（WRANGLER_LOG で制御）には影響しません。次のいずれかです: debug、info、warn、error、fatal。

名前付きトンネルは リモート管理 です。トンネルを実行する前に、Cloudflare ダッシュボード ↗ または API で、公開するローカルサービスを指定するイングレスルールを設定してください。

トンネルの実行方法は 2 つあります。

トンネル名または ID で実行する（API 経由でトークンを取得します）:

npx wrangler tunnel run my-app

トークンで実行する（API 認証は不要です。CI/CD やリモートサーバーで便利です）:

npx wrangler tunnel run --token eyJhIjoiNGE2MjY...

Ctrl+C を押すとトンネルを停止します。Wrangler は終了前に、cloudflared へグレースフルシャットダウンのシグナルを送ります。

次のグローバルフラグは、すべてのコマンドで使えます。

  • --help boolean
    • ヘルプを表示します。
  • --config string（Pages では未対応）
  • --cwd string
    • 現在の作業ディレクトリではなく、指定したディレクトリで Wrangler を起動したように実行します。

tunnel quick-start

Quick Tunnels を使い、Cloudflare アカウントなしで無料の一時トンネルを開始します。簡単なデモ、Webhook のテスト、ローカル開発サーバーの共有に便利です。

wrangler tunnel quick-start <URL>
  • URL string 必須
    • 公開するローカル URL です（例: http://localhost:8080）。

トンネルにはランダムな *.trycloudflare.com サブドメインが割り当てられ、プロセスの実行中だけ有効です。

npx wrangler tunnel quick-start http://localhost:8080
Starting quick tunnel to http://localhost:8080...
Your tunnel URL: https://random-words-here.trycloudflare.com

次のグローバルフラグは、すべてのコマンドで使えます。

  • --help boolean
    • ヘルプを表示します。
  • --config string（Pages では未対応）
  • --cwd string
    • 現在の作業ディレクトリではなく、指定したディレクトリで Wrangler を起動したように実行します。

役に立ちましたか？