R2: o armazenamento de objetos da Cloudflare
O R2 é o serviço de armazenamento de objetos da Cloudflare, com buckets que aceitam a mesma API do Amazon S3. O seu app grava e lê arquivos pelo endpoint S3 ou por um binding num Worker, pagando pelo volume guardado e pelas operações, sem a taxa de saída que outros provedores cobram quando o arquivo é baixado.
Ficha e sumário da página
- Referência técnica
- Wrangler 4.162.0
- Revisão
- 13 de novembro de 2026
- Conteúdo
- Documentação oficial consultada
Buckets, objetos e chaves
O R2 guarda cada arquivo como um objeto dentro de um bucket, sob uma chave como uploads/2026/11/contrato.pdf, junto com metadados como o tipo de conteúdo. A chave parece um caminho de pasta, mas o bucket guarda cada objeto pela chave inteira. Não existe sistema de arquivos para montar nem disco para dimensionar: você grava, lê, lista e apaga objetos por requisições HTTP.
A documentação lista os usos previstos: armazenamento para aplicações, arquivos de sites, episódios de podcast, data lakes e a saída de processamentos grandes, como modelos de machine learning. Num projeto hospedado na borda, o R2 recebe o que não cabe na pasta do build. Os assets estáticos de um Worker e os arquivos do Pages aceitam até 25 MiB por arquivo. A própria documentação do Pages indica o R2 para os arquivos maiores.
Na criação do bucket, você pode passar uma dica de localização para indicar de onde os objetos serão mais acessados. Pela API do S3, a documentação define a região do bucket como auto. As ferramentas que exigem uma região aceitam o valor vazio ou us-east-1, que a Cloudflare trata como auto.
Dois caminhos até o mesmo bucket
O bucket do R2 tem duas portas de entrada para o seu código. A primeira é a API compatível com o S3, pensada para os apps e as ferramentas que já falam S3, como um SDK da AWS, o rclone ou o destino de backup de um sistema self-hosted. A segunda é o binding num Worker, que dá ao código métodos como put e get sem chave de API no código. O diagrama mostra os dois caminhos chegando ao mesmo bucket:
App ou ferramenta S3
https://<ACCOUNT_ID>.r2.cloudflarestorage.comEndpoint da API S3, autenticado por um par de chaves gerado num token do R2.
Worker com binding
env.MEU_BUCKET.put(chave, corpo)O binding declarado em r2_buckets dá acesso ao bucket direto do código.
Bucket do R2
meu-bucketGuarda cada objeto pela chave, com região auto na API S3.
Domínio próprio
arquivos.seudominio.com.brPublica os objetos com cache, firewall e controle de acesso da Cloudflare.
O acesso pela API S3 usa um token criado no painel do R2. O token gera um Access Key ID e um Secret Access Key, que entram no cliente S3 junto com o endpoint https://<ACCOUNT_ID>.r2.cloudflarestorage.com. Os buckets na jurisdição da União Europeia usam um endpoint próprio, com .eu antes de r2.cloudflarestorage.com. Com as permissões de leitura e gravação de objetos, o token pode valer só para os buckets que você escolher, o que limita o estrago de uma chave vazada.
O binding fica no arquivo de configuração do Wrangler, numa entrada r2_buckets com o nome do binding e o nome do bucket. A documentação dos Workers registra que os bindings têm desempenho melhor e menos restrições que as APIs REST. O binding do R2 também traz opções próprias, como a leitura e a gravação condicionais com onlyIf.
Bucket público, com domínio próprio ou pelo r2.dev
Um bucket começa privado. Para servir os objetos direto ao navegador, como as imagens de um site, você publica o bucket de duas formas. A primeira liga um domínio seu, cadastrado como zona no mesmo cadastro da Cloudflare que tem o bucket. Esse caminho serve para produção e aceita o cache da Cloudflare, o WAF, o Zero Trust Access e o Bot Management.
A segunda forma liga um subdomínio r2.dev, administrado pela Cloudflare. A documentação avisa que o acesso pelo r2.dev tem limite de taxa e serve só para desenvolvimento, sem cache, sem WAF e sem controle de acesso. Os dois caminhos são independentes: ligar o domínio próprio não exige ligar o r2.dev.
Preço por volume e por operação
O R2 cobra o volume guardado por mês e dois tipos de operação. As operações de classe A alteram o estado, como gravar e listar objetos. As de classe B leem o estado, como baixar um objeto. A saída de tráfego para a internet não é cobrada em nenhuma classe de armazenamento.
- US$ 0,015 por GB-mêsVolume guardado, com 10 GB-mês gratuitos por mês.
- US$ 4,50 por milhãoOperações de classe A, com 1 milhão gratuito por mês.
- US$ 0,36 por milhãoOperações de classe B, com 10 milhões gratuitos por mês.
A classe Infrequent Access cobra menos pelo volume, US$ 0,01 por GB-mês. Em troca, ela acrescenta uma taxa de US$ 0,01 por GB lido, cobra mais caro pelas operações e mantém a cobrança de cada objeto por pelo menos 30 dias, ainda que ele seja apagado antes. A faixa gratuita vale só para a classe Standard. A Cloudflare arredonda o uso para a unidade de cobrança seguinte, então 1,1 GB-mês aparece na fatura como 2 GB-mês.
Para um backup, a ausência da taxa de saída pesa no dia da restauração. Baixar a cópia inteira de um banco custa as operações de leitura, sem o valor por gigabyte transferido. A página Hospedagem na borda mostra o R2 ao lado do Pages e dos Workers num mesmo domínio. Os bindings que ligam o código ao bucket estão explicados na página Cloudflare Workers.