Cloudflare Tunnel クライアント

Cloudflare Tunnelのコマンドラインクライアントです。これは、Cloudflareネットワークからオリジンへのトラフィックをプロキシするトンネリングデーモンです。このデーモンはCloudflareネットワークとオリジン（例：ウェブサーバー）の間に位置します。Cloudflareはクライアントリクエストを引き付け、このデーモンを介して送信するため、ファイアウォールに穴を開ける必要はなく、オリジンを可能な限り閉鎖的に保つことができます。詳細なドキュメントはCloudflare DocsのCloudflare Tunnelセクションにあります。オリジンへのプロキシに関するすべての使用法は、cloudflared tunnel helpで確認できます。

また、cloudflaredを使用して、レイヤ4（HTTP/Websocketではない）のTCPトラフィックに対して、cloudflared tunnelで保護されたトンネルオリジンにアクセスすることもできます。これは、SSH、RDPなどのユースケースに関連します。そのような使用法はcloudflared access helpで確認できます。

代わりに、WARPクライアントを使用すると、クライアント側でcloudflared accessコマンドを必要とせずに、トンネル背後のプライベートオリジンにレイヤ4トラフィックでアクセスできます。

始める前に

Cloudflare Tunnelを使用する前に、Cloudflareダッシュボードでいくつかの手順を完了する必要があります。Cloudflareアカウントにウェブサイトを追加する必要があります。現在はウェブサイトなしでトンネルを使用することも可能ですが（例：プライベートルーティング）、レガシーな理由によりこの要件は依然として必要です：

`cloudflared`のインストール

ダウンロードは、スタンドアロンバイナリ、Dockerイメージ、Debian、RPM、Homebrewパッケージとして提供されています。また、cloudflaredのGitHubリポジトリのリリースページでも入手できます。

macOSへのインストールはHomebrew経由、または最新のDarwin amd64リリースをダウンロードして行えます。
Linux用のバイナリ、Debian、RPMパッケージはこちらで入手できます。
cloudflaredのDockerイメージはDockerHubで利用可能です。
Windowsマシンへのインストールはこちらの手順で行えます。
ソースからビルドするには、以下の開発セクションで述べられている必要なバージョンのgoをインストールしてください。その後、make cloudflaredを実行できます。

Cloudflare Tunnelのユーザードキュメントは https://developers.cloudflare.com/cloudflare-one/networks/connectors/cloudflare-tunnel/ にあります。

トンネルの作成とトラフィックのルーティング

インストール後、cloudflaredをCloudflareアカウントに認証し、オリジンにトラフィックを提供するトンネルを作成できます。

これらの手順でトンネルを作成します。
そのトンネルへのトラフィックをルーティングします：
- CloudflareのパブリックDNSレコード経由
- または、Cloudflare Load Balancerによってガイドされるパブリックホスト名経由
- または、WARPクライアントのプライベートトラフィックから

TryCloudflare

Cloudflareにウェブサイトを追加する前にCloudflare Tunnelをテストしてみたいですか？こちらのドキュメントにあるTryCloudflareを使用してテストできます。

非推奨のバージョン

Cloudflareは現在、最新リリースから1年以内のcloudflaredバージョンをサポートしています。機能の可用性とは無関係の破壊的変更が導入され、1年以上前にリリースされたバージョンに影響を与える可能性があります。cloudflaredのアップグレードに関する詳細は、開発者ドキュメントをご覧ください。

例えば、2023年1月時点では、Cloudflareはcloudflaredバージョン2023.1.1から2022.1.1までをサポートします。

開発

要件

ビルド

cloudflaredをローカルでビルドするには、make cloudflaredを実行します。

テスト

ローカルでテストを実行するには、make testを実行します。

リンティング

コードをフォーマットし、良好なコード品質を保つには、make fmtとmake lintを使用します。

モック

インターフェースの変更後、モックを再生成する必要がある場合は、make mocksを実行します。

Gitフック

CIエラーを回避するために、プッシュごとにリンティングとテストを実行するpre-pushフックをインストールできます：

make install-hooks

これにより、.githooks/内のフックを使用するようにgitが設定され、プッシュのたびにmake fmt-check lint testが実行されます。

cloudflared v2026.8.1

カテゴリ