Menambahkan S3 Channel

Paling Cocok Untuk

Gunakan S3 channel saat:

• Anda ingin menghubungkan object storage service yang kompatibel dengan S3, seperti Cloudflare R2, Backblaze B2, MinIO, AWS S3, atau provider lain yang compatible.
• Anda lebih nyaman dengan model konfigurasi S3 standar: Endpoint, Access Key, dan Secret Key.
• Anda tidak ingin memakai native Cloudflare R2 binding channel, atau storage provider Anda bukan Cloudflare R2.

Yang Perlu Disiapkan Sebelum Mulai

Requirement	Purpose
S3 Endpoint	S3 API endpoint dari 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 opsional untuk file access.

Contoh Cloudflare R2 lewat 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 Menambahkannya

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

Field Reference

Field	Fungsi	Required
Channel name	Nama yang mudah dikenali untuk S3 channel, misalnya s3test atau R2-S3.	Yes
Enable channel	Mengontrol apakah channel ini ikut dalam upload selection.	Recommended
Endpoint	Full S3 service endpoint, termasuk https://.	Yes
Custom CDN domain	Optional. Jika diisi, generated file links akan memprioritaskan domain ini.	No
Bucket name	Bucket name, misalnya 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. Beberapa MinIO, OpenList, atau self-hosted S3 services mungkin memerlukannya.	No
Quota limit	Mengontrol apakah S3 channel ini ikut upload selection berdasarkan capacity.	No
Capacity limit	Required setelah quota limit aktif, misalnya 10 GB.	Required saat quota limit aktif
Threshold	Menghentikan penulisan setelah usage mencapai percentage ini, misalnya 90%.	Required saat quota limit aktif
Remark	Catatan untuk maintenance sendiri.	No

Membuat Cloudflare R2 S3 API Keys

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


4. Buat R2 API token yang dapat mengakses target bucket.

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

6. Kembali ke halaman R2 bucket dan pastikan bucket name.
7. Catat S3 API endpoint untuk account. Biasanya berbentuk:

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, misalnya s3test.
5. Masukkan S3 API endpoint di Endpoint.
6. Jika memakai custom CDN, masukkan di 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 secara eksplisit memerlukannya.
11. Jika ingin capacity control, aktifkan quota limit lalu masukkan capacity limit dan threshold.
12. Klik Save.

Cara Memeriksa

Check	Cara Memeriksa
Channel card muncul	Setelah save, halaman Upload Settings harus menampilkan S3 channel card.
Channel enabled	Switch di kanan atas card seharusnya tetap on.
Key fields tersimpan	Detail view harus menampilkan Endpoint, Bucket, Region, path-style access, dan field terkait.
Upload berjalan	Upload test image dan pastikan object muncul di target bucket.
Link terbuka	Image link yang dikembalikan setelah upload harus terbuka normal.
Capacity display berjalan	Jika quota limit aktif, card harus menunjukkan used capacity dan configured limit.

S3 capacity statistics dihitung dari local file records ImgBed, bukan dengan query provider bucket secara real time. Setelah S3 configuration disimpan, system akan menghitung ulang quota ledger dari current D1 records.

FAQ

Perlukah mengaktifkan path-style access?

Biasanya tidak.

Aktifkan hanya jika S3-compatible provider tidak mendukung virtual-hosted-style URLs, atau dokumentasi provider secara eksplisit meminta path-style access. Beberapa MinIO, self-hosted S3, dan OpenList-compatible endpoints mungkin memerlukannya.

CDN domain untuk apa?

Jika Anda menaruh CDN atau custom access domain di depan bucket, masukkan di sini.

Setelah dikonfigurasi, generated file links akan memprioritaskan domain ini. Jika tidak memakai CDN, biarkan kosong.

Mengapa upload gagal?

Periksa hal-hal ini terlebih dahulu:

1. Endpoint berisi full https:// URL.
2. Bucket name benar.
3. Region sesuai requirement provider.
4. Access Key ID dan Secret Access Key disalin lengkap.
5. Key punya write permission untuk target bucket.
6. Provider tidak memerlukan path-style access, atau path-style access sudah diaktifkan jika diperlukan.

Quick Checklist

Siapkan 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 cek hasilnya