Tambah S3 Channel

Paling Sesuai Untuk

Gunakan S3 channel apabila:

• Anda mahu menyambungkan mana-mana S3-compatible object storage service seperti Cloudflare R2, Backblaze B2, MinIO, AWS S3 atau provider lain yang compatible.
• Anda lebih suka model konfigurasi S3 standard: Endpoint, Access Key dan Secret Key.
• Anda tidak mahu menggunakan native Cloudflare R2 binding channel, atau storage provider anda bukan Cloudflare R2.

Perkara Yang Perlu Disediakan

Requirement	Purpose
S3 Endpoint	S3 API endpoint untuk object storage service.
Bucket name	Bucket tempat files disimpan.
Region	Storage region. Untuk Cloudflare R2, biasanya auto.
Access Key ID	S3 access key ID.
Secret Access Key	S3 secret access key.
CDN domain	Custom domain pilihan untuk file access.

Contoh Cloudflare R2 melalui S3 API:

Endpoint: https://your-account-id.r2.cloudflarestorage.com
Bucket: your-r2-bucket-name
Region: auto
Access Key ID: copied from the Cloudflare R2 API token
Secret Access Key: copied from the Cloudflare R2 API token

Di Mana Untuk Menambahnya

1. Buka System Settings.
2. Pergi ke Upload Settings.
3. Klik Add Channel di penjuru kanan atas.
4. Pilih S3.

Field Reference

Field	Fungsi	Required
Channel name	Nama mudah dikenali untuk S3 channel, contohnya s3test atau R2-S3.	Yes
Enable channel	Mengawal sama ada channel ini terlibat dalam upload selection.	Recommended
Endpoint	Full S3 service endpoint termasuk https://.	Yes
Custom CDN domain	Optional. Apabila ditetapkan, generated file links akan mengutamakan domain ini.	No
Bucket name	Bucket name, contohnya s3test atau img-r2.	Yes
Bucket region	Region. Untuk Cloudflare R2 biasanya auto.	Yes
Access Key ID	S3 access key ID.	Yes
Secret Access Key	S3 secret access key.	Yes
Path-style access	Compatibility switch. Default off. Sesetengah MinIO, OpenList atau self-hosted S3 services mungkin memerlukannya.	No
Quota limit	Mengawal sama ada S3 channel ini terlibat dalam upload selection berdasarkan capacity.	No
Capacity limit	Required selepas quota limit diaktifkan, contohnya 10 GB.	Required apabila quota limit diaktifkan
Threshold	Berhenti menulis apabila usage mencapai percentage ini, contohnya 90%.	Required apabila quota limit diaktifkan
Remark	Nota untuk penyelenggaraan sendiri.	No

Cipta Cloudflare R2 S3 API Keys

1. Buka Cloudflare Dashboard.
2. Pergi ke R2 Object Storage.
3. Cari Manage R2 API Tokens atau entry pengurusan API token.


4. Cipta R2 API token yang boleh mengakses target bucket.

5. Copy Access Key ID dan Secret Access Key yang dijana.

6. Kembali ke halaman R2 bucket dan sahkan bucket name.
7. Catat S3 API endpoint untuk account. Biasanya kelihatan seperti:

https://your-account-id.r2.cloudflarestorage.com

Langkah Setup

1. Buka Upload Settings.
2. Klik Add Channel.
3. Pilih S3.
4. Masukkan channel name yang mudah dikenali, contohnya s3test.
5. Masukkan S3 API endpoint dalam Endpoint.
6. Jika anda menggunakan custom CDN, masukkan dalam Custom CDN domain; jika tidak, biarkan kosong.
7. Masukkan bucket name.
8. Masukkan region. Untuk contoh Cloudflare R2, gunakan auto.
9. Masukkan Access Key ID dan Secret Access Key.
10. Biarkan path-style access off kecuali provider menyatakan ia diperlukan.
11. Jika mahu capacity control, enable quota limit dan masukkan capacity limit serta threshold.
12. Klik Save.

Cara Menyemak

Check	Cara Menyemak
Channel card muncul	Selepas save, halaman Upload Settings patut memaparkan S3 channel card.
Channel enabled	Switch di penjuru kanan atas card patut kekal on.
Key fields disimpan	Detail view patut memaparkan Endpoint, Bucket, Region, path-style access dan field berkaitan.
Upload berfungsi	Upload test image dan pastikan object muncul dalam target bucket.
Link dibuka	Image link yang diberi selepas upload patut dibuka secara normal.
Capacity display berfungsi	Jika quota limit diaktifkan, card patut menunjukkan used capacity dan configured limit.

S3 capacity statistics dikira daripada local file records ImgBed, bukan dengan query provider bucket secara real time. Selepas S3 configuration disimpan, system akan recalculate quota ledger daripada current D1 records.

FAQ

Patutkah path-style access diaktifkan?

Biasanya tidak.

Aktifkan hanya apabila S3-compatible provider tidak menyokong virtual-hosted-style URLs, atau documentation provider jelas memerlukan path-style access. Sesetengah MinIO, self-hosted S3 dan OpenList-compatible endpoints mungkin memerlukannya.

CDN domain digunakan untuk apa?

Jika anda meletakkan CDN atau custom access domain di hadapan bucket, masukkan di sini.

Selepas dikonfigurasi, generated file links akan mengutamakan domain ini. Jika tidak menggunakan CDN, biarkan kosong.

Mengapa upload gagal?

Semak perkara ini dahulu:

1. Endpoint mengandungi full https:// URL.
2. Bucket name betul.
3. Region sepadan dengan requirement provider.
4. Access Key ID dan Secret Access Key disalin lengkap.
5. Key mempunyai write permission untuk target bucket.
6. Provider tidak memerlukan path-style access, atau path-style access telah diaktifkan jika perlu.

Quick Checklist

Sediakan S3 Endpoint, Bucket, Region, Access Key dan Secret Key
-> Buka Upload Settings
-> Add Channel
-> Pilih S3
-> Masukkan Endpoint / Bucket / Region / Access Key / Secret Key
-> Masukkan CDN domain jika perlu
-> Biarkan path-style access off secara default
-> Aktifkan quota limit jika perlu
-> Save
-> Upload test image dan semak hasilnya