Trình quản lý tệp cho Cloudflare R2: kết nối với Nubbo

Nubbo kết nối với Cloudflare R2 bằng một API token của R2 và Account ID của tài khoản. Chỉ trong vài phút, các bucket của bạn sẽ nằm trong một trình khám phá tệp có tải lên trực tiếp, liên kết chia sẻ và thư viện ảnh. Hướng dẫn này đi theo từng bước của trình hướng dẫn Nubbo, với cả hai cách: tự động hoặc với khóa giới hạn cho một bucket.

Bạn nhận được gì

• Duyệt bucket như một ổ đĩa: thư mục, chế độ xem, tìm kiếm, thùng rác, nhãn và yêu thích.
• Tải tệp lên và tải xuống trực tiếp giữa trình duyệt của bạn và Cloudflare R2. Tệp không bao giờ đi qua máy chủ của Nubbo.
• Chia sẻ tệp và thư mục với mật khẩu, thời hạn và giới hạn lượt tải xuống, nhận tệp vào bucket và tạo thư viện ảnh.
• Khóa của bạn được lưu ở dạng mã hóa AES-256-GCM và bạn có thể ngắt kết nối bucket bất cứ lúc nào.

Trước khi bắt đầu

Bạn cần một tài khoản Cloudflare R2 và một tài khoản Nubbo. Mỗi bucket bạn kết nối được tính vào giới hạn gói của bạn: gói Miễn phí cho phép 2, Personal 5 và Pro không giới hạn. Trước bucket đầu tiên, Cloudflare yêu cầu bạn kích hoạt gói đăng ký R2 từ dashboard. Nếu bucket của bạn có khu vực pháp lý (EU, FedRAMP hoặc US), bạn chọn nó trong trình hướng dẫn và Nubbo dùng endpoint của khu vực pháp lý đó.

Chọn cách kết nối

Trình hướng dẫn của Nubbo có hai cách. Cả hai đều kết thúc giống nhau: bucket được kết nối và sẵn sàng để tải lên từ trình duyệt.

Khóa giới hạn là quyền truy cập tối thiểu Nubbo cần: Object Read & Write trên một bucket. Với khóa này Nubbo không thể liệt kê bucket hay tạo bucket mới, nên bạn nhập tên bucket và tự thêm quy tắc CORS.

Kết nối tự động

Bước 1: tạo khóa trong Cloudflare R2

1. Đăng nhập dash.cloudflare.com và mở R2 object storage. Bảng điều khiển có thể hiển thị menu bằng ngôn ngữ của bạn.
2. Mở API Tokens và nhấn Create Account API token. Bạn cũng có thể vào từ Overview, trong Account Details, Manage.
3. Chọn quyền Admin Read & Write và tạo token.
4. Sao chép Access Key ID và Secret Access Key. Cloudflare chỉ hiển thị secret một lần. Hãy dùng hai khóa này, không phải giá trị của token.
5. Sao chép cả Account ID, hiển thị trên trang Overview của R2.

Bước 2: kết nối bucket trong Nubbo

1. Trong Nubbo, mở Bucket và nhấn Kết nối bucket. Chọn Cloudflare R2 và nhấn Tiếp tục.

   

2. Chọn Tự động và nhấn Tiếp tục.

   

3. Ở bước Khóa của bạn, dán Access Key ID, Secret Access Key và Account ID. Nubbo tạo endpoint của tài khoản từ Account ID. Khu vực của R2 luôn là auto. Trước khi nhấn Kiểm tra khóa, hãy chọn Khu vực pháp lý của bucket: Mặc định (không có khu vực pháp lý) cho hầu hết bucket, hoặc EU, FedRAMP hay US. Endpoint thay đổi theo đó (https://<ACCOUNT_ID>.eu.r2.cloudflarestorage.com cho EU) và danh sách chỉ hiển thị bucket thuộc khu vực pháp lý đó. Nhấn Kiểm tra khóa. Nubbo kiểm tra rằng khóa hoạt động và có quyền truy cập toàn bộ tài khoản.

   

4. Chọn một bucket của bạn và nhấn Dùng bucket này, hoặc chọn Tạo mới, nhập tên (và chọn khu vực nếu được hỏi) rồi nhấn Tạo và chuẩn bị. Nubbo thêm vào bucket một quy tắc CORS chỉ cho phép tải lên và tải xuống từ ứng dụng, đồng thời giữ nguyên các quy tắc bucket đã có.

   

5. Xem lại ba mục kiểm tra, đổi Tên trong Nubbo nếu muốn và nhấn Hoàn tất. Bucket sẽ xuất hiện trong mục Bucket và bạn có thể mở nó trong trình khám phá.

   

Nếu Nubbo không thể thêm quy tắc CORS bằng khóa của bạn, trình hướng dẫn sẽ đưa bạn tới bước CORS. Khi đó hãy làm theo phần Thêm quy tắc CORS.

Kết nối với khóa giới hạn

Bước 1: chuẩn bị bucket và khóa trong Cloudflare R2

1. Trong R2, Overview, nhấn Create bucket và đặt tên (chữ thường, số và dấu gạch nối). Không có khu vực nào để chọn. Nếu dữ liệu phải ở lại EU, hãy chọn khu vực pháp lý EU: endpoint thay đổi theo đó.
2. Mở API Tokens và nhấn Create Account API token.
3. Chọn quyền Object Read & Write và giới hạn cho bucket của bạn.
4. Sao chép Access Key ID, Secret Access Key và Account ID của bạn.

Bước 2: kết nối bucket trong Nubbo

1. Trong Bucket, nhấn Kết nối bucket, chọn Cloudflare R2 rồi chọn Với khóa giới hạn.
2. Dán Access Key ID, Secret Access Key và Account ID. Trước khi nhấn Kiểm tra khóa, hãy chọn cùng Khu vực pháp lý với bucket. Nhấn Kiểm tra khóa.
3. Nhập chính xác tên bucket và nhấn Kiểm tra quyền truy cập.
4. Trình hướng dẫn chuyển sang bước CORS với quy tắc bạn cần thêm.

Thêm quy tắc CORS

Quy tắc CORS cho phép trình duyệt tải tệp lên và tải xuống từ bucket của bạn trên https://nubbo.app. Đây chính là quy tắc trình hướng dẫn hiển thị ở bước CORS.

1. Trong R2, mở bucket và vào Settings.
2. Trong CORS Policy, nhấn Add CORS policy và chọn tab JSON.
3. Dán quy tắc và nhấn Save. Cloudflare có thể mất tới 30 giây để áp dụng.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Sau khi lưu, hãy quay lại Nubbo và nhấn Đã thêm, kiểm tra. Nếu khóa của bạn có quyền thay đổi CORS, Thử cấu hình giúp tôi sẽ làm việc đó cho bạn.

Nếu có sự cố

Chi phí

R2 không tính phí egress và có hạn mức miễn phí hàng tháng. Chúng tôi giải thích trong Hạn mức miễn phí của Cloudflare R2.