311 lines
3.4 KiB
Markdown
311 lines
3.4 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
|
|
|
|
# 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
|
|
|
|
python3 -c "import secrets; print(secrets.token_hex(32))"
|
|
|
|
|
|
Volumes
|
|
|
|
volumes:
|
|
- /mnt/nas/Useed/Media_useed:/mnt/seedbox:ro # seedbox, lecture seule
|
|
- /mnt/nas/BOB4-Syno:/mnt/nas # NAS, lecture/écriture
|
|
|
|
|
|
Utilisation
|
|
|
|
|
|
|
|
|
|
|
|
Se connecter sur http://ip:5000
|
|
|
|
|
|
|
|
Naviguer dans la seedbox (panneau gauche) avec double-clic
|
|
|
|
|
|
|
|
Naviguer vers le dossier destination sur le NAS (panneau droit)
|
|
|
|
|
|
|
|
Sélectionner un ou plusieurs fichiers/dossiers côté seedbox (clic simple)
|
|
|
|
|
|
|
|
Cliquer sur ⟶ Copier vers NAS
|
|
|
|
|
|
|
|
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 |