Dodawanie kanału S3

Kiedy warto go użyć

Użyj kanału S3, gdy:

• chcesz podłączyć dowolną pamięć obiektową zgodną z S3, taką jak Cloudflare R2, Backblaze B2, MinIO, AWS S3 albo inny zgodny dostawca.
• wolisz standardowy model konfiguracji S3: Endpoint, Access Key i Secret Key.
• nie chcesz używać natywnego kanału Cloudflare R2 przez binding albo Twój dostawca nie jest Cloudflare R2.

Co przygotować przed rozpoczęciem

Wymaganie	Cel
S3 Endpoint	Endpoint API S3 usługi pamięci obiektowej.
Nazwa bucketu	Bucket, w którym będą przechowywane pliki.
Region	Region pamięci. Dla Cloudflare R2 zwykle auto.
Access Key ID	Identyfikator klucza dostępu S3.
Secret Access Key	Tajny klucz dostępu S3.
Domena CDN	Opcjonalna własna domena dostępu do plików.

Przykład dla Cloudflare R2 przez API S3:

Endpoint: https://your-account-id.r2.cloudflarestorage.com
Bucket: your-r2-bucket-name
Region: auto
Access Key ID: skopiowany z tokenu API Cloudflare R2
Secret Access Key: skopiowany z tokenu API Cloudflare R2

Gdzie dodać kanał

1. Otwórz Ustawienia systemowe.
2. Przejdź do Ustawień przesyłania.
3. Kliknij Dodaj kanał w prawym górnym rogu.
4. Wybierz S3.

Opis pól

Pole	Działanie	Wymagane
Nazwa kanału	Czytelna nazwa kanału S3, np. s3test lub R2-S3.	Tak
Włącz kanał	Określa, czy kanał bierze udział w wyborze kanału uploadu.	Zalecane
Endpoint	Pełny endpoint usługi S3, z https://.	Tak
Własna domena CDN	Opcjonalnie. Po ustawieniu wygenerowane linki plików preferują tę domenę.	Nie
Nazwa bucketu	Nazwa bucketu, np. s3test lub img-r2.	Tak
Region bucketu	Region. Dla Cloudflare R2 zwykle auto.	Tak
Access Key ID	Identyfikator klucza S3.	Tak
Secret Access Key	Tajny klucz S3.	Tak
Path-style access	Przełącznik zgodności. Domyślnie wyłączony. Niektóre usługi MinIO, OpenList lub samodzielnie hostowane S3 mogą go wymagać.	Nie
Limit pojemności	Określa, czy kanał jest wybierany na podstawie dostępnej pojemności.	Nie
Limit rozmiaru	Wymagany po włączeniu limitu pojemności, np. 10 GB.	Wymagany przy limicie
Próg	Zatrzymuje zapis po osiągnięciu tego procentu, np. 90%.	Wymagany przy limicie
Uwaga	Notatki do własnego utrzymania.	Nie

Tworzenie kluczy Cloudflare R2 S3 API

1. Otwórz Cloudflare Dashboard.
2. Przejdź do R2 Object Storage.
3. Znajdź Manage R2 API Tokens albo wejście do zarządzania tokenami API.


4. Utwórz token API R2 z dostępem do docelowego bucketu.

5. Skopiuj wygenerowane Access Key ID i Secret Access Key.

6. Wróć na stronę bucketu R2 i potwierdź nazwę bucketu.
7. Zapisz endpoint API S3 konta. Zwykle wygląda tak:

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

Kroki konfiguracji

1. Otwórz Ustawienia przesyłania.
2. Kliknij Dodaj kanał.
3. Wybierz S3.
4. Wpisz rozpoznawalną nazwę kanału, np. s3test.
5. Wpisz endpoint API S3 w polu Endpoint.
6. Jeśli używasz własnego CDN, wpisz go w Custom CDN domain; w przeciwnym razie zostaw puste.
7. Wpisz nazwę bucketu.
8. Wpisz region. Dla przykładu Cloudflare R2 użyj auto.
9. Wpisz Access Key ID i Secret Access Key.
10. Zostaw Path-style access wyłączony, chyba że dostawca wyraźnie go wymaga.
11. Jeśli chcesz kontrolę pojemności, włącz limit i wpisz limit oraz próg.
12. Kliknij Zapisz.

Jak sprawdzić

Kontrola	Jak sprawdzić
Karta kanału jest widoczna	Po zapisaniu w Ustawieniach przesyłania powinna pojawić się karta S3.
Kanał jest włączony	Przełącznik w prawym górnym rogu karty pozostaje włączony.
Ważne pola są zapisane	Widok szczegółów pokazuje Endpoint, Bucket, Region, Path-style access i powiązane pola.
Upload działa	Prześlij obraz testowy i sprawdź, czy obiekt pojawił się w docelowym buckecie.
Link otwiera się	Link obrazu zwrócony po uploadzie otwiera się normalnie.
Pojemność działa	Jeśli limit jest włączony, karta pokazuje użycie i ustawiony limit.

Statystyki pojemności S3 są liczone z lokalnych rekordów plików ImgBed, a nie przez odpytywanie bucketu dostawcy w czasie rzeczywistym. Po zapisaniu konfiguracji S3 system przelicza stan limitu na podstawie bieżących rekordów D1.

FAQ

Czy włączać Path-style access?

Zwykle nie.

Włącz tylko wtedy, gdy dostawca zgodny z S3 nie obsługuje adresów virtual-hosted-style albo dokumentacja dostawcy wyraźnie wymaga path-style access. Niektóre endpointy MinIO, samodzielnie hostowane S3 i zgodne z OpenList mogą tego potrzebować.

Do czego służy domena CDN?

Jeśli przed bucketem używasz CDN lub własnej domeny dostępowej, wpisz ją tutaj.

Po konfiguracji wygenerowane linki plików będą preferować tę domenę. Jeśli nie używasz CDN, zostaw pole puste.

Dlaczego upload się nie udaje?

Najpierw sprawdź:

1. Endpoint zawiera pełny URL z https://.
2. Nazwa bucketu jest poprawna.
3. Region pasuje do wymagań dostawcy.
4. Access Key ID i Secret Access Key zostały skopiowane w całości.
5. Klucz ma uprawnienia zapisu do docelowego bucketu.
6. Dostawca nie wymaga Path-style access albo opcja została włączona, jeśli jest wymagana.

Szybka lista

Przygotuj S3 Endpoint, Bucket, Region, Access Key i Secret Key
-> Otwórz Ustawienia przesyłania
-> Dodaj kanał
-> Wybierz S3
-> Wpisz Endpoint / Bucket / Region / Access Key / Secret Key
-> Wpisz domenę CDN, jeśli potrzeba
-> Domyślnie zostaw Path-style access wyłączony
-> Włącz limit pojemności, jeśli potrzeba
-> Zapisz
-> Prześlij obraz testowy i sprawdź wynik