Vercel から Workers への移行

このチュートリアルでは、Vercel アプリケーションを Cloudflare Workers へ移行する手順を説明します。

すでに Vercel にデプロイしたプロジェクトがあり、Cloudflare Workers でホストしたい場合を想定しています。Vercel 固有の機能は Cloudflare Workers ではサポートされません。サポート内容の詳細は、Workers の互換性マトリックス を確認してください。

Next.js、オンデマンドレンダリング付きの Astro など、一部のフレームワークには Cloudflare Workers への移行ガイドがあります。詳細は フレームワークガイド を参照してください。フレームワークに 既存プロジェクトを Workers にデプロイする ガイドがある場合は、その手順に従ってください。ない場合は、次の手順を続けます。

アプリケーションを Cloudflare Workers へ移すには、ビルドコマンドとビルドディレクトリが必要です。Cloudflare Workers はこの情報でアプリケーションをビルドしてデプロイします。Vercel ダッシュボードでの確認方法を次に説明します。

Vercel ダッシュボードで、Workers へ移行するプロジェクトを開きます。そのプロジェクトの Settings タブを開き、Build & Development settings パネルを探します。そこに Build Command と Output Directory があります。フレームワークを使っている場合、値が空でもフレームワークのデフォルトが表示されます。Cloudflare Workers へのデプロイ用に控えておきます。次の画像では、Build Command は npm run build、Output Directory は dist です。

プロジェクトのルートに wrangler.jsonc または wrangler.toml を作成します（wrangler.jsonc を推奨します）。内容は、デプロイするアプリケーションの種類（静的サイトかシングルページアプリケーションか）によって変わります。

いずれの場合も、<your-project-name> をプロジェクト名に、<your-build-directory> を Vercel のビルドディレクトリに置き換えます。パスも正しく設定してください。ビルドディレクトリが dist なら ./dist、build なら ./build です。

静的サイト の場合は、wrangler ファイルに次を追加します。

{
	"name": "<your-project-name>",
	// Set this to today's date
	"compatibility_date": "2026-09-20",
	"assets": {
		"directory": "<your-build-directory>",
	},
}

name = "<your-project-name>"
# Set this to today's date
compatibility_date = "2026-09-20"

[assets]
directory = "<your-build-directory>"

シングルページアプリケーション の場合は、not_found_handling フィールドを含む次の内容を wrangler ファイルに追加します。

{
	"name": "<your-project-name>",
	// Set this to today's date
	"compatibility_date": "2026-09-20",
	"assets": {
		"directory": "<your-build-directory>",
		"not_found_handling": "single-page-application",
	},
}

name = "<your-project-name>"
# Set this to today's date
compatibility_date = "2026-09-20"

[assets]
directory = "<your-build-directory>"
not_found_handling = "single-page-application"

一部のフレームワークには Cloudflare Workers への移行ガイドがあります。詳細は フレームワークガイド を参照してください。フレームワークに「既存プロジェクトを Workers にデプロイする」ガイドがある場合は、その詳細手順に従ってください。

アプリケーションには、Cloudflare Workers へビルドしてデプロイするための設定が揃っています。

新しい Worker を接続する ガイドに、GitHub プロジェクトを Cloudflare Workers へ接続する手順があります。設定ステップでは、ビルドコマンドが Vercel で確認したコマンドと同じであることを確認します。デプロイコマンドはデフォルトの npx wrangler deploy にしてください。

Workers のカスタムドメインは、アカウントでゾーンとして設定されているドメインだけをサポートします。ゾーンとは、Cloudflare が DNS とトラフィックを管理するドメイン（example.com など）です。

Workers プロジェクトにカスタムドメインを追加する 手順に従ってください。ドメイン用ゾーンの作成についても、そこに追加情報があります。

カスタムドメインを設定し、リクエストが Cloudflare Workers に届くようになったら、Vercel アプリケーションを安全に削除できます。

追加の移行手順は、Cloudflare Pages から Workers への移行ガイド を確認してください。Vercel 固有ではありませんが、役立つ追加ステップがあります。