Cloudflare Workers のアカウントには、Cloudflare ダッシュボードで設定できる workers.dev サブドメインが付きます。workers.dev サブドメインを使うと、カスタムドメインを Cloudflare にオンボードする前に、Worker をデプロイしてすぐ始められます。
本番の Worker は、workers.dev サブドメインではなく Workers ルートまたはカスタムドメイン で動かすことを推奨します。workers.dev サブドメインは Free サイト ↗ として扱われ、ビジネスに必須でない個人プロジェクトや趣味向けです。
workers.dev サブドメインの形式は <YOUR_ACCOUNT_SUBDOMAIN>.workers.dev です。workers.dev サブドメインを変更するには、次の手順を実行します。
-
Cloudflare ダッシュボードで Workers & Pages ページを開きます。
Workers & Pages を開く ↗ -
Your subdomain の横の Change を選択します。
Worker は作成時または名前変更時に、<YOUR_WORKER_NAME>.<YOUR_SUBDOMAIN>.workers.dev の構文で workers.dev ルートが割り当てられます。Worker 設定の name フィールドが、デプロイした Worker のサブドメインになります。
有効なとき、workers.dev URL は公開されます。訪問者にサインインを求めてから workers.dev URL にアクセスさせるには、Cloudflare Access を使います。
Access は、1 つの Worker の本番 workers.dev URL、プレビュー URL、またはその両方を保護できます。アカウント内のすべての Worker、またはすべての Worker プレビューを保護することもできます。
Worker 内でサインイン中のユーザー情報を使うには、ctx.access を使います。検証済み JWT または /cdn-cgi/access/get-identity エンドポイントから、ユーザーの識別情報 を読むこともできます。
Worker の workers.dev ルートを無効にするには、次の手順を実行します。
-
Cloudflare ダッシュボードで Workers & Pages ページを開きます。
Workers & Pages を開く ↗ -
Overview で Worker を選択します。
-
Settings > Domains & Routes を開きます。
-
workers.devで Disable を選択します。 -
無効化することを確認します。
Worker の workers.dev ルートを無効にするには、Worker の Wrangler 設定ファイル に次を含めます。
{
"workers_dev": false
}workers_dev = falseこの変更で Worker を再デプロイすると、workers.dev ルートは無効になります。プレビュー URL は、明示的に設定しない限り workers_dev 設定に従います。プレビュー URL を明示的に有効にしている場合は、別途無効にします。
workers_dev = false を指定せずに Wrangler 設定ファイル へ routes コンポーネント を追加した場合、次のデプロイで workers_dev の値は false と推論されます。
workers.dev サブドメインを有効にして Worker をデプロイする場合、Worker 名は次の要件を満たす必要があります。
- 63 文字以下であること
- 英数字（
a-z、A-Z、0-9）とハイフン（-）のみであること - 先頭または末尾がハイフン（
-）でないこと
これらの制限は、Worker 名が workers.dev URL の DNS ラベルとして使われるためです。DNS ラベルの最大長は 63 文字で、先頭または末尾をハイフンにはできません。