Configurações de Armazenamento
Configurações → Avançado → Armazenamento controla onde o LeadHub armazena os arquivos enviados — anexos de leads, imagens de avatar, arquivos de exportação e uploads de formulários.
Drivers de Armazenamento
| Driver | Quando Usar |
|---|---|
| Local (sistema de arquivos do servidor) | Padrão. Os arquivos são armazenados no disco do servidor em storage/app/. Adequado para instalações em único servidor. |
| Compatível com S3 | Para implantações em nuvem, entrega via CDN ou quando o disco do servidor é limitado. Suporta AWS S3, DigitalOcean Spaces, MinIO, Backblaze B2, Cloudflare R2 e qualquer provedor compatível com S3. |
Armazenamento Local
Este é o padrão. Nenhuma configuração necessária. Os arquivos são armazenados em:
/caminho/para/leadhub/storage/app/public/
Acessível em https://seudominio.com/storage/... via link simbólico de armazenamento configurado durante a instalação.
Armazenamento Compatível com S3
Passo 1 — Escolha seu Provedor
| Provedor | Notas |
|---|---|
| AWS S3 | Mais comum. Deixe a URL do Endpoint em branco. |
| DigitalOcean Spaces | Endpoint: https://nyc3.digitaloceanspaces.com (substitua a região) |
| MinIO (auto-hospedado) | Endpoint: URL do seu servidor MinIO |
| Backblaze B2 | Endpoint: https://s3.us-west-004.backblazeb2.com (varia por região) |
| Cloudflare R2 | Endpoint: https://ACCOUNT_ID.r2.cloudflarestorage.com |
Passo 2 — Crie um Bucket
- No painel de controle do seu provedor, crie um novo bucket.
- Defina o bucket como público se quiser acesso público direto aos arquivos enviados.
- Anote o Nome do Bucket e a Região.
Passo 3 — Crie Chaves de Acesso
Gere um ID da Chave de Acesso e Chave de Acesso Secreta com permissões de leitura/gravação no bucket.
Passo 4 — Configure no LeadHub
- Vá para Configurações → Avançado → Armazenamento.
- Defina Disco de Armazenamento como Compatível com S3.
- Preencha: URL do Endpoint, Nome do Bucket, Região, ID da Chave de Acesso e Chave de Acesso Secreta.
- Clique em Testar Conexão para verificar as configurações antes de salvar.
- Clique em Salvar Configurações.
Testando a Conexão
Clique em Testar Conexão — o LeadHub grava um pequeno arquivo de teste no disco de armazenamento e o exclui imediatamente. Uma notificação ✅ significa que a conexão está funcionando. Uma notificação ❌ mostra o erro.
Sempre teste antes de salvar — uma configuração incorreta pode quebrar os uploads de arquivos em todo o espaço de trabalho.
Migrando do Local para S3
- Configure as configurações S3 e teste a conexão.
- Salve as configurações — novos uploads irão para o S3.
- Os arquivos existentes no disco local não são migrados automaticamente. Copie-os manualmente usando a CLI ou ferramenta de sincronização do seu provedor (ex.:
aws s3 sync storage/app/public s3://seu-bucket).
Solução de Problemas
| Problema | Solução |
|---|---|
| "Teste de conexão falhou: Acesso Negado" | Verifique se a Chave de Acesso tem permissões de gravação no bucket |
| Arquivos não acessíveis publicamente | Certifique-se de que o bucket tem ACL de leitura pública, ou configure um CDN |
| Erro "NoSuchBucket" | Verifique se o nome do bucket e a região estão corretos |
| Erros de URL de Endpoint | Para provedores não-AWS, certifique-se de que a URL do endpoint está correta e inclui https:// |