ガイド

Cloudflare Wranglerの使い方｜導入からデプロイまで

2026年7月21日公開 🔬 最終検証日: 2026-07-21

結論、Cloudflare WorkersをCLIから操作するにはWranglerが必須です。インストール→ログイン→ローカル確認→デプロイの4手順を押さえれば、最短でエッジ環境にコードを公開できます。

Wranglerとは何か

Wranglerは、Cloudflare Workers(サーバーを自分で用意せずにコードをエッジで実行できるサービス)を操作するための公式CLIツールです。プロジェクトの雛形作成、ローカルでの動作確認、本番環境へのデプロイ、環境変数やKV(キーバリューストア)などの管理まで、Workersに関する操作の大半をWranglerひとつで完結できます。Cloudflare WorkersそのものについてはCloudflare Workers無料枠でどこまで作れるかで無料枠の上限を整理しているので、先に全体像をつかみたい場合はあわせて確認してください。

事前準備

Wranglerを使うには次の2つが必要です。

Node.js環境: npmまたはnpxが使えること(2026年7月時点でWranglerが要求するNode.jsのバージョンは公式ドキュメントのWrangler Install/Updateで確認できます)
Cloudflareアカウント: 無料枠のままでも利用開始できます

Wrangler自体はグローバルインストールせず、プロジェクトごとにnpx wrangler経由で呼び出す使い方が公式に推奨されています。バージョン差異によるトラブルを避けやすいためです。

インストールから初期化まで

手順は次の4ステップです。

プロジェクト用のディレクトリでWranglerを初期化する
Cloudflareアカウントにログインする
ローカルで動作確認する(wrangler dev)
本番環境へデプロイする(wrangler deploy)

1. プロジェクトの作成

npx wrangler init my-worker

対話形式で、TypeScript/JavaScriptの選択やテンプレートの選択を聞かれます。作成されるとwrangler.toml(またはwrangler.jsonc)という設定ファイルと、src/index.tsなどのエントリーファイルが生成されます。wrangler.tomlにはWorkerの名前や実行環境の設定が書かれており、以降の操作はこのファイルを起点に行われます。

2. ログイン(認証)

npx wrangler login

ブラウザが自動で開き、Cloudflareアカウントでの認証を求められます。認証が完了するとWrangler側にトークンが保存され、以降のコマンドでCloudflareアカウントの情報を参照できるようになります。ログイン状態は次のコマンドで確認できます。

npx wrangler whoami

3. ローカルで動作確認する

npx wrangler dev

ローカルにサーバーが立ち上がり、表示されたURL(通常http://localhost:8787)にアクセスするとコードの動作を確認できます。実際にCloudflareのエッジにデプロイする前に、この段階でリクエスト・レスポンスの挙動やエラーの有無を確認しておくと、本番反映後の手戻りを減らせます。

4. デプロイする

npx wrangler deploy

実行すると、コードがCloudflareのエッジ環境に反映され、https://my-worker.<サブドメイン>.workers.devのようなURLで公開されます。デプロイは即座に本番環境へ反映される操作のため、wrangler devでの確認を済ませてから実行するのが安全です。

よく使う設定・コマンド

環境変数の設定: wrangler.tomlの[vars]に平文の設定値を書けます。APIキーなど秘匿したい値はwrangler secret put <名前>で暗号化して登録し、コードやリポジトリに直接書かないようにします
KV(キーバリューストア)の紐付け: wrangler kv namespace create <名前>で作成した名前空間IDをwrangler.tomlの[[kv_namespaces]]に登録して使います
ログの確認: wrangler tailでデプロイ済みWorkerのリアルタイムログをターミナルに流せます。本番で想定外の挙動が出たときの一次切り分けに使えます
Workerの削除: wrangler deleteで検証用に作ったWorkerを消せます

つまずきやすいポイント

wrangler.tomlの設定ミス: nameやルーティング設定が誤っていると、意図しないWorker名でデプロイされたり、期待したURL・ドメインにルーティングされなかったりします。デプロイ前に設定ファイルの内容を見直す習慣をつけると防ぎやすいです
秘匿情報を[vars]に書いてしまう: [vars]は平文で扱われるため、APIキーなどはこちらではなくwrangler secret putで登録します。誤って平文で登録した場合はリポジトリの履歴にも残るため、値自体を再発行する対応が必要になります
ローカルとエッジでの挙動差: wrangler devのローカル実行環境は、実際のエッジ環境と完全に同一ではありません。特に外部APIとの通信や地理的な条件に依存する処理は、デプロイ後に別の挙動を示すことがあるため、重要な変更は本番相当の環境でも確認しておくと安心です
無料枠の上限に気づかず開発を進める: リクエスト数やCPU時間には日次の上限があります。上限や具体的な数値はCloudflare Workers無料枠でどこまで作れるかで整理しているので、開発規模が大きくなってきたら一度目を通しておくと想定外のエラーに慌てずに済みます
アカウント・環境の切り替え漏れ: 検証用アカウントと本番用アカウントを併用していると、意図しない環境にデプロイしてしまうことがあります。wrangler whoamiで認証中のアカウントを確認してからデプロイする癖をつけると事故を防ぎやすいです

料金の考え方

Wrangler自体はオープンソースの無料ツールで、CLIの利用に料金はかかりません(2026年7月時点)。料金が関わるのはデプロイ先のCloudflare Workers側のプランです。Workers Freeプラン(無料枠)であればリクエスト数やCPU時間などに日次上限はあるものの、個人開発や小規模な検証であれば料金をかけずにWranglerでの開発・デプロイを一通り試せます。有料のWorkers Paidプランは月額5ドル程度から用意されており(2026年7月時点)、無料枠の上限に近づいた段階で検討する位置づけです。プランの上限や切り替えの目安はCloudflare Workers無料枠でどこまで作れるかで詳しく解説しています。

向いていない人

サーバーサイドの開発経験がなく、CLI操作自体に不慣れな人: Wranglerはコマンドラインでの操作が前提のツールです。GUIだけで完結させたい場合は、Cloudflareダッシュボードからのコード編集・デプロイ機能の方が最初のハードルは低くなります
常時接続や長時間ジョブが中心の処理を組みたい人: Wranglerで開発・デプロイする先のCloudflare Workersは、リクエスト単位で短時間に処理を終える設計に向いています。常駐プロセスが必要な自動化には、自動化に向くVPS比較のようにVPS側を選ぶ方が実装が素直になることがあります
チームでの権限管理やCI/CD連携を最初から厳密に組みたい人: Wrangler単体でもwrangler.tomlをGit管理してCI経由でデプロイする構成は可能ですが、アカウント・トークンの権限分離やレビューフローの整備には別途設計が必要です。個人での検証から始めて、必要になったタイミングで権限周りを整える進め方が現実的です

FAQ

Q. WranglerとCloudflare Workersはどう違いますか？ A. Cloudflare Workersはコードをエッジで実行するサービス本体、Wranglerはそのコードを作成・テスト・デプロイするためのCLIツールです。Workersを使う場合、基本的にはWranglerか、それに相当する仕組み(ダッシュボードからの手動デプロイ等)を経由します。

Q. Wranglerの利用自体に料金はかかりますか？ A. Wrangler自体はオープンソースの無料ツールで、利用に料金はかかりません(2026年7月時点)。料金が発生するのはデプロイ先のCloudflare Workers側のプラン(無料枠か有料プランか)です。

Q. wrangler devとwrangler deployの違いは何ですか？ A. wrangler devはローカル環境で開発中のコードを起動し、ブラウザやcurlから動作確認するためのコマンドです。wrangler deployは実際にCloudflareのエッジ環境へコードを反映させるコマンドで、実行すると本番URLに変更が公開されます。

Q. デプロイしたWorkerを削除するにはどうすればいいですか？ A. wrangler delete コマンドでデプロイ済みのWorkerを削除できます。誤ってデプロイした検証用のWorkerは、放置せずに削除しておくと無料枠の消費や管理対象の混乱を避けやすいです。

まとめ

Wranglerの基本操作は「初期化(wrangler init) → ログイン(wrangler login) → ローカル確認(wrangler dev) → デプロイ(wrangler deploy)」の4手順に集約されます。ツール自体は無料で、料金が関わるのはデプロイ先のCloudflare Workersのプラン側です。まずは無料枠の範囲で1つのWorkerを最後まで動かしてみて、開発規模が大きくなってきたらCloudflare Workers無料枠でどこまで作れるかで上限を確認し、常駐プロセスが必要になった場合は自動化に向くVPS比較も選択肢として検討してください。