O Nubbo se conecta ao DigitalOcean Spaces com uma access key do Spaces e a região dos seus buckets. Em poucos minutos você tem os buckets em um explorador de arquivos com uploads diretos, links de compartilhamento e galerias. Este guia segue passo a passo o assistente do Nubbo, com os dois caminhos: automático ou com uma chave limitada a um bucket.
O que você ganha
- Navegar pelo bucket como se fosse um disco: pastas, visualizações, busca, lixeira, etiquetas e favoritos.
- Enviar e baixar arquivos diretamente entre o seu navegador e o DigitalOcean Spaces. Os arquivos nunca passam pelos servidores do Nubbo.
- Compartilhar arquivos e pastas com senha, expiração e limite de downloads, receber arquivos no seu bucket e criar galerias.
- Suas chaves são armazenadas criptografadas com AES-256-GCM e você pode desconectar o bucket a qualquer momento.
Antes de começar
Você precisa de uma conta no DigitalOcean Spaces e de uma conta no Nubbo. Cada bucket que você conecta conta para o limite do seu plano: o Gratuito permite 2, o Personal 5 e o Pro não tem limite. O Spaces está disponível em 13 regiões: nyc3, ams3, sfo2, sfo3, sgp1, lon1, fra1, tor1, blr1, syd1, atl1, ric1 e mkc1. O Nubbo pede a região porque cada uma tem o seu próprio endpoint.
Escolha como conectar
O assistente do Nubbo oferece dois caminhos. Os dois terminam do mesmo jeito: o bucket conectado e pronto para uploads a partir do navegador.
| Automático | Com uma chave limitada | |
|---|---|---|
| Chave | Acesso à conta inteira | Limitada a um bucket |
| Bucket | O Nubbo usa um dos seus ou cria um novo | Você cria primeiro |
| CORS | O Nubbo adiciona a regra para você | Você adiciona a regra |
| Quando escolher | O jeito mais rápido | Quando você não quer dar acesso à conta inteira |
Conexão automática
Passo 1: crie a chave no DigitalOcean Spaces
- No painel de controle da DigitalOcean, abra Spaces Object Storage e vá até a aba Access Keys.
- Clique em Create Access Key, escolha Full access e dê um nome a ela, por exemplo
nubbo. - Copie a access key e a secret. A DigitalOcean só mostra a secret uma vez.
Passo 2: conecte o bucket no Nubbo
No Nubbo, abra Buckets e clique em Conectar bucket. Escolha DigitalOcean Spaces e clique em Continuar.
Escolha Automático e clique em Continuar.
No passo Sua chave, cole a access key e a secret e escolha a região dos seus buckets. Clique em Verificar chave. O Nubbo verifica se a chave funciona e se ela tem acesso à conta inteira.
Escolha um dos seus buckets e clique em Usar este bucket, ou selecione Criar um novo, digite um nome (e escolha a região, se for pedida) e clique em Criar e preparar. O Nubbo adiciona ao bucket uma regra CORS que só permite uploads e downloads a partir do app e mantém as regras que já existiam.
Revise as três verificações, altere o Nome no Nubbo se quiser e clique em Concluir. O bucket aparece em Buckets e você pode abri-lo no explorador.
Se o Nubbo não conseguir adicionar a regra CORS com a sua chave, o assistente leva você ao passo CORS. Nesse caso, siga a seção Adicione a regra CORS.
Conexão com uma chave limitada
Passo 1: prepare o bucket e a chave no DigitalOcean Spaces
- Em Spaces Object Storage, clique em Create Bucket, escolha a região e um nome e crie o bucket.
- Em Access Keys, clique em Create Access Key e escolha Limited access.
- Escolha o seu bucket com a permissão Read/Write/Delete, dê um nome à chave e crie-a.
- Copie a access key e a secret. As chaves limitadas não funcionam em buckets que tenham uma bucket policy.
Passo 2: conecte o bucket no Nubbo
- Em Buckets, clique em Conectar bucket, escolha DigitalOcean Spaces e depois Com uma chave limitada.
- Cole a access key e a secret e escolha a região. Clique em Verificar chave.
- Digite o nome exato do bucket e clique em Verificar acesso.
- O assistente passa para o passo CORS com a regra que você precisa adicionar.
Adicione a regra CORS
A regra CORS permite que o navegador envie e baixe arquivos do seu bucket em https://nubbo.app. É a mesma regra que o assistente mostra no passo CORS.
- Em Spaces Object Storage, abra o bucket e vá em Settings.
- Em CORS Configurations, clique em Add.
- Preencha o formulário com estes valores e clique em Save CORS Configuration.
Origin: https://nubbo.app
Allowed Methods: GET, PUT, POST, DELETE, HEAD
Allowed Headers: *
Access Control Max Age: 3600
Com uma chave limitada, você mesmo precisa adicioná-la: na DigitalOcean, alterar o CORS pela API exige uma chave com Full access.
Depois de salvar, volte ao Nubbo e clique em Já adicionei, verificar. Alguns provedores levam um minuto para aplicá-la. Se a sua chave tiver permissão para alterar o CORS, Tentar configurar para mim faz isso por você.
Se algo der errado
| Mensagem no Nubbo | O que fazer |
|---|---|
| “Credenciais inválidas. Verifique a chave de acesso e a chave de acesso secreta.” | Copie as duas chaves de novo, sem espaços no início nem no fim. |
| “Esta chave parece limitada a um bucket. Você pode continuar pelo caminho limitado ou criar uma chave com acesso total.” | Clique em Continuar com chave limitada, ou crie uma chave com acesso à conta inteira e clique em Tentar outra chave. |
| “Bucket não encontrado. Verifique o nome e a região.” | Confirme o nome exato do bucket e se a região escolhida é a do bucket. |
| “Sua chave não tem permissão para criar buckets.” | Use uma chave com acesso total, ou crie o bucket no seu painel e clique em Já criei no meu painel. |
| “Esse nome já está em uso neste provedor; tente outro.” | Os nomes de bucket são únicos em todo o provedor: escolha outro. |
| “Sua chave não tem permissão para configurá-lo.” | Adicione a regra CORS manualmente, como explicado acima. |
| “Ainda não funciona. Revise a regra e verifique de novo; alguns provedores levam um minuto para aplicá-la.” | Confirme que a origem é exatamente https://nubbo.app, sem barra no final, espere um minuto e verifique de novo. |
| “Este bucket já está em uso.” | Esse bucket já está conectado no Nubbo, na sua conta ou em outra. |
| “O bucket está em uma região diferente. Verifique a região configurada.” | Escolha no Nubbo a mesma região em que você criou o bucket. |
| “Acesso negado. Verifique se as credenciais ainda estão ativas e as permissões delas.” | Com uma chave limitada, confirme que ela tem Read/Write/Delete nesse bucket e que o bucket não tem nenhuma bucket policy. |
Quanto custa
O Spaces é cobrado com uma mensalidade que inclui armazenamento e transferência. Explicamos tudo em Preços do DigitalOcean Spaces.
Perguntas frequentes
Que tipo de chave do Spaces eu preciso?
Para o caminho automático, uma chave com Full access. Com uma chave limitada, uma chave Limited access com Read/Write/Delete no seu bucket.
Qual região escolho no Nubbo?
A do bucket: nyc3, ams3, sfo2, sfo3, sgp1, lon1, fra1, tor1, blr1, syd1, atl1, ric1 ou mkc1. O painel de controle mostra a região ao lado do nome do bucket.
Por que o Nubbo não consegue configurar o CORS com a minha chave limitada?
Porque, na DigitalOcean, alterar o CORS pela API exige uma chave com Full access. Com uma chave limitada, você mesmo adiciona a regra em Settings, CORS Configurations.
Posso conectar buckets de várias regiões?
Sim. Cada bucket se conecta com a sua própria região e você pode ter quantos o seu plano permitir.
Fontes
Os preços e limites vêm das páginas oficiais abaixo. Os provedores mudam esses valores, então confirme antes de fechar qualquer compromisso.