# Installation

Parfait, on plonge dans **Seafile** en détail ! Voici tout ce qu’il faut savoir pour **maîtriser Seafile** : installation avancée, optimisation, gestion des utilisateurs, sauvegardes, et astuces pour une utilisation fluide en équipe. Je vais te donner des éléments concrets, des exemples de commandes, et des retours d’expérience pour éviter les pièges.

---

## **1. Architecture et Concepts Clés de Seafile**

### **a. Comment Seafile organise les données ?**

Seafile utilise un système de **blocs de fichiers** (comme Git) :

- Chaque fichier est découpé en **blocs de 1 Mo** (par défaut).
- Les blocs sont **hashés** (SHA-1) et stockés dans `/shared/seafile-data`.
- Les métadonnées (noms, permissions) sont stockées dans la **base de données MariaDB**.

**Avantages** :

- **Économie d’espace** : Les blocs identiques (ex : fichiers dupliqués) ne sont stockés qu’une fois.
- **Synchro rapide** : Seuls les blocs modifiés sont transférés.
- **Intégrité des données** : Les hashs permettent de détecter les corruptions.

**Exemple de structure de dossiers** :

<div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block" id="bkmrk-%2Fsrv%2Fseafile%2Fdata%2F-%E2%94%9C"><div class="text-default text-sm select-text">`/srv/seafile/data/├── seafile-data/       # Blocs de fichiers├── seafile-conf/       # Configurations└── logs/               # Logs du serveur`</div></div>---

### **b. Ports utilisés par Seafile**

<div id="bkmrk-port-usage-%C3%80-exposer"><table><thead><tr><th>Port</th><th>Usage</th><th>À exposer ?</th></tr></thead><tbody><tr><td>8000</td><td>Interface web</td><td>Oui (via Nginx)</td></tr><tr><td>8082</td><td>API pour le client desktop</td><td>Oui (si synchro hors réseau local)</td></tr><tr><td>10001</td><td>Service de notification</td><td>Non (interne)</td></tr><tr><td>12001</td><td>Service de recherche</td><td>Non (interne)</td></tr></tbody></table>

</div>**Conseil** : Dans ton Nginx, expose **uniquement le port 8000** (le reste est géré en interne par Docker).

---

## **2. Optimisation des Performances**

### **a. Configuration de Seafile pour Docker**

Pour optimiser les performances, ajoute ces variables d’environnement dans ton `docker-compose.yml` :

<div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block" id="bkmrk-environment%3A---seafi"><div class="text-default text-sm select-text">`environment:  - SEAFILE_SERVER_HOSTNAME=seafile.tacampagne.fr  - SEAFILE_ADMIN_EMAIL=admin@tacampagne.fr  - SEAFILE_ADMIN_PASSWORD=tonmotdepasse  - SEAFILE_MYSQL_HOST=seafile-db  - SEAFILE_MYSQL_ROOT_PASSWORD=motdepassebdd  - SEAFILE_TIMEZONE=Europe/Paris  # Pour les horodatages  - SEAFILE_FILE_SERVER_ROOT=https://seafile.tacampagne.fr  # URL publique  - SEAFILE_ENABLE_FILE_LOCKING=true  # Évite les conflits d’édition`</div></div>### **b. Tuning de la base de données (MariaDB)**

Ajoute ces lignes dans la section `seafile-db` de ton `docker-compose.yml` pour améliorer les performances :

<div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block" id="bkmrk-command%3A-%5B-%27--charac"><div class="text-default text-sm select-text">`command: [  '--character-set-server=utf8mb4',  '--collation-server=utf8mb4_unicode_ci',  '--innodb-buffer-pool-size=512M',  # Augmente si tu as beaucoup de fichiers  '--max-connections=200']`</div></div>### **c. Configuration Nginx pour les gros fichiers**

Si tu partages des fichiers &gt; 100 Mo, ajoute ces directives dans ton bloc `server` Nginx :

<div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block" id="bkmrk-proxy_connect_timeou"><div class="text-default text-sm select-text">`proxy_connect_timeout       300;proxy_send_timeout          300;proxy_read_timeout          300;send_timeout                300;client_max_body_size        10G;  # Autorise les uploads jusqu’à 10 Go`</div></div>---

## **3. Gestion des Utilisateurs et Permissions**

### **a. Créer des utilisateurs en masse**

Seafile permet d’importer des utilisateurs via un **fichier CSV**. Exemple de format :

<div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block" id="bkmrk-email%2Cpassword%2Cname%2C"><div class="text-default text-sm select-text">`Email,Password,Name,Quota (in MB)user1@tacampagne.fr,motdepasse1,Jean Dupont,1024user2@tacampagne.fr,motdepasse2,Marie Martin,1024`</div></div>**Commande pour importer** (à exécuter dans le conteneur Seafile) :

<div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block" id="bkmrk-docker-exec--it-seaf"><div class="text-default text-sm select-text">`docker exec -it seafile bashcd /opt/seafile/seafile-server-latest./seafile-admin.sh import-users user_list.csv`</div></div>### **b. Gérer les groupes**

- **Crée un groupe** pour ton équipe : <div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block"><div class="text-default text-sm select-text">`docker exec -it seafile bashcd /opt/seafile/seafile-server-latest./seafile-admin.sh create-group "Equipe Campagne"`</div></div>
- **Ajoute des utilisateurs au groupe** : <div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block"><div class="text-default text-sm select-text">`./seafile-admin.sh add-group-member "Equipe Campagne" user1@tacampagne.fr`</div></div>

### **c. Partager un dossier avec un groupe**

1. Connecte-toi à l’interface web (`https://seafile.tacampagne.fr`).
2. Crée un dossier (ex: `Documents Campagne`).
3. Clique sur **Partager** → Sélectionne le groupe **"Equipe Campagne"** → Choisis les permissions (**Lecture/Ecriture**).

---

## **4. Sauvegardes et Restauration**

### **a. Sauvegarde complète (données + DB)**

**Script de sauvegarde** (`/srv/seafile/backup.sh`) :

<div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block" id="bkmrk-%23%21%2Fbin%2Fbash-backup_d"><div class="text-default text-sm select-text">`#!/bin/bashBACKUP_DIR="/srv/backups/seafile-$(date +%Y-%m-%d)"mkdir -p "$BACKUP_DIR"# Sauvegarde des donnéesdocker-compose -f /srv/seafile/docker-compose.yml exec seafile tar -czvf /tmp/seafile-data.tar.gz /shareddocker cp seafile:/tmp/seafile-data.tar.gz "$BACKUP_DIR"# Sauvegarde de la base de donnéesdocker-compose -f /srv/seafile/docker-compose.yml exec seafile-db mysqldump -uroot -pmotdepassebdd --all-databases > "$BACKUP_DIR/seafile-db.sql"# Nettoyagedocker-compose -f /srv/seafile/docker-compose.yml exec seafile rm /tmp/seafile-data.tar.gz`</div></div>**Automatise avec cron** :

<div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block" id="bkmrk-0-2-%2A-%2A-%2A-%2Fbin%2Fbash-"><div class="text-default text-sm select-text">`0 2 * * * /bin/bash /srv/seafile/backup.sh  # Sauvegarde tous les jours à 2h`</div></div>### **b. Restauration**

1. **Restaure les données** : <div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block"><div class="text-default text-sm select-text">`docker cp "$BACKUP_DIR/seafile-data.tar.gz" seafile:/tmpdocker-compose -f /srv/seafile/docker-compose.yml exec seafile tar -xzvf /tmp/seafile-data.tar.gz -C /`</div></div>
2. **Restaure la DB** : <div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block"><div class="text-default text-sm select-text">`cat "$BACKUP_DIR/seafile-db.sql" | docker-compose -f /srv/seafile/docker-compose.yml exec -T seafile-db mysql -uroot -pmotdepassebdd`</div></div>
3. **Redémarre les conteneurs** : <div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block"><div class="text-default text-sm select-text">`docker-compose -f /srv/seafile/docker-compose.yml restart`</div></div>

---

## **5. Sécurité Avancée**

### **a. Activer le chiffrement côté serveur**

Seafile propose un **chiffrement des fichiers au repos** (server-side encryption) :

1. Active-le dans `docker-compose.yml` : <div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block"><div class="text-default text-sm select-text">`environment:  - SEAFILE_ENABLE_ENCRYPTION=true`</div></div>
2. **Chiffre un dossier existant** : 
    - Va dans l’interface web → Sélectionne un dossier → **Propriétés** → **Activer le chiffrement**.

**Attention** : Si tu perds la clé de chiffrement, les données sont **perdues à jamais**.

### **b. Restreindre l’accès par IP**

Dans ton Nginx, ajoute une **liste blanche d’IPs** pour limiter l’accès :

<div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block" id="bkmrk-location-%2F-%7B-allow-1"><div class="text-default text-sm select-text">`location / {    allow 192.168.1.0/24;  # Remplace par ton réseau local ou les IPs de ton équipe    allow 82.123.45.67;    # IP fixe d’un membre    deny all;    proxy_pass http://<IP_SERVEUR_A>:8000;    ...}`</div></div>### **c. Activer la double authentification (2FA)**

1. Dans l’interface admin (`https://seafile.tacampagne.fr/sysadmin/`), va dans **Paramètres → 2FA**.
2. Active **Google Authenticator** ou **Email OTP**.
3. Demande à tes utilisateurs de configurer le 2FA via leur profil.

---

## **6. Intégration avec d’Outils Externes**

### **a. Synchronisation avec le client desktop**

- **Télécharge le client** : [Seafile Desktop](https://www.seafile.com/en/download/) (Windows/macOS/Linux).
- **Configuration** : 
    - URL du serveur : `https://seafile.tacampagne.fr`
    - Email/mot de passe de l’utilisateur.
- **Options utiles** : 
    - **Synchro sélective** : Pour ne pas tout télécharger.
    - **Verrouillage de fichiers** : Évite les conflits si 2 personnes éditent le même fichier.

### **b. Montage en WebDAV (pour les power users)**

Seafile supporte le **WebDAV** pour monter le stockage comme un disque réseau :

- **URL WebDAV** : `https://seafile.tacampagne.fr/seafdav`
- **Exemple de montage sous Linux** : <div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block"><div class="text-default text-sm select-text">`sudo apt install davfs2echo "https://seafile.tacampagne.fr/seafdav /mnt/seafile davfs user,noauto 0 0" >> /etc/fstabmount /mnt/seafile`</div></div>(L’utilisateur devra entrer son email/mot de passe.)

---

## **7. Monitoring et Logs**

### **a. Vérifier les logs**

- **Logs Seafile** : <div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block"><div class="text-default text-sm select-text">`docker-compose -f /srv/seafile/docker-compose.yml logs -f seafile`</div></div>
- **Logs Nginx** : <div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block"><div class="text-default text-sm select-text">`tail -f /var/log/nginx/seafile.tacampagne.fr-access.log`</div></div>

### **b. Surveiller l’espace disque**

<div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block" id="bkmrk-docker-exec-seafile-"><div class="text-default text-sm select-text">`docker exec seafile du -sh /shared/seafile-data`</div></div>### **c. Alertes par email**

Configure Seafile pour envoyer des alertes (ex : espace disque faible) :

1. Dans l’interface admin, va dans **Paramètres → Email**.
2. Configure un serveur SMTP (ex : ton serveur mail ou Gmail).
3. Active les notifications pour les **quotas** et les **erreurs système**.

---

## **8. Astuces pour les Utilisateurs**

### **a. Partager un fichier avec un externe**

1. **Crée un lien public** : 
    - Clique droit sur un fichier/dossier → **Partager** → **Créer un lien**.
    - Définis une **date d’expiration** et un **mot de passe** si besoin.
2. **Envoie le lien** par email ou messagerie.

### **b. Récupérer un fichier supprimé**

- Seafile garde une **corbeille** (30 jours par défaut).
- Pour restaurer : **Corbeille** → Sélectionne le fichier → **Restaurer**.

### **c. Utiliser l’API**

Seafile propose une [API REST](https://download.seafile.com/published/seafile-manual/deploy/using_seafile_api.md) pour automatiser des tâches (ex : uploads depuis un script Python). Exemple pour lister les dossiers :

<div class="border-default bg-default relative m-0 rounded-md border whitespace-break-spaces" data-testid="code-block" id="bkmrk-curl--u-admin%40tacamp"><div class="text-default text-sm select-text">`curl -u admin@tacampagne.fr:tonmotdepasse https://seafile.tacampagne.fr/api2/repos/`</div></div>---

## **9. Résolution des Problèmes Courants**

<div id="bkmrk-probl%C3%A8me-solution-er"><table><thead><tr><th>Problème</th><th>Solution</th></tr></thead><tbody><tr><td>**Erreur 502 Bad Gateway (Nginx)**</td><td>Vérifie que le conteneur Seafile est démarré (`docker ps`).</td></tr><tr><td>**Synchro bloquée**</td><td>Redémarre le client desktop ou vérifie les logs (`docker logs seafile`).</td></tr><tr><td>**Quota dépassé**</td><td>Augmente le quota via l’interface admin ou supprime des fichiers.</td></tr><tr><td>**Lien public inaccessible**</td><td>Vérifie que le port `8000` est bien exposé et que Nginx proxy correctement.</td></tr></tbody></table>

</div>---

## **10. Pour Aller Plus Loin**

### **a. High Availability (HA)**

Si tu veux une **redondance** (ex : 2 serveurs Seafile) :

- Utilise **Seafile Pro** (version payante) avec support HA.
- Ou configure un **réplica de la base de données** + un partage NFS pour `/shared/seafile-data`.

### **b. Intégration avec OnlyOffice**

Si tu veux éditer des docs en ligne (comme Nextcloud) :

1. Déploie **OnlyOffice** en conteneur Docker.
2. Configure l’intégration dans Seafile : 
    - Dans l’admin, va dans **Paramètres → OnlyOffice**.
    - Renseigne l’URL de ton instance OnlyOffice.

---

## **11. Ressources Utiles**

- **Documentation officielle** : [Seafile Manual](https://manual.seafile.com/)
- **Forum communautaire** : [Seafile Forum](https://forum.seafile.com/)
- **Dépôt Docker** : [Seafile sur Docker Hub](https://hub.docker.com/r/seafileltd/seafile/)

---

## **12. Prochaines Étapes**

1. **Veux-tu que je te génère un script complet pour les sauvegardes incrémentielles (avec rotation) ?**
2. **As-tu besoin d’aide pour configurer OnlyOffice ou un autre outil intégré ?**
3. **Veux-tu un exemple de politique de sécurité (mots de passe, 2FA, etc.) pour ton équipe ?**

Dis-moi ce qui t’intéresse en priorité, et on creuse ! 🛠️