インストールと初期化
このガイドでは、NetFUNNEL Cloudflareエージェントのインストールと初期化プロセスを説明します。
ステップ1: Worker環境設定
Cloudflareの公式ドキュメントを参照してCloudflare Workerの環境を設定することが最優先です。
Cloudflareの公式ドキュメントでWorkerプロジェクトを設定する内容を確認した後、案内に従ってWorker環境を設定します。
ステップ2: Client ID取得
- NetFUNNELコンソールに移動
- 右上のプロフィールアイコンをクリック
統合資格情報(Integration Credentials) メニューを選択Client IDをコピー
Client ID確認位置
コンソール画面右上のプロフィールアイコンをクリックした後、統合資格情報メニューで確認できます。
ステップ3: Worker作成
- Cloudflareコンソール → [WorkersとPages]メニューをクリック
- Workers [作成]をクリック
- [Hello world]をクリック
- デプロイして追加
ステップ4: Workerにエージェント適用
- 右上の[コード編集]をクリック
- https://agent-lib.stclab.com/agents/cdn/cloudflare/netfunnel-cloudflare-agent-latest.js から
netfunnel-cloudflare-agent.jsファイルをダウンロード - コードエディタの左タブで[Explore]をクリックしてファイル一覧が表示されるように設定
netfunnel-cloudflare-agent.jsファイルをアップロードworker.jsファイルを開き、以下のコードを記述:
import handleEvent from './netfunnel-cloudflare-agent.js'
export default {
async fetch(request, env, ctx) {
return await handleEvent(request, env, ctx);
},
};
- 右上の[デプロイ]ボタンをクリックしてWorkerをデプロイ
ステップ5: Worker設定
ドメインとパス設定
- 作成したWorkerを選択
- [設定]メニューをクリック
- ドメインとパスで[+追加]をクリック
- [パス]をクリック
- [ゾーン]でドメインを選択
- [パス]にWorkerが実行されるパスを入力 (末尾に
/*を追加してサブページでもWorkerが動作するように) - [失敗時に開く(続行)]を選択
- [パス追加]をクリック
環境変数設定
以下の表を参照して変数とシークレットに環境変数を追加します。
| タイプ | 名前 | 値 |
|---|---|---|
| テキスト | CLIENT_ID | {{CLIENT_ID}} |
CLIENT_IDはNetFUNNELコンソールで確認してください。
変数を追加した後、[デプロイ]をクリックします。
ステップ6: ドメイン設定
- Cloudflare DNS設定に移動
- ステップ5で設定したドメインをCNAMEとして設定
- 必ずProxyタイプに設定する必要があります (オレンジ色のクラウドアイコン)
この設定により、そのパスにリクエストが来たときにWorkerが実行できるようになります。
次のステップ
- 初期化設定: 環境変数と追加機能設定
- トラブルシューティング: 一般的な問題と解決方法