Adicionar canal compatível com S3

O canal S3 permite usar armazenamento de objetos compatível com a API S3.

Serve para Cloudflare R2, Backblaze B2, MinIO, AWS S3 e outros serviços compatíveis.

O que preparar

Item	Uso
S3 Endpoint	URL da API do armazenamento
Bucket	Bucket onde os arquivos serão salvos
Region	Região do armazenamento; no Cloudflare R2 costuma ser auto
Access Key ID	Chave de acesso
Secret Access Key	Chave secreta
Domínio CDN	Opcional, para URLs públicas personalizadas

Exemplo com Cloudflare R2 pela API S3:

Endpoint: https://seuAccountID.r2.cloudflarestorage.com
Bucket: nome-do-bucket
Region: auto

Onde adicionar

1. Abra Configurações do sistema.
2. Entre em Configurações de upload.
3. Clique em Adicionar canal.
4. Escolha S3.

Campos

Campo	Descrição
Nome do canal	Por exemplo R2-S3 ou MinIO
Endpoint	URL S3 completa com https://
Domínio CDN personalizado	Opcional; usado ao gerar links
Bucket	Nome do bucket
Region	auto para R2; outros provedores conforme documentação
Access Key ID	Chave de acesso
Secret Access Key	Chave secreta
Path-style access	Apenas se o provedor exigir
Limite de capacidade	Opcional

Criar chaves S3 para R2

No Cloudflare Dashboard, abra R2 Object Storage e entre no gerenciamento de API Tokens.


Crie um token R2 com acesso ao bucket alvo.

Copie Access Key ID e Secret Access Key.

Preencher no ImgBed

1. Informe Endpoint, Bucket e Region.
2. Informe Access Key ID e Secret Access Key.
3. Se usar CDN, preencha o domínio personalizado.
4. Ative Path-style access apenas se o serviço exigir.
5. Salve.

Verificação

Ponto	Estado esperado
Cartão do canal	Aparece depois de salvar
Upload de teste	Cria objeto no bucket
Link	A URL retornada pelo ImgBed abre corretamente
Capacidade	Se houver limite, mostra uso

A estatística de capacidade S3 é calculada pelos registros locais do ImgBed no D1, não por varredura em tempo real do bucket.

Erros comuns

• Endpoint sem https://.
• Bucket ou Region incorretos.
• Access Key sem permissão de escrita.
• Provedor exige Path-style access.
• CDN não conectado corretamente ao bucket.