Přidání kanálu S3

Kdy se hodí

Kanál S3 použijte, když:

• chcete připojit libovolné S3 kompatibilní objektové úložiště, například Cloudflare R2, Backblaze B2, MinIO, AWS S3 nebo jiného kompatibilního poskytovatele.
• preferujete standardní model konfigurace S3: Endpoint, Access Key a Secret Key.
• nechcete použít nativní kanál Cloudflare R2 přes binding nebo váš poskytovatel není Cloudflare R2.

Co potřebujete před začátkem

Požadavek	Účel
S3 Endpoint	S3 API endpoint služby objektového úložiště.
Název bucketu	Bucket, do kterého se budou ukládat soubory.
Region	Region úložiště. U Cloudflare R2 obvykle auto.
Access Key ID	ID přístupového klíče S3.
Secret Access Key	Tajný přístupový klíč S3.
CDN doména	Volitelná vlastní doména pro přístup k souborům.

Příklad pro Cloudflare R2 přes S3 API:

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

Kde ho přidat

1. Otevřete Nastavení systému.
2. Přejděte do Nastavení nahrávání.
3. Klikněte vpravo nahoře na Přidat kanál.
4. Vyberte S3.

Přehled polí

Pole	Co dělá	Povinné
Název kanálu	Srozumitelný název, například s3test nebo R2-S3.	Ano
Povolit kanál	Určuje, zda se kanál účastní výběru při nahrávání.	Doporučeno
Endpoint	Úplný endpoint služby S3 včetně https://.	Ano
Vlastní CDN doména	Volitelné. Pokud je nastavena, generované odkazy budou preferovat tuto doménu.	Ne
Název bucketu	Název bucketu, například s3test nebo img-r2.	Ano
Region bucketu	Region. U Cloudflare R2 obvykle auto.	Ano
Access Key ID	ID přístupového klíče S3.	Ano
Secret Access Key	Tajný přístupový klíč S3.	Ano
Path-style access	Přepínač kompatibility. Výchozí je vypnuto. Některé služby MinIO, OpenList nebo self-hosted S3 ho mohou vyžadovat.	Ne
Limit kapacity	Určuje, zda se kanál vybírá podle kapacity.	Ne
Kapacitní limit	Povinný po zapnutí limitu, například 10 GB.	Povinné při limitu
Prahová hodnota	Zastaví zápis po dosažení tohoto procenta, například 90%.	Povinné při limitu
Poznámka	Poznámky pro vlastní údržbu.	Ne

Vytvoření S3 API klíčů pro Cloudflare R2

1. Otevřete Cloudflare Dashboard.
2. Přejděte do R2 Object Storage.
3. Najděte Manage R2 API Tokens nebo vstup pro správu API tokenů.


4. Vytvořte R2 API token s přístupem k cílovému bucketu.

5. Zkopírujte vygenerované Access Key ID a Secret Access Key.

6. Vraťte se na stránku R2 bucketu a potvrďte název bucketu.
7. Poznamenejte si S3 API endpoint účtu. Obvykle vypadá takto:

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

Postup nastavení

1. Otevřete Nastavení nahrávání.
2. Klikněte na Přidat kanál.
3. Vyberte S3.
4. Zadejte srozumitelný název kanálu, například s3test.
5. Do Endpoint zadejte S3 API endpoint.
6. Pokud používáte vlastní CDN, zadejte ji do Custom CDN domain; jinak nechte pole prázdné.
7. Zadejte název bucketu.
8. Zadejte region. Pro příklad Cloudflare R2 použijte auto.
9. Zadejte Access Key ID a Secret Access Key.
10. Path-style access nechte vypnutý, pokud ho poskytovatel výslovně nevyžaduje.
11. Pokud chcete řídit kapacitu, zapněte limit a zadejte kapacitní limit i prahovou hodnotu.
12. Klikněte na Uložit.

Ověření

Kontrola	Jak ověřit
Karta kanálu se zobrazuje	Po uložení by se v Nastavení nahrávání měla zobrazit karta S3.
Kanál je zapnutý	Přepínač v pravém horním rohu karty zůstává zapnutý.
Důležitá pole jsou uložena	Detail zobrazuje Endpoint, Bucket, Region, Path-style access a související pole.
Upload funguje	Nahrajte testovací obrázek a ověřte, že se objekt objevil v cílovém bucketu.
Odkaz se otevře	Odkaz na obrázek vrácený po uploadu se normálně otevře.
Zobrazení kapacity funguje	Pokud je limit zapnutý, karta ukazuje využitou kapacitu a nastavený limit.

Statistiky kapacity S3 se počítají z lokálních záznamů souborů v ImgBed, ne z realtime dotazu na bucket poskytovatele. Po uložení konfigurace S3 systém přepočítá evidenci kvót z aktuálních záznamů D1.

FAQ

Mám zapnout Path-style access?

Většinou ne.

Zapněte ho jen tehdy, když váš S3 kompatibilní poskytovatel nepodporuje virtual-hosted-style URL nebo když to dokumentace poskytovatele výslovně vyžaduje. Některé endpointy MinIO, self-hosted S3 a OpenList ho mohou potřebovat.

K čemu je CDN doména?

Pokud před bucket dáváte CDN nebo vlastní přístupovou doménu, zadejte ji sem.

Po nastavení budou generované odkazy preferovat tuto doménu. Pokud CDN nepoužíváte, nechte pole prázdné.

Proč upload selhává?

Nejdřív zkontrolujte:

1. Endpoint obsahuje úplný URL s https://.
2. Název bucketu je správný.
3. Region odpovídá požadavkům poskytovatele.
4. Access Key ID a Secret Access Key byly zkopírovány celé.
5. Klíč má právo zapisovat do cílového bucketu.
6. Poskytovatel nevyžaduje Path-style access, nebo je tato volba zapnutá, pokud je potřeba.

Rychlý checklist

Připravte S3 Endpoint, Bucket, Region, Access Key a Secret Key
-> Otevřete Nastavení nahrávání
-> Přidat kanál
-> Vyberte S3
-> Zadejte Endpoint / Bucket / Region / Access Key / Secret Key
-> Případně zadejte CDN doménu
-> Path-style access nechte ve výchozím stavu vypnutý
-> Pokud je potřeba, zapněte limit kapacity
-> Uložte
-> Nahrajte testovací obrázek a zkontrolujte výsledek