R2

R2 是一種「物件儲存」（object storage，指專門用來存放大型檔案的服務，例如圖片、影片、備份、資料集）。你把檔案上傳上去，之後用名稱就能取回，完全不用自己管理硬碟。

你存進去的每個檔案叫做「物件（object）」，物件放在「儲存桶（bucket，可以想成一個有名字、像資料夾的容器）」裡。R2 還使用和 Amazon S3（全世界最熱門的物件儲存）一模一樣的介面（API），所以原本給 S3 用的工具和程式碼幾乎不用改就能直接套用。

傳統雲端儲存會收一筆「流出費（egress fee，也就是把資料從雲端「搬出去」給使用者所產生的費用）」。對於熱門的網站或 App，這筆突如其來的帳單甚至可能比儲存費還貴。R2 直接把它砍到零。

Wrangler 是 Cloudflare 的命令列工具（CLI，就是你在終端機裡輸入指令操作的程式）。下面的步驟會建立一個儲存桶、把它接到 Worker，並讀寫一個物件。

1. 安裝 Wrangler 並登入

   安裝工具，接著在它跳出的瀏覽器視窗登入你的 Cloudflare 帳號。

   bashcontent_copy複製

   npm install -g wrangler
   wrangler login

2. 建立儲存桶

   儲存桶名稱只能用小寫字母、數字和連字號（-），長度 3 到 63 個字元。

   bashcontent_copy複製

   wrangler r2 bucket create my-app-files
   wrangler r2 bucket list

3. 把儲存桶綁定到 Worker

   「綁定（binding）」會讓你的程式碼多一個變數（這裡叫 MY_BUCKET）來操作儲存桶。把這段加進 wrangler.jsonc。

   jsoncontent_copy複製

   {
     "r2_buckets": [
       {
         "binding": "MY_BUCKET",
         "bucket_name": "my-app-files"
       }
     ]
   }

4. 在程式碼裡讀寫物件

   PUT 請求會把內容存成物件；其他請求則用名稱把它讀回來。

   jscontent_copy複製

   export default {
     async fetch(request, env) {
       const key = new URL(request.url).pathname.slice(1);
   
       if (request.method === "PUT") {
         await env.MY_BUCKET.put(key, request.body);
         return new Response(`Uploaded ${key}!`);
       }
   
       const object = await env.MY_BUCKET.get(key);
       if (object === null) {
         return new Response("Object Not Found", { status: 404 });
       }
       return new Response(object.body);
     },
   };

5. 部署上線

   把你的 Worker 發布到 Cloudflare 的全球網路。

   bashcontent_copy複製

   wrangler deploy

• 儲存費為每 GB 每月 $0.015，存多少付多少。
• 流出費（把檔案傳給網路使用者）永遠是 $0——這是 R2 最大的賣點。
• 用像 uploads/2026/photo.jpg 這樣清楚的 key 前綴，就能像資料夾一樣整理物件。
• 幫儲存桶綁一個自訂網域，不用寫 Worker 也能公開提供檔案。