Containers

Cloudflare Containers 讓你在 Cloudflare 的網路上執行一個完整的容器映像檔（container image，把作業系統、函式庫和檔案全部打包在一起），而且由你的 Worker 程式碼直接啟動和管理。

「容器（container）」是一個自給自足的盒子，裡面裝著一個應用程式，以及它執行所需要的一切。最常見的打包方式是用 Docker。當輕量的 Worker 做不到某些事時，容器就派上用場——例如你需要某個特定的程式語言、大量記憶體、多核心 CPU、或是一顆真正的硬碟。

Workers 又快又便宜，但它跑在一個記憶體有限、只支援少數語言的沙盒裡。有些工作就是需要更多資源。Containers 正好補上這個缺口——而且你不用學 Kubernetes，也不用自己架伺服器。

只要一項工作對單純的 Worker 來說太重、太特殊、或太「Linux」，就該考慮 Containers。

你用一個 Dockerfile 定義容器，在 wrangler.jsonc 裡讓 Worker 指向它，再用 Wrangler 部署。Cloudflare 會建置映像檔，並依需求啟動執行個體。（Containers 需要 Workers 付費方案。）

1. 用範本建立專案

   從 Cloudflare 官方的 containers 範本開始，裡面已經把 Dockerfile 和 Worker 接好了。

   bashcontent_copy複製

   npm create cloudflare@latest -- --template=cloudflare/templates/containers-template

2. 設定容器

   在 wrangler.jsonc 裡幫容器類別命名、指向你的 Dockerfile，並限制最多能同時跑幾個執行個體。

   jsonccontent_copy複製

   {
     "name": "my-container-app",
     "main": "src/index.js",
     "compatibility_date": "2025-05-23",
     "containers": [
       {
         "class_name": "MyContainer",
         "image": "./Dockerfile",
         "max_instances": 10
       }
     ],
     "durable_objects": {
       "bindings": [
         { "name": "MY_CONTAINER", "class_name": "MyContainer" }
       ]
     },
     "migrations": [
       { "tag": "v1", "new_sqlite_classes": ["MyContainer"] }
     ]
   }

3. 部署

   Wrangler 會建置你的映像檔、推送上去並上線。執行個體會依需求啟動，閒置時自動休眠。

   bashcontent_copy複製

   npx wrangler deploy

import { Container, getContainer } from "@cloudflare/containers";

export class MyContainer extends Container {
  // The port your container app listens on
  defaultPort = 8080;
  // Put the container to sleep after 10 minutes idle
  sleepAfter = "10m";
}

export default {
  async fetch(request, env) {
    // Get (or start) a container instance and forward the request to it
    const container = getContainer(env.MY_CONTAINER);
    return container.fetch(request);
  },
};

執行個體規格

• lite — 1/16 vCPU、256 MiB 記憶體、2 GB 硬碟
• basic — 1/4 vCPU、1 GiB 記憶體、4 GB 硬碟
• standard-1 — 1/2 vCPU、4 GiB 記憶體、8 GB 硬碟
• standard-2 — 1 vCPU、6 GiB 記憶體、12 GB 硬碟
• standard-3 — 2 vCPU、8 GiB 記憶體、16 GB 硬碟
• standard-4 — 4 vCPU、12 GiB 記憶體、20 GB 硬碟