S3 Kanalı Ekleme

Ne Zaman Uygun?

S3 kanalını şu durumlarda kullanın:

• Cloudflare R2, Backblaze B2, MinIO, AWS S3 veya başka bir uyumlu sağlayıcı gibi S3 uyumlu herhangi bir nesne depolama hizmetini bağlamak istiyorsanız.
• Standart S3 yapılandırma modelini tercih ediyorsanız: Endpoint, Access Key ve Secret Key.
• Yerel Cloudflare R2 binding kanalını kullanmak istemiyorsanız veya depolama sağlayıcınız Cloudflare R2 değilse.

Başlamadan Önce Gerekenler

Gereken	Ne için kullanılır
S3 Endpoint	Nesne depolama hizmetinin S3 API endpoint adresi.
Bucket adı	Dosyaların saklanacağı bucket.
Region	Depolama bölgesi. Cloudflare R2 için genellikle auto.
Access Key ID	S3 erişim anahtarı ID değeri.
Secret Access Key	S3 gizli erişim anahtarı.
CDN domain	Dosya erişimi için isteğe bağlı özel alan adı.

Cloudflare R2'yi S3 API üzerinden kullanma örneği:

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

Nereden Eklenir?

1. Sistem Ayarları'nı açın.
2. Yükleme Ayarları'na gidin.
3. Sağ üst köşedeki Add Channel düğmesine tıklayın.
4. S3 seçeneğini seçin.

Alan Açıklamaları

Alan	Ne işe yarar	Zorunlu
Kanal adı	Bu S3 kanalı için anlaşılır bir ad, örneğin s3test veya R2-S3.	Evet
Enable channel	Bu kanalın yükleme seçiminde kullanılıp kullanılmayacağını belirler.	Önerilir
Endpoint	https:// dahil tam S3 servis endpoint adresi.	Evet
Custom CDN domain	İsteğe bağlıdır. Girilirse oluşturulan dosya bağlantıları bu alan adını tercih eder.	Hayır
Bucket name	Bucket adı, örneğin s3test veya img-r2.	Evet
Bucket region	Bölge. Cloudflare R2 için genellikle auto.	Evet
Access Key ID	S3 erişim anahtarı ID değeri.	Evet
Secret Access Key	S3 gizli erişim anahtarı.	Evet
Path-style access	Uyumluluk anahtarıdır. Varsayılan olarak kapalıdır. Bazı MinIO, OpenList veya self-hosted S3 servisleri gerektirebilir.	Hayır
Quota limit	Bu S3 kanalının kapasiteye göre yükleme seçiminde dikkate alınıp alınmayacağını belirler.	Hayır
Capacity limit	Quota limit etkinleştirildikten sonra gerekir, örneğin 10 GB.	Quota limit açıksa evet
Threshold	Kullanım bu yüzdeye ulaşınca yazmayı durdurur, örneğin 90%.	Quota limit açıksa evet
Remark	Kendi bakım notlarınız.	Hayır

Cloudflare R2 S3 API Anahtarları Oluşturma

1. Cloudflare Dashboard'u açın.
2. R2 Object Storage bölümüne gidin.
3. Manage R2 API Tokens veya API token yönetimi girişini bulun.


4. Hedef bucket'a erişebilen bir R2 API token oluşturun.

5. Oluşturulan Access Key ID ve Secret Access Key değerlerini kopyalayın.

6. R2 bucket sayfasına dönün ve bucket adını doğrulayın.
7. Hesap için S3 API endpoint adresini not edin. Genellikle şu biçimdedir:

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

Kurulum Adımları

1. Yükleme Ayarları'nı açın.
2. Add Channel düğmesine tıklayın.
3. S3 seçeneğini seçin.
4. Tanıyabileceğiniz bir kanal adı girin, örneğin s3test.
5. Endpoint alanına S3 API endpoint adresini girin.
6. Özel CDN kullanıyorsanız Custom CDN domain alanına girin; kullanmıyorsanız boş bırakın.
7. Bucket adını girin.
8. Region değerini girin. Cloudflare R2 örneği için auto kullanın.
9. Access Key ID ve Secret Access Key değerlerini girin.
10. Sağlayıcınız özellikle gerektirmiyorsa path-style access kapalı kalsın.
11. Kapasite kontrolü istiyorsanız quota limit'i etkinleştirip capacity limit ve threshold girin.
12. Save düğmesine tıklayın.

Nasıl Kontrol Edilir?

Kontrol	Nasıl doğrulanır
Kanal kartı görünür	Kaydettikten sonra Yükleme Ayarları sayfasında S3 kanal kartı görünmelidir.
Kanal etkindir	Kartın sağ üst köşesindeki anahtar açık kalmalıdır.
Temel alanlar kaydedilmiştir	Ayrıntı görünümünde Endpoint, Bucket, Region, path-style access ve ilgili alanlar görünmelidir.
Yükleme çalışır	Test görseli yükleyin ve nesnenin hedef bucket içinde göründüğünü doğrulayın.
Bağlantı açılır	Yüklemeden sonra dönen görsel bağlantısı normal şekilde açılmalıdır.
Kapasite gösterimi çalışır	Quota limit etkinse kart kullanılan kapasiteyi ve yapılandırılan limiti göstermelidir.

S3 kapasite istatistikleri sağlayıcı bucket'ını gerçek zamanlı sorgulayarak değil, ImgBed'in yerel dosya kayıtlarından hesaplanır. S3 yapılandırması kaydedildikten sonra sistem mevcut D1 kayıtlarından kota defterini yeniden hesaplar.

FAQ

Path-style access etkinleştirilmeli mi?

Genellikle hayır.

Yalnızca S3 uyumlu sağlayıcınız virtual-hosted-style URL desteklemiyorsa veya sağlayıcı belgeleri açıkça path-style access istiyorsa etkinleştirin. Bazı MinIO, self-hosted S3 ve OpenList uyumlu endpoint'lerde gerekebilir.

CDN domain ne işe yarar?

Bucket önünde CDN veya özel erişim alan adı kullanıyorsanız buraya girin.

Yapılandırıldıktan sonra oluşturulan dosya bağlantıları bu alan adını tercih eder. CDN kullanmıyorsanız boş bırakın.

Yükleme neden başarısız olur?

Önce şunları kontrol edin:

1. Endpoint tam https:// URL'sini içeriyor.
2. Bucket adı doğru.
3. Region sağlayıcı gereksinimiyle uyumlu.
4. Access Key ID ve Secret Access Key eksiksiz kopyalandı.
5. Anahtarın hedef bucket'a yazma izni var.
6. Sağlayıcı path-style access gerektirmiyor veya gerekiyorsa etkinleştirildi.

Kısa Kontrol Listesi

S3 Endpoint, Bucket, Region, Access Key ve Secret Key hazırla
-> Yükleme Ayarları'nı aç
-> Kanal ekle
-> S3 seç
-> Endpoint / Bucket / Region / Access Key / Secret Key gir
-> Gerekirse CDN domain gir
-> Varsayılan olarak path-style access kapalı bırak
-> Gerekirse quota limit etkinleştir
-> Kaydet
-> Test görseli yükleyip sonucu kontrol et