Backblaze B2 檔案管理工具：連接到 Nubbo

Nubbo 透過 Backblaze B2 的 S3 相容 API，以應用程式金鑰和你帳戶的區域進行連接。只要幾分鐘，你的儲存桶就會出現在檔案總管中，支援直接上傳、分享連結和相簿。這份指南會逐步帶你走過 Nubbo 連線精靈的兩種方式：自動，或使用僅限一個儲存桶的金鑰。

你會得到什麼

• 像使用雲端硬碟一樣瀏覽儲存桶：資料夾、檢視方式、搜尋、垃圾桶、標籤和最愛。
• 檔案直接在你的瀏覽器和 Backblaze B2 之間上傳和下載。檔案從不經過 Nubbo 的伺服器。
• 以密碼、到期日和下載次數限制分享檔案和資料夾，把檔案接收到你的儲存桶，還能建立相簿。
• 你的金鑰以 AES-256-GCM 加密儲存，你可以隨時中斷儲存桶的連線。

開始之前

你需要一個 Backblaze B2 帳戶和一個 Nubbo 帳戶。你連接的每個儲存桶都計入你的方案上限：免費方案可連接 2 個，Personal 5 個，Pro 則不限。在 B2 上，區域是在建立帳戶時選定的，並套用到帳戶的所有儲存桶。你可以在任一儲存桶的端點中看到它，格式類似 s3.<region>.backblazeb2.com：這就是你在 Nubbo 中要選擇的區域。帳戶的主金鑰無法用於 S3 API，所以請一律建立應用程式金鑰。

選擇連線方式

Nubbo 連線精靈提供兩種方式。兩者的結果相同：儲存桶完成連線，可以從瀏覽器上傳檔案。

自動連線

步驟 1：在 Backblaze B2 建立金鑰

1. 在 backblaze.com 上開啟 B2 Cloud Storage、Application Keys，然後按下 Add a New Application Key。不要使用主應用程式金鑰。
2. 為它取個名稱，將 Allow Access to Bucket(s) 設為 All，Type of Access 設為 Read and Write。按下 Create New Key。
3. 複製 keyID（存取金鑰）和 applicationKey（私密金鑰）。Backblaze 只會顯示 applicationKey 一次。
4. 在 Buckets 中查看任一儲存桶的端點，就能找到你的區域。

步驟 2：在 Nubbo 連接儲存桶

1. 在 Nubbo 中開啟 儲存桶，按下 連接儲存桶。選擇 Backblaze B2，然後按下 繼續。

   

2. 選擇 自動，然後按下 繼續。

   

3. 在 你的金鑰 步驟中貼上 keyID 和 applicationKey，並選擇你帳戶的區域。按下 檢查金鑰。Nubbo 會確認金鑰可用，且能存取整個帳戶。

   

4. 選擇你的其中一個儲存桶並按下 使用這個儲存桶，或選擇 新建，輸入名稱（如果有要求，再選擇區域），然後按下 建立並準備。Nubbo 會在儲存桶中新增一條 CORS 規則，只允許從應用程式上傳和下載，並保留原有的規則。

   

5. 檢查三項確認結果，視需要變更 在 Nubbo 中的名稱，然後按下 完成。儲存桶會出現在 儲存桶 頁面中，你可以在檔案總管中開啟它。

   

接著在儲存桶中開啟 Lifecycle Settings，選擇 Keep only the last version of the file。否則 B2 會保留每個版本，從 Nubbo 刪除也不會釋出空間。

如果 Nubbo 無法用你的金鑰新增 CORS 規則，連線精靈會帶你到 CORS 步驟。接著請依照 新增 CORS 規則 操作。

使用受限金鑰連線

步驟 1：在 Backblaze B2 準備儲存桶和金鑰

1. 在 Buckets 中按下 Create a Bucket，取個名稱並保持 Private。
2. 在儲存桶中開啟 Lifecycle Settings，選擇 Keep only the last version of the file。
3. 查看儲存桶的端點，找出區域。
4. 在 Application Keys 中按下 Add a New Application Key，以 Read and Write 將存取權限限制在你的儲存桶，並勾選 Allow List All Bucket Names。按下 Create New Key。
5. 複製 keyID 和 applicationKey。

步驟 2：在 Nubbo 連接儲存桶

1. 在 儲存桶 頁面中按下 連接儲存桶，選擇 Backblaze B2，再選擇 使用受限金鑰。
2. 貼上 keyID 和 applicationKey，並選擇區域。按下 檢查金鑰。
3. 輸入儲存桶的確切名稱，然後按下 檢查存取權限。
4. 連線精靈會進入 CORS 步驟，並顯示你需要新增的規則。

新增 CORS 規則

CORS 規則讓瀏覽器可以在 https://nubbo.app 上從你的儲存桶上傳和下載檔案。這和連線精靈在 CORS 步驟中顯示的規則相同。

B2 主控台中的 CORS 規則是預設範本，無法選擇操作，因此 Nubbo 的規則要透過 B2 命令列工具（b2）新增，並使用能變更儲存桶設定的金鑰。

1. 安裝 CLI，例如使用 pip install b2。
2. 以你的 keyID 和 applicationKey 登入：b2 account authorize。
3. 套用規則，把 your-bucket 換成儲存桶名稱。allPrivate 會讓儲存桶保持私人。

b2 bucket update --cors-rules '[{"corsRuleName":"nubbo","allowedOrigins":["https://nubbo.app"],"allowedOperations":["s3_get","s3_head","s3_put","s3_post","s3_delete"],"allowedHeaders":["*"],"exposeHeaders":["etag"],"maxAgeSeconds":3600}]' your-bucket allPrivate

套用後回到 Nubbo，按下 已新增，檢查。如果你的金鑰有變更 CORS 的權限，嘗試幫我設定 會替你完成。

如果出了問題

費用

Backblaze B2 按 TB 計費，提供 10 GB 免費空間，流出流量在儲存量三倍以內免費。我們在 Backblaze B2 定價 中說明。