> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Gerenciador de arquivos

> O gerenciador de arquivos se conecta ao seu bucket compatível com S3 para guardar e servir os arquivos e as imagens dos seus templates de email. Um endpoint de CDN opcional serve esses arquivos mais rápido.

![Captura de tela do gerenciador de arquivos](https://www.notifuse.com/docs/assets/screenshots/file_manager.png)

## Configuração do armazenamento S3

Configure o seu armazenamento compatível com S3 com estes campos:

- **Endpoint S3**: a URL do endpoint do seu armazenamento compatível com S3
- **Chave de acesso S3**: chave de acesso para a autenticação
- **Chave secreta S3**: chave secreta para a autenticação
- **Bucket S3**: nome do bucket em que os arquivos serão guardados
- **Região S3**: região do armazenamento (por exemplo, us-east-1)

## Configuração da CDN

### Endpoint da CDN

- **Finalidade**: URL da CDN que guarda os seus arquivos em cache
- **Vantagem**: entrega de arquivos mais rápida e menor custo de banda
- **Opcional**: não é obrigatório, mas é recomendado

### Personalização das URLs

Quando um endpoint de CDN está configurado, as URLs dos arquivos nos seus templates de email usam a URL da CDN em vez da URL direta do S3.

## Configuração de CORS

Para que o gerenciador de arquivos envie arquivos direto do seu navegador, configure o CORS (Cross-Origin Resource Sharing) no seu bucket.

### Cloudflare R2 / AWS S3

Crie uma política de CORS com esta configuração:

```json
[
  {
    "AllowedOrigins": ["*"],
    "AllowedMethods": ["GET", "POST", "HEAD", "DELETE", "PUT"],
    "AllowedHeaders": ["*"]
  }
]
```

> [!TIP]
>
> Em produção, substitua `"*"` em `AllowedOrigins` pela URL do seu console do Notifuse, para mais segurança.

### Google Cloud Storage

No GCS, use o comando `gsutil` com um arquivo de configuração JSON:

```json
[
  {
    "origin": ["*"],
    "method": ["GET", "POST", "HEAD", "PUT", "DELETE", "OPTIONS"],
    "responseHeader": ["Content-Type", "*"]
  }
]
```

Aplique a configuração de CORS:

```bash
gsutil cors set cors.json gs://your-bucket-name
```

## Provedores de armazenamento compatíveis

Os arquivos podem ser enviados para qualquer serviço de armazenamento compatível com S3:

- Amazon S3
- Cloudflare R2
- DigitalOcean Spaces
- Wasabi
- MinIO
- Backblaze B2
- Google Cloud Storage (API S3)

## Opção de S3 auto-hospedado

Se você preferir não usar um provedor de armazenamento em nuvem, pode rodar o nosso servidor de armazenamento compatível com S3 auto-hospedado:

> [card] [Armazenamento S3 auto-hospedado](https://github.com/Notifuse/selfhost_s3)
>
> Um servidor de armazenamento leve, compatível com S3 e baseado em Docker, para hospedar o Notifuse por conta própria sem dependências externas.

Ele serve para:

- Ambientes isolados ou sem conexão com a internet
- Desenvolvimento e testes
- Quem quer controle total sobre os próprios dados
- Evitar os custos de um provedor de nuvem

## Uso dos arquivos

Depois de configurado, os arquivos enviados podem ser usados em:

- Imagens dos templates de email
- Anexos
- Elementos da marca (logos, cabeçalhos)
- Qualquer conteúdo de mídia das suas campanhas de email

## Limites

O gerenciador de arquivos lista os primeiros 10.000 arquivos de um bucket. Num bucket maior, a contagem por pasta, o tamanho total e a busca só consideram esses arquivos; os outros continuam guardados e continuam funcionando nos seus emails.

## Integração com o editor de templates

O gerenciador de arquivos fica disponível no editor visual de emails:

- **Acesso em janela modal**: o gerenciador de arquivos abre numa janela modal enquanto você edita um template
- **Integração direta**: selecione e insira arquivos a partir do editor
- **Envio em tempo real**: envie novos arquivos sem sair do editor de templates
