Cerca de 5 minutos
Como usar o Aktar com Cloudflare R2
O Cloudflare R2 combina muito bem com o Aktar: não cobra taxas de egress, tem um plano gratuito que cobre a maior parte do uso com capturas de tela e oferece domínios personalizados servidos pela rede da Cloudflare. O Aktar tem uma predefinição dedicada ao R2, então você só precisa do seu Account ID, de um token de API e de um bucket.
O que você precisa
- Uma conta na Cloudflare com o R2 ativado
- Um domínio na Cloudflare, se quiser links no seu próprio domínio (opcional)
- O Aktar instalado no seu Mac
Passo a passo
- 1
Crie um bucket
No painel da Cloudflare, abra R2 Object Storage e clique em Create bucket. Escolha um nome curto, como
screenshots, e mantenha a localização automática. - 2
Dê ao bucket um endereço público
Abra as Settings do bucket. Em Custom Domains, conecte um domínio ou subdomínio que você gerencia na Cloudflare, por exemplo
files.example.com. Essa é a melhor opção para uso real.Para um teste rápido, você pode ativar a Public Development URL (
pub-….r2.dev). A Cloudflare limita a taxa de acesso dessa URL e não a recomenda para produção. - 3
Crie um token de API
De volta à página de visão geral do R2, abra Manage API tokens e crie um token com permissão Object Read & Write, limitado ao seu bucket. Copie o Access Key ID e o Secret Access Key: o secret só é mostrado uma vez.
Seu Account ID aparece na mesma página, e também é a primeira parte do endpoint S3
https://<ACCOUNT_ID>.r2.cloudflarestorage.com. - 4
Adicione o destino no Aktar
Abra Settings → Destinations → Add Destination no Aktar, escolha Cloudflare R2 e preencha os campos com os valores da tabela abaixo. O Aktar deriva o endpoint a partir do seu Account ID.
- 5
Teste e salve
Clique em Test Connection. O Aktar envia um pequeno arquivo de teste, verifica se ele está acessível pelo seu endereço público e depois o exclui. Quando estiver tudo verde, clique em Save e solte seu primeiro arquivo no ícone da barra de menus.
Configurações no Aktar
Preencha estes valores em Settings → Destinations → Add Destination. Os nomes dos campos são os mesmos do app.
| Campo | Valor de exemplo |
|---|---|
| Provider | Cloudflare R2 |
| Profile Name | PersonalQualquer nome que você quiser. |
| Account ID | 3f9a71c0e2b8…Na página de visão geral do R2. |
| Region | autoMantenha o padrão. |
| Access Key ID | a1b2c3d4…Do token de API do R2. |
| Secret Access Key | ••••••••Guardado no Keychain do macOS. |
| Bucket | screenshots |
| Public Base URL | files.example.comSeu domínio personalizado ou a URL r2.dev. |
| Object Path | {year}/{month}/{uuid}.{ext}Opcional, veja nomes de arquivos e pastas. |
Dicas
- Limite o token de API ao único bucket que o Aktar usa. Se o token vazar, nada mais fica exposto.
- Um domínio personalizado é armazenado em cache pela Cloudflare, então links populares carregam rápido no mundo todo sem custo extra.
- Quer pastas organizadas? Altere o caminho do objeto, por exemplo para
shots/{date}/{filename}-{random}.{ext}. Veja nomes de arquivos e pastas.
Solução de problemas
O link retorna Access Denied ou 403
Confira se a Public Base URL é o seu domínio personalizado ou a URL r2.dev. O endpoint …r2.cloudflarestorage.com serve apenas para a API e nunca entrega arquivos públicos. Mais em erros de Access Denied.
O Test Connection diz que as credenciais são inválidas
Use o Access Key ID e o Secret Access Key do token de API do R2, não um token de API comum da Cloudflare nem sua Global API Key. Verifique se o Account ID não tem espaços sobrando.
Os envios funcionam, mas os links estão lentos ou com limite de taxa
Provavelmente você está usando a URL de desenvolvimento r2.dev. Conecte um domínio personalizado para uso em produção.
Ainda com problemas?Veja as perguntas frequentes ou pergunte no GitHub.