Cerca de 5 minutos
Como fazer upload de arquivos no Cloudflare R2 e compartilhar links
O Cloudflare R2 combina muito bem com o Aktar: não cobra taxas de egress, tem um plano gratuito que cobre 10 GB e oferece domínios personalizados servidos pela rede da Cloudflare. Você não precisa copiar do painel um ID de conta, o nome de um bucket e duas chaves: Configurar o Cloudflare R2… precisa de um único token de API, criado a partir de um link que já preenche as permissões, e faz o resto. Prefere configurar tudo à mão? Isso fica no último passo.
O que você precisa
- Uma conta na Cloudflare (o plano gratuito do R2 cobre 10 GB)
- Um domínio na Cloudflare, se quiser links no seu próprio domínio (opcional)
- O Aktar para Mac, Windows, iPhone, iPad ou Android
Passo a passo
- 1
Abra Configurar o Cloudflare R2
Nos Ajustes do Aktar, abra Destinos e escolha Configurar o Cloudflare R2…. Quando você ainda não tem nenhum destino, esse é o botão principal. Depois clique em Abrir o Cloudflare.
- 2
Crie o token de API
A página de tokens da Cloudflare abre com o nome Aktar e duas permissões já escolhidas: R2 Storage: Edit, para criar o bucket e enviar arquivos para ele, e Zone: Read, para listar seus domínios para os links públicos. Escolha Continue to summary, depois Create Token, e copie o token.
- 3
Cole e escolha
Cole o token no Aktar. Escolha a conta, se você tiver mais de uma, e depois o bucket: um novo (o Aktar sugere
aktar) ou um que você já tenha. Por último, escolha para onde os links públicos apontam:- O endereço r2.dev do bucket funciona na hora. A Cloudflare limita a taxa de acesso dele, então ele é melhor para testes.
- Um subdomínio de um domínio da sua conta Cloudflare, como
files.example.com, é o ideal para uso real. A Cloudflare adiciona o registro DNS e o certificado, o que leva alguns minutos.
- 4
Configurar
Clique em Configurar. O Aktar cria o bucket, ativa os links públicos, salva o destino e executa Testar conexão sozinho. No seu próprio domínio, os links ganham caminhos limpos como
files.example.com/A7kdP2x.png(veja links curtos). Escolha OK, ou Editar para mudar algo, e solte seu primeiro arquivo no Aktar. - 5
Prefere configurar à mão?
Se você prefere usar um token do R2 limitado a um único bucket: no painel da Cloudflare, abra R2 Object Storage e crie um bucket. Nas Settings dele, conecte um domínio personalizado em Custom Domains ou ative a Public Development URL. Depois, em Manage API tokens, crie um token com Object Read & Write para esse bucket e copie o Access Key ID e o Secret Access Key (o secret só é mostrado uma vez). No Aktar, escolha Adicionar destino, depois Cloudflare R2, e preencha os campos com os valores da tabela abaixo.
Configurações no Aktar
Preencha estes valores em Ajustes → Destinos → Adicionar destino. Os nomes dos campos são os mesmos do app.
| Campo | Valor de exemplo |
|---|---|
| Provedor | Cloudflare R2 |
| Nome do perfil | PersonalQualquer nome que você quiser. |
| ID da conta | 3f9a71c0e2b8…Na página de visão geral do R2. |
| Região | autoMantenha o padrão. |
| Access Key ID | a1b2c3d4…Do token de API do R2. |
| Secret Access Key | ••••••••Guardado no Porta-Chaves ou no Gerenciador de Credenciais. |
| Bucket | screenshots |
| URL base pública | files.example.comSeu domínio personalizado ou a URL r2.dev. |
| Caminho do objeto | {short}.{ext}Opcional, veja nomes de arquivos e pastas. |
Dicas
- O Aktar não guarda o token. Ele o transforma em chaves S3 (o ID do token é a chave de acesso e um hash do valor dele é o segredo), guarda essas chaves como as de qualquer outro destino e esquece o token. Apague o token na Cloudflare quando quiser cortar o acesso do Aktar.
- Um domínio personalizado é armazenado em cache pela Cloudflare, então links populares carregam rápido no mundo todo sem custo extra.
- Configure em um dispositivo e depois use Transferir para outro dispositivo para levar o destino, com as chaves, para seus outros computadores e celulares.
- Quer envios que se apagam sozinhos depois de 1 a 30 dias? O Aktar adiciona as regras de ciclo de vida do bucket para você quando as chaves dele podem gerenciá-las, como as chaves criadas por Configurar o Cloudflare R2 ou as de um token Admin Read & Write. Com um token Object Read & Write, adicione-as você mesmo nos Settings do bucket, em Object Lifecycle Rules. Veja exclusão automática de envios.
Solução de problemas
Configurar diz que o link público ainda não funciona
Logo depois que você conecta seu próprio domínio, a Cloudflare ainda está adicionando o registro DNS e o certificado dele. Espere alguns minutos e execute Testar conexão de novo pelo menu do destino.
Configurar não encontra nenhuma conta para o token
O token foi criado sem acesso a uma conta. Crie-o de novo por Abrir o Cloudflare e mantenha a conta que ele oferece (ou All accounts) em Account Resources.
O link retorna Access Denied ou 403
Confira se a URL base pública é 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.
Testar conexão diz que as credenciais são inválidas
Se você configurou à mão, use o Access Key ID e o Secret Access Key de um token de API do R2, não um token de API comum da Cloudflare nem sua Global API Key, e verifique se o ID da conta 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.