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

# Gestor de archivos

> El gestor de archivos se conecta a tu bucket compatible con S3 para guardar y servir los archivos e imágenes de tus plantillas de correo. Un endpoint de CDN opcional sirve esos archivos más rápido.

![Captura del gestor de archivos](https://www.notifuse.com/docs/assets/screenshots/file_manager.png)

## Configuración del almacenamiento S3

Configura tu almacenamiento compatible con S3 con estos ajustes:

- **Punto final S3**: la URL del endpoint de tu almacenamiento compatible con S3
- **Clave de acceso S3**: la clave de acceso para la autenticación
- **Clave secreta S3**: la clave secreta para la autenticación
- **Bucket S3**: el nombre del bucket donde se guardarán los archivos
- **Región S3**: la región del almacenamiento (por ejemplo, us-east-1)

## Configuración del CDN

### Endpoint de CDN

- **Para qué sirve**: la URL del CDN que almacena en caché tus archivos
- **Ventaja**: entrega más rápida de los archivos y menos costes de ancho de banda
- **Opcional**: no es obligatorio, pero se recomienda

### Personalización de las URL

Cuando hay un endpoint de CDN configurado, las URL de los archivos de tus plantillas de correo usan la URL del CDN en lugar de la URL directa de S3.

## Configuración de CORS

Para que el gestor de archivos suba archivos directamente desde tu navegador, configura CORS (Cross-Origin Resource Sharing) en tu bucket de almacenamiento.

### Cloudflare R2 / AWS S3

Crea una política CORS con esta configuración:

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

> [!TIP]
>
> En producción, sustituye `"*"` en `AllowedOrigins` por la URL de tu consola de Notifuse para mayor seguridad.

### Google Cloud Storage

Para GCS, usa el comando `gsutil` con un archivo de configuración JSON:

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

Aplica la configuración de CORS:

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

## Proveedores de almacenamiento compatibles

Los archivos se pueden subir a cualquier servicio de almacenamiento compatible con S3:

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

## Opción de S3 autoalojado

Si prefieres no usar un proveedor de almacenamiento en la nube, puedes ejecutar nuestro servidor de almacenamiento autoalojado compatible con S3:

> [card] [Almacenamiento S3 autoalojado](https://github.com/Notifuse/selfhost_s3)
>
> Un servidor de almacenamiento ligero compatible con S3, basado en Docker, para alojar Notifuse sin depender de servicios externos.

Es adecuado para:

- Entornos aislados o sin conexión
- Desarrollo y pruebas
- Usuarios que quieren control total sobre sus datos
- Evitar los costes de un proveedor en la nube

## Uso de los archivos

Una vez configurado, los archivos subidos se pueden usar en:

- Imágenes de las plantillas de correo
- Archivos adjuntos
- Recursos de marca (logos, cabeceras)
- Cualquier contenido multimedia de tus campañas de correo

## Límites

El gestor de archivos lista los 10 000 primeros archivos de un bucket. En un bucket más grande, los recuentos por carpeta, el tamaño total y la búsqueda solo cubren esos archivos; los demás archivos siguen guardados y siguen funcionando en tus correos.

## Integración con el editor de plantillas

El gestor de archivos está disponible desde el editor visual de correos:

- **Acceso en un modal**: el gestor de archivos se abre en un modal mientras editas una plantilla
- **Integración directa**: selecciona e inserta archivos desde el editor
- **Subida al momento**: sube archivos nuevos sin salir del editor de plantillas
