Guia de configuração S3: Transmita música e vídeos do Backblaze B2, AWS, Cloudflare R2, Google Cloud Storage

O Cloudist agora suporta armazenamento em nuvem compatível com S3 — conecte seu Backblaze B2, AWS S3, Cloudflare R2, Google Cloud Storage, Wasabi, MinIO ou qualquer serviço compatível com S3 e transmita sua música e vídeos diretamente dos seus buckets.

Este guia explica tudo o que você precisa saber para configurar o armazenamento S3 com o Cloudist Play (música) e o Cloudist Watch (vídeo).

O que é S3 Storage?

Amazon S3 (Simple Storage Service) é o padrão da indústria para armazenamento de objetos. Muitos provedores oferecem APIs compatíveis com S3, o que significa que você pode usar o mesmo protocolo para acessar o armazenamento de diferentes empresas. Isso oferece:

• Liberdade de escolha — escolha qualquer provedor que se encaixe no seu orçamento e necessidades
• Sem dependência de fornecedor — troque de provedor sem alterar sua configuração
• Custo-benefício — armazene grandes bibliotecas de mídia por centavos por GB
• Auto-hospedagem — execute o MinIO no seu próprio servidor

Provedores suportados

O Cloudist funciona com qualquer armazenamento compatível com S3. Aqui estão as opções mais populares:

Nossa recomendação

Para a maioria dos usuários, Backblaze B2 ou Cloudflare R2 oferecem o melhor custo-benefício. O B2 oferece 10 GB de armazenamento gratuito com generoso egress gratuito, enquanto o R2 tem downloads completamente gratuitos — ideal para streaming de mídia. Se você já está no ecossistema Google, o Google Cloud Storage oferece integração perfeita com 5 GB sempre grátis.

Guia de configuração passo a passo

Passo 1: Crie seu S3 Bucket

Primeiro, crie um bucket no provedor escolhido:

Backblaze B2:

1. Cadastre-se em backblaze.com
2. Vá para Buckets → Create a Bucket
3. Dê um nome (ex. minha-musica) e defina como Private
4. Anote seu Endpoint e Region nos detalhes do bucket

AWS S3:

1. Abra o Console S3
2. Clique em Create bucket
3. Escolha uma região próxima a você (ex. sa-east-1)
4. Mantenha ativada a opção "Bloquear todo o acesso público"

Cloudflare R2:

1. Faça login no Cloudflare Dashboard
2. Vá para R2 Object Storage → Create bucket
3. Anote seu Account ID na URL do painel

Google Cloud Storage:

1. Abra o Console do Cloud Storage
2. Clique em Create bucket
3. Escolha uma região próxima a você (ex. southamerica-east1)
4. Selecione a classe de armazenamento Standard para mídia acessada com frequência
5. Mantenha ativada a opção "Aplicar prevenção de acesso público"

Passo 2: Crie as chaves de acesso

Você precisa de um Access Key ID e um Secret Access Key para se conectar:

Backblaze B2:

1. Vá para Application Keys → Add a New Application Key
2. Dê um nome, selecione seu bucket e escolha Read Only
3. Salve o keyID (Access Key) e a applicationKey (Secret Key)

AWS S3:

1. Vá para IAM → Users → Create User
2. Anexe a política AmazonS3ReadOnlyAccess
3. Crie um Access Key em Security Credentials

Cloudflare R2:

1. Vá para R2 → Manage R2 API Tokens
2. Crie um token com permissão Object Read para seu bucket

Google Cloud Storage:

1. Vá para Cloud Storage → Settings → Interoperability
2. Clique em Create a key for a service account ou use sua conta padrão
3. Isso gera uma chave HMAC Access Key e Secret Key compatível com S3
4. Para acesso somente leitura, atribua o papel Storage Object Viewer à conta de serviço

Passo 3: Faça upload dos seus arquivos de mídia

Faça upload dos seus arquivos de música ou vídeo para o bucket. Você pode organizá-los em pastas:

minha-musica/
  Rock/
    musica1.mp3
    musica2.flac
  Jazz/
    faixa1.m4a
  Podcasts/
    episodio1.mp3

Use o console web do seu provedor, ferramenta CLI ou aplicativos como Cyberduck ou rclone para fazer upload.

Passo 4: Conecte-se no Cloudist

1. Abra o Cloudist Play ou Cloudist Watch
2. Vá para Contas → toque no botão +
3. Selecione S3 Storage
4. Escolha seu preset de provedor no menu suspenso (Backblaze B2, AWS S3, Cloudflare R2, Wasabi ou Custom)
5. Os campos Endpoint e Region são preenchidos automaticamente com base no seu preset
6. Insira seu Access Key e Secret Key
7. Insira o nome do seu Bucket
8. Toque em Test & Connect

É isso! O Cloudist vai escanear seu bucket e adicionar todos os arquivos de mídia suportados à sua biblioteca.

Como funciona o streaming

O Cloudist usa Pre-signed URLs para transmitir sua mídia. Veja o que isso significa:

• Quando você reproduz uma faixa, o Cloudist gera uma URL temporária (válida por 1 hora) que concede acesso a esse arquivo específico
• Nenhum cabeçalho de autenticação é necessário — a própria URL contém a assinatura
• Isso funciona perfeitamente com players de áudio e vídeo em todas as plataformas
• As URLs são automaticamente regeneradas quando expiram

Essa abordagem é segura (URLs expiram rapidamente) e eficiente (nenhum servidor proxy necessário).

Formatos de arquivo suportados

Cloudist Play (Música):

• MP3, M4A, WAV, FLAC, AAC, WMA, OGG

Cloudist Watch (Vídeo):

• MP4, MKV, WebM, AVI, MOV, M4V, FLV, WMV, TS, 3GP

App Web: Configuração CORS

Se você usa o app web (play.fromcloud.ist ou watch.fromcloud.ist), seu bucket precisa de configuração CORS para permitir acesso do navegador. Aqui está a política CORS a adicionar:

[{
  "AllowedHeaders": ["*"],
  "AllowedMethods": ["GET", "HEAD"],
  "AllowedOrigins": ["https://play.fromcloud.ist", "https://watch.fromcloud.ist"],
  "ExposeHeaders": ["ETag", "Content-Length"],
  "MaxAgeSeconds": 3600
}]

Nota: A configuração CORS só é necessária para reprodução web. Apps nativos (iOS, Android, macOS) não precisam dela.

Comparação de custos

Veja quanto custa armazenar e transmitir uma biblioteca musical típica (1.000 faixas, ~8 GB) com 100 reproduções por mês:

Para uma videoteca (200 vídeos, ~100 GB) com 50 reproduções por mês:

Dicas e boas práticas

• Use chaves somente leitura — O Cloudist só precisa ler arquivos, nunca escrever. Crie chaves com permissões mínimas
• Organize com pastas — Use uma estrutura de pastas clara. O Cloudist preserva a hierarquia de pastas para facilitar a navegação
• Escolha uma região próxima — Selecione uma região de armazenamento perto da sua localização para streaming mais rápido
• Backblaze B2 + Cloudflare — Se você usa B2 com o CDN da Cloudflare, o egress entre eles é completamente gratuito (Bandwidth Alliance)
• MinIO para auto-hospedagem — Execute o MinIO em um Raspberry Pi ou NAS para um servidor de mídia privado e auto-hospedado

Perguntas frequentes

Minhas credenciais são enviadas para algum lugar?

Não. Suas chaves de acesso S3 são armazenadas apenas no seu dispositivo usando armazenamento local seguro. Elas nunca são enviadas aos servidores do Cloudist ou armazenadas na nuvem.

Posso conectar várias contas S3?

Sim. Você pode adicionar quantas contas de armazenamento S3 quiser — combine diferentes provedores, buckets ou regiões.

Funciona offline?

Sim. Você pode baixar faixas para reprodução offline. Os arquivos baixados são armazenados localmente no seu dispositivo.

O que acontece se minha Pre-signed URL expirar?

O Cloudist gera automaticamente uma nova URL quando necessário. Você não notará nenhuma interrupção durante a reprodução.

Comece agora

Baixe o Cloudist e conecte seu armazenamento S3 hoje:

• Cloudist Play (Música): App Store · Google Play · Web
• Cloudist Watch (Vídeo): App Store · Google Play · Web