• 設定指南
  • 約 5 分鐘

如何上傳檔案到 Cloudflare R2 並分享連結

大約一分鐘就能把 Cloudflare R2 接上 Aktar:貼上一個 API 權杖,Aktar 就會幫你建立儲存貯體、開啟公開連結並儲存目的地。

Cloudflare R2 和 Aktar 是絕佳組合:沒有傳出流量費用,免費額度包含 10 GB,自訂網域還能透過 Cloudflare 的網路提供服務。你不必從主控台拷貝帳號 ID、儲存貯體名稱和兩組金鑰:設定 Cloudflare R2…只需要一個 API 權杖,透過會自動填好權限的連結建立,其餘都由它完成。想全部手動設定?請看最後一個步驟。

事前準備

  • 一個 Cloudflare 帳號(R2 的免費額度包含 10 GB)
  • 如果想讓連結使用自己的網域,需要一個託管在 Cloudflare 上的網域(選用)
  • Mac、Windows、iPhone、iPad 或 Android 版 Aktar

操作步驟

  1. 開啟「設定 Cloudflare R2」

    在 Aktar 的設定中打開目的地,選擇設定 Cloudflare R2…。還沒有任何目的地時,它就是主要按鈕。然後按一下開啟 Cloudflare。

  2. 建立 API 權杖

    Cloudflare 的權杖頁面會開啟,名稱已填為 Aktar,並已選好兩項權限:R2 Storage: Edit,用來建立儲存貯體並上傳檔案;Zone: Read,用來列出你的網域以設定公開連結。選擇 Continue to summary,再選擇 Create Token,然後拷貝權杖。

  3. 貼上並選擇

    把權杖貼到 Aktar。如果你有多個帳號,先選擇帳號,再選擇儲存貯體:建立新的(Aktar 建議使用 aktar)或使用既有的。最後選擇公開連結的指向:

    • 儲存貯體的 r2.dev 位址立即可用。Cloudflare 會對它限速,所以最適合用來試用。
    • 你 Cloudflare 帳號下某個網域的子網域,例如 files.example.com,適合正式使用。Cloudflare 會加入 DNS 記錄和憑證,需要幾分鐘。
  4. 設定

    按一下設定。Aktar 會建立儲存貯體、開啟公開連結、儲存目的地,並自動執行測試連線。使用你自己的網域時,連結路徑非常簡潔,例如 files.example.com/A7kdP2x.png(請參閱短連結)。選擇完成,或選擇編輯修改任何設定,然後把第一個檔案丟到 Aktar 上。

  5. 想手動設定?

    如果你想改用只限單一儲存貯體的 R2 權杖:在 Cloudflare 主控台中打開 R2 Object Storage 並建立一個儲存貯體。在儲存貯體的 Settings 中,於 Custom Domains 下連接自訂網域,或啟用 Public Development URL。接著在 Manage API tokens 中,為該儲存貯體建立具有 Object Read & Write 權限的權杖,拷貝 Access Key ID 和 Secret Access Key(密鑰只會顯示一次)。在 Aktar 中選擇加入目的地,再選擇 Cloudflare R2,依照下表填寫各欄位。

Aktar 中的設定

在「設定 → 目的地 → 加入目的地」中輸入以下值。欄位名稱與 App 中一致。

欄位範例值說明
服務供應商Cloudflare R2
目的地名稱Personal取任何你喜歡的名稱。
帳號 ID3f9a71c0e2b8…顯示在 R2 概覽頁面。
區域auto保留預設值。
存取金鑰 IDa1b2c3d4…來自 R2 API 權杖。
私密存取金鑰••••••••儲存在鑰匙圈或認證管理員中。
儲存貯體screenshots
公開基礎 URLfiles.example.com你的自訂網域或 r2.dev URL。
物件路徑{short}.{ext}選用,請參閱檔案名稱和資料夾。

小技巧

  • Aktar 不會保留權杖。它會把權杖轉換成 S3 金鑰(權杖的 ID 就是存取金鑰,權杖值的雜湊就是密鑰),像其他目的地的金鑰一樣儲存,然後捨棄權杖。想切斷 Aktar 的存取時,隨時可以在 Cloudflare 刪除該權杖。
  • 自訂網域會經過 Cloudflare 快取,熱門連結在全球都能快速載入,而且不需額外費用。
  • 在一部裝置上設定好,再用分享到其他裝置把目的地連同金鑰帶到你的其他電腦和手機。
  • 想讓上傳項目在 1 到 30 天後自動刪除?只要金鑰有權管理生命週期規則(「設定 Cloudflare R2」產生的金鑰或 Admin Read & Write 權杖都可以),Aktar 就會幫你加上儲存貯體的生命週期規則。若使用 Object Read & Write 權杖,請在儲存貯體 Settings 的 Object Lifecycle Rules 中自行加入。請參閱會到期的上傳項目。

疑難排解

「設定」顯示公開連結還無法使用

剛連接你自己的網域時,Cloudflare 仍在加入 DNS 記錄和憑證。請等幾分鐘,再從該目的地的選單重新執行測試連線。

「設定」找不到這個權杖對應的帳號

建立權杖時沒有授予任何帳號的存取權。請從「開啟 Cloudflare」重新建立,並在 Account Resources 下保留它提供的帳號(或 All accounts)。

連結傳回 Access Denied 或 403

確認公開基礎 URL 是你的自訂網域或 r2.dev URL。…r2.cloudflarestorage.com 端點只供 API 使用,永遠不會公開提供檔案。詳情請參閱 Access Denied 錯誤。

「測試連線」顯示憑證無效

如果是手動設定,請使用 R2 API 權杖的 Access Key ID 和 Secret Access Key,而不是一般的 Cloudflare API 權杖或 Global API Key,並檢查帳號 ID 是否有多餘的空格。

上傳正常,但連結很慢或被限速

你可能正在使用 r2.dev 開發用 URL。正式使用時請連接自訂網域。