105 lines
3.6 KiB
Markdown
105 lines
3.6 KiB
Markdown
# SeedMover
|
|
|
|
Gestionnaire de transferts dual-pane entre une seedbox et un NAS, accessible depuis navigateur et smartphone.
|
|
|
|
## Fonctionnalités
|
|
|
|
- **Dual-pane** — navigation indépendante dans chaque panneau
|
|
- **Multi-protocoles** — Local et SFTP inclus, extensible via plugins
|
|
- **File d'attente** — transferts séquentiels avec progression temps réel, pause et stop
|
|
- **Historique** — suivi de tous les transferts (taille, durée, date, statut)
|
|
- **Connexions** — ajout, édition, test depuis l'interface, persistées entre redémarrages
|
|
- **Panneaux par défaut** — sauvegarde la vue de démarrage en un clic
|
|
|
|
## Démarrage rapide
|
|
|
|
```bash
|
|
# Générer une SECRET_KEY
|
|
python3 -c "import secrets; print(secrets.token_hex(32))"
|
|
|
|
# Lancer
|
|
docker compose up -d
|
|
```
|
|
|
|
Accès : `http://<ip>:5000`
|
|
|
|
## Configuration `docker-compose.yml`
|
|
|
|
| Variable | Défaut | Description |
|
|
| --- | --- | --- |
|
|
| `SEEDBOX_PATH` | `/mnt/seedbox` | Chemin local seedbox |
|
|
| `NAS_PATH` | `/mnt/nas` | Chemin local NAS |
|
|
| `APP_USERNAME` | `admin` | Identifiant |
|
|
| `APP_PASSWORD` | `changeme` | Mot de passe |
|
|
| `SECRET_KEY` | _(à changer)_ | Clé de session Flask |
|
|
| `CACHE_TTL` | `60` | TTL du cache de listing (secondes) |
|
|
| `HISTORY_MAX` | `50` | Nombre max d'entrées dans l'historique |
|
|
| `SESSION_LIFETIME` | `86400` | Durée de session (secondes) |
|
|
|
|
## Ajouter un protocole
|
|
|
|
Créer `plugins/monprotocole.py`, hériter de `AbstractFS`, implémenter les méthodes, définir `PLUGIN_NAME` et `PLUGIN_LABEL`. Le plugin est détecté automatiquement au démarrage.
|
|
|
|
## Structure
|
|
|
|
```
|
|
seedmover/
|
|
├── app.py
|
|
├── plugins/
|
|
│ ├── base.py ← interface abstraite
|
|
│ ├── local.py ← système de fichiers local
|
|
│ └── sftp.py ← SFTP via Paramiko
|
|
├── data/ ← volume Docker (connexions, historique)
|
|
├── templates/
|
|
│ ├── index.html
|
|
│ └── login.html
|
|
└── docker-compose.yml
|
|
```
|
|
|
|
### Générer une SECRET_KEY sécurisée
|
|
|
|
```bash
|
|
python3 -c "import secrets; print(secrets.token_hex(32))"
|
|
```
|
|
|
|
### Volumes
|
|
|
|
```yaml
|
|
volumes:
|
|
- /mnt/nas/Useed/Media_useed:/mnt/seedbox:ro # seedbox, lecture seule
|
|
- /mnt/nas/BOB4-Syno:/mnt/nas # NAS, lecture/écriture
|
|
```
|
|
|
|
## Utilisation
|
|
|
|
1. Se connecter sur `http://ip:5000`
|
|
2. Naviguer dans la seedbox (panneau gauche) avec double-clic
|
|
3. Naviguer vers le dossier destination sur le NAS (panneau droit)
|
|
4. Sélectionner un ou plusieurs fichiers/dossiers côté seedbox (clic simple)
|
|
5. Cliquer sur **⟶ Copier vers NAS**
|
|
6. Suivre la progression dans la file de transfert en bas
|
|
|
|
### Raccourcis
|
|
|
|
- **Double-clic** — ouvrir un dossier
|
|
- **Clic simple** — sélectionner/désélectionner
|
|
- **↻ Actualiser** — forcer un rechargement (bypass cache)
|
|
- **📁** — créer un nouveau dossier
|
|
- **✏ Renommer** — renommer un élément côté NAS
|
|
- **⏸ Pause / ▶ Reprendre** — suspendre le transfert en cours
|
|
- **⏹ Stop** — annuler le transfert et supprimer le fichier partiel
|
|
- **Échap** — fermer les modales
|
|
- **Entrée** — valider les modales
|
|
|
|
## Stack technique
|
|
|
|
- **Backend** : Python 3.12, Flask, Flask-SocketIO, Eventlet
|
|
- **Frontend** : HTML/CSS/JS vanilla, Socket.IO
|
|
- **Transport** : copie par chunks de 4MB avec progression WebSocket
|
|
|
|
## Notes techniques
|
|
|
|
- Streaming chunk par chunk (1MB) sans buffer intermédiaire — RAM stable pendant les transferts
|
|
- `malloc_trim()` appelé après chaque transfert pour rendre la mémoire au système
|
|
- Verrou par connexion pour thread-safety Paramiko (évite les "Garbage packet")
|
|
- Prefetch SFTP désactivé pour éviter le chargement du fichier entier en RAM |