Gerenciador de arquivos para MinIO e S3 self-hosted: conecte ao Nubbo

O Nubbo se conecta a qualquer armazenamento compatível com S3 que assine com Signature V4, como MinIO, Ceph ou SeaweedFS, no seu próprio servidor ou em outro provedor. Você só precisa da URL do endpoint, de uma chave e da região. 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 seu servidor. 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 um armazenamento compatível com S3 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 endpoint precisa ser uma URL pública que tanto os servidores do Nubbo quanto o navegador consigam acessar, e precisa de HTTPS, porque o navegador não carrega conteúdo HTTP a partir de https://nubbo.app. O Nubbo rejeita endpoints que apontem para endereços privados ou locais. Se o seu servidor não tiver regiões, deixe us-east-1.

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.

Conexão automática

Passo 1: crie a chave no seu servidor

1. Confirme que o seu servidor expõe a API S3 com assinaturas V4 em uma URL HTTPS pública, por exemplo https://s3.your-domain.com.
2. Crie uma chave que possa criar buckets e alterar o CORS deles.
3. Anote a URL do endpoint e a região. Se o seu servidor não tiver regiões, use us-east-1.

Passo 2: conecte o bucket no Nubbo

1. No Nubbo, abra Buckets e clique em Conectar bucket. Escolha S3 personalizado / Self-hosted e clique em Continuar.

   

2. Escolha Automático e clique em Continuar.

   

3. No passo Sua chave, cole a access key, a secret key, a URL do endpoint e a região. Clique em Verificar chave. O Nubbo verifica se a chave funciona e se ela tem acesso à conta inteira.

   

4. 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.

   

5. 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 seu servidor

1. Crie o bucket no seu servidor (no MinIO, por exemplo, com mc mb).
2. Crie uma chave com permissões de leitura e gravação nesse bucket.
3. Anote a URL do endpoint e a região.

Passo 2: conecte o bucket no Nubbo

1. Em Buckets, clique em Conectar bucket, escolha S3 personalizado / Self-hosted e depois Com uma chave limitada.
2. Cole a access key, a secret key, o endpoint e a região. Clique em Verificar chave.
3. Digite o nome exato do bucket e clique em Verificar acesso.
4. 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.

O jeito de configurar o CORS depende do software:

• O MinIO (edição comunitária) não aceita CORS por bucket: ele usa uma configuração global (MINIO_API_CORS_ALLOW_ORIGIN) que, por padrão, permite qualquer origem. Se você não a alterou, não há nada a fazer: clique em Já adicionei, verificar e a verificação passa. Se você a alterou, inclua https://nubbo.app.
• O Ceph e o SeaweedFS aceitam CORS por bucket pela API S3. Aplique esta regra com a ferramenta que você costuma usar (por exemplo, aws s3api put-bucket-cors com o seu endpoint) ou deixe o Nubbo fazer isso no caminho automático.

[
  {
    "AllowedHeaders": ["*"],
    "AllowedMethods": ["GET", "PUT", "POST", "DELETE", "HEAD"],
    "AllowedOrigins": ["https://nubbo.app"],
    "ExposeHeaders": ["ETag"],
    "MaxAgeSeconds": 3600
  }
]

Quando a regra estiver pronta, volte ao Nubbo e clique em Já adicionei, verificar. No Ceph e no SeaweedFS, se a sua chave puder alterar o CORS, Tentar configurar para mim faz isso por você.

Se algo der errado

Quanto custa

Se você está comparando seu próprio armazenamento com um provedor, compare preços e limites em S3 vs R2 vs Spaces vs Wasabi vs Backblaze B2.