Cloudflare Cursor Cloud Agents 自架怎麼做？Workers Containers 部署實作

先理解這個架構在解決什麼#

每個 Cursor session 會在一個獨立的 container 中執行。Cursor 仍是 agent 的控制平面，Cloudflare 則提供工作環境與生命週期：

Container 沒有 inbound port 或公開 IP，Worker 會透過 outbound connection 連到 Cursor。工作完成、閒置或超過生命週期時，container 會被停止；不要把這個執行環境當成長駐 VM。

部署前的 prerequisites#

先逐項確認，少一項就不適合直接進入 deploy：

• Cursor Enterprise，並已啟用 self-hosted machines。
• 一個 Cursor team service account 的 API key，且具備 agent scope。
• Cloudflare Workers Paid，帳號可使用 Containers 與 R2。
• Node.js 20 以上。
• 本機或部署流程中有正在執行的 Docker daemon。
• 若要操作 private repository，準備 GitHub username 與 token。

其中 Cursor Enterprise self-hosted machines 和 service-account key 是 Cursor 端資格；Workers Paid、Containers 與 R2 是 Cloudflare 端條件。兩邊都通過，session 才有地方執行。

用官方範本建立 Worker#

Cloudflare 官方教學使用 anysphere 的 cloudflare-workers repository。先在一個新的工作資料夾執行：

1
git clone https://github.com/anysphere/cloudflare-workers.git
2
cd cloudflare-workers
3
npm install
4
npx wrangler login

建立 snapshot 用的 R2 bucket：

1
npx wrangler r2 bucket create cursor-pool-worker-snapshots

再把 Cursor API key 放進 Worker secret。指令會要求你在互動提示中貼上 key，不要把真正的金鑰寫進 shell history 或 commit：

1
npx wrangler secret put CURSOR_API_KEY

完成後開啟範本的 Wrangler 設定，填入 Cursor team 的 pool 名稱：

1
vars:
2
  CURSOR_POOL: your-cursor-pool

同時確認 containers 設定的 max_instances 符合預期併發量。這個值不是單純的效能開關，也會影響同時啟動多少隔離工作環境；第一次上線先用小數字做 pilot。

如果 agent 需要 clone private repository，再設定 GitHub secrets。GitHub username 使用 x-access-token，token 則放在 GIT_TOKEN：

1
npx wrangler secret put GIT_USERNAME
2
npx wrangler secret put GIT_TOKEN

最後部署：

1
npx wrangler deploy

官方範本會依 Git remote 與 Cursor pool 做 repo-bound routing。不要手動新增 repo label 或自行改一套路由規則；先照範本的 team pool 與 Git remote 流程驗證，否則排錯時很難分辨是 Cursor 設定還是 Worker 自訂邏輯造成。

Repo-bound 和 any-repo 要先選清楚#

這個選擇會影響 workspace 初始化與 snapshot 行為：

Repo-bound workspace 預設會放在 container 的 $HOME/workspaces/repo-0。第一次啟動通常會 clone repository，因此 cache miss 或初次啟動較慢是正常現象。若使用 private repository，先確認 GIT_TOKEN 對目標 repository 有權限，再看 Worker log。

Snapshot 是選用功能，不是每個工作都必須開啟。若要讓公開 Worker URL 提供 snapshot 操作，還要設定 SNAPSHOT_AUTH_TOKEN 與 WORKER_PUBLIC_URL；先把 session 執行與 Git 權限跑通，再增加 snapshot 會比較容易控管風險。

觀測 session 與本機測試#

部署後先看 Worker log 和 Container 狀態：

1
npx wrangler tail
2
npx wrangler containers list

這個架構使用每五分鐘執行一次的 cron 機制檢查工作，並透過 SSE 接收更新。要在本機觸發排程，可先啟動：

1
npx wrangler dev --test-scheduled

再呼叫測試 endpoint：

1
curl "http://localhost:8787/__scheduled?cron=*/5+*+*+*+*"

建議把以下三段 log 放在同一個測試紀錄：

1. Cursor team pool 是否收到 session。
2. Worker 是否建立 Durable Object 與 container。
3. container 是否成功 clone repository、執行 agent worker 並回傳 SSE。

若只看最後的 Copilot 或 Cursor UI，很容易把「沒有分派到 pool」誤認成「container 啟動失敗」。

常見排錯順序#

先用公開、很小的 repository 做 smoke test，再測 private repository 和較大的工作。每次只改一個變數，並保留 pool、Worker、container 三側的時間戳，會比反覆重跑更快找到斷點。

給團隊的上線建議#

把這個部署當成 agent 執行平面，而不是自動合併程式碼的保證。repository 權限、Git token、container 的 outbound access 與 session idle policy 仍要依團隊標準治理。

第一階段可只開一個 Cursor pool 和低 max_instances，限定測試 repository；第二階段再加 private repository 與 snapshot；最後才擴大到正式團隊。若團隊原本已用 Git worktree 管理多個 agent 工作區，也可以先閱讀Git worktree 與 AI coding agent 的工作流整理，把分支與 workspace 邊界先定義好。

常見問題#