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

# Gestionnaire de fichiers

> Le gestionnaire de fichiers se connecte à votre bucket compatible S3 pour stocker et servir les fichiers et les images de vos modèles d'email. Un point d'accès CDN facultatif sert ces fichiers plus vite.

![Capture d'écran du gestionnaire de fichiers](https://www.notifuse.com/docs/assets/screenshots/file_manager.png)

## Configuration du stockage S3

Configurez votre stockage compatible S3 avec ces paramètres :

- **Point d'accès S3** : l'URL du point d'accès de votre stockage compatible S3
- **Clé d'accès S3** : la clé d'accès pour l'authentification
- **Clé secrète S3** : la clé secrète pour l'authentification
- **Bucket S3** : le nom du bucket où les fichiers seront stockés
- **Région S3** : la région du stockage (par exemple us-east-1)

## Configuration du CDN

### Point d'accès CDN

- **Rôle** : l'URL du CDN qui met vos fichiers en cache
- **Avantage** : des fichiers servis plus vite et des coûts de bande passante réduits
- **Facultatif** : pas obligatoire, mais recommandé

### Personnalisation des URL

Quand un point d'accès CDN est configuré, les URL des fichiers dans vos modèles d'email utilisent l'URL du CDN au lieu de l'URL S3 directe.

## Configuration CORS

Pour que le gestionnaire de fichiers envoie les fichiers directement depuis votre navigateur, configurez CORS (Cross-Origin Resource Sharing) sur votre bucket.

### Cloudflare R2 / AWS S3

Créez une politique CORS avec cette configuration :

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

> [!TIP]
>
> En production, remplacez `"*"` dans `AllowedOrigins` par l'URL de votre console Notifuse, pour plus de sécurité.

### Google Cloud Storage

Pour GCS, utilisez la commande `gsutil` avec un fichier de configuration JSON :

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

Appliquez la configuration CORS :

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

## Fournisseurs de stockage pris en charge

Les fichiers peuvent être envoyés vers n'importe quel service de stockage compatible S3 :

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

## Option S3 auto-hébergée

Si vous préférez ne pas utiliser de fournisseur de stockage cloud, vous pouvez faire tourner notre serveur de stockage compatible S3 auto-hébergé :

> [card] [Stockage S3 auto-hébergé](https://github.com/Notifuse/selfhost_s3)
>
> Un serveur de stockage léger, compatible S3 et basé sur Docker, pour auto-héberger Notifuse sans dépendance externe.

Il convient pour :

- Les environnements isolés ou hors ligne
- Le développement et les tests
- Les utilisateurs qui veulent garder la maîtrise complète de leurs données
- Éviter les coûts d'un fournisseur cloud

## Utilisation des fichiers

Une fois la configuration faite, les fichiers envoyés peuvent servir pour :

- Les images des modèles d'email
- Les pièces jointes
- Les éléments de marque (logos, en-têtes)
- Tout contenu média de vos campagnes d'emailing

## Limites

Le gestionnaire de fichiers liste les 10 000 premiers fichiers d'un bucket. Dans un bucket plus grand, le nombre de fichiers par dossier, la taille totale et la recherche ne portent que sur ces fichiers ; les autres fichiers restent stockés et fonctionnent toujours dans vos emails.

## Intégration à l'éditeur de modèles

Le gestionnaire de fichiers est accessible depuis l'éditeur visuel d'emails :

- **Accès par une fenêtre modale** : le gestionnaire de fichiers s'ouvre dans une fenêtre modale pendant que vous modifiez un modèle
- **Intégration directe** : sélectionnez et insérez des fichiers depuis l'éditeur
- **Envoi en temps réel** : envoyez de nouveaux fichiers sans quitter l'éditeur de modèles
