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: copied from the Cloudflare R2 API token
Secret Access Key: copied from the Cloudflare R2 API token

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.
Nahrávání 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 nahrání 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 ImgHost, ne z dotazu na bucket poskytovatele v reálném čase. 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č nahrávání 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ý kontrolní seznam

Prepare S3 Endpoint, Bucket, Region, Access Key, and Secret Key
-> Open Upload Settings
-> Add Channel
-> Select S3
-> Enter Endpoint / Bucket / Region / Access Key / Secret Key
-> Enter a CDN domain if needed
-> Leave path-style access off by default
-> Enable quota limit if needed
-> Save
-> Upload a test image and check the result