このページでは、ローカル管理の Cloudflare Tunnel 固有の用語を説明します。一般的な Tunnel の用語は、Get started セクション を参照してください。
cloudflared は、トンネルの認証情報ファイルと、cloudflared login 実行時に生成する cert.pem ファイルを、デフォルトのディレクトリに保存します。トンネル実行時に別のファイルパスを指定しない場合、cloudflared はこのデフォルトディレクトリで 設定ファイル を探します。
| OS | デフォルトディレクトリのパス |
|---|---|
| Windows | %USERPROFILE%\.cloudflared |
| macOS および Unix 系システム | ~/.cloudflared、/etc/cloudflared、/usr/local/etc/cloudflared の順です。 |
これは cloudflared の動作を定義する YAML ファイルです。cloudflared は デフォルトの cloudflared ディレクトリ で設定ファイルを自動的に探しますが、任意のディレクトリに保存できます。設定ファイルを参照するときは、常にファイルパスを指定することを推奨します。設定ファイルを作成すると、cloudflared インスタンスの動作を細かく制御できます。たとえば、トラフィックの扱い（WebSocket をポート xxxx へプロキシする、SSH をポート yyyy へプロキシするなど）、認可情報の参照先（認証情報ファイル、トンネルトークン）、実行モード（warp-routing など）を指定できます。設定ファイルがない場合、cloudflared は送信トラフィックをポート 8080 経由でプロキシします。設定ファイルの作成、保存、構造については、専用の手順 を参照してください。
これは cloudflared tunnel login 実行時に Cloudflare が発行する証明書ファイルです。このファイルは証明書を使って cloudflared インスタンスを認証します。新しいトンネルの作成、既存トンネルの削除、DNS レコードの変更、cloudflared からのトンネルルーティング設定では、このファイルが必要です。既存トンネルの実行や、Cloudflare ダッシュボードからのトンネルルーティング管理には不要です。このファイルが必要になるタイミングの詳細は、Tunnel の権限ページ を参照してください。
cert.pem のオリジン証明書の有効期間は少なくとも 10 年です。含まれるサービストークンは、取り消されるまで有効です。
このファイルは cloudflared tunnel create <NAME> 実行時に作成されます。トンネルの認証情報を JSON 形式で保存し、トンネルごとに一意です。関連するトンネルを認証するトークンとして機能します。このファイルが必要になるタイミングの詳細は、Tunnel の権限ページ を参照してください。
イングレスルールでは、トラフィックをどのローカルサービスへプロキシするかを指定できます。ルールがパスを指定しない場合は、すべてのパスに一致します。cloudflared はパスの削除や書き換えをせず、リクエストの完全なパスをサービスへ転送します。イングレスルールは 設定ファイル に記述するか、cloudflared tunnel ingress 実行時に指定できます。