Il y a quelques années, je vous proposais un tutoriel pour installer votre propre Seedbox sur un serveur privé (Consulter mon ancien tutoriel : installation d’une Seedbox sous Ubuntu). À l’époque, il fallait mettre les mains dans le terminal, installer Transmission, créer les utilisateurs, configurer les permissions et modifier plusieurs fichiers système.
Une installation qui fonctionnait très bien, mais qui demandait tout de même un peu de patience et quelques connaissances sous Linux.
Depuis, j’ai continué à faire évoluer mon installation et j’ai fini par développer mon propre outil : Seedbox Manager.
L’objectif est simple : automatiser toute la partie installation et configuration, tout en proposant une gestion multi-utilisateurs avec des instances Transmission indépendantes.
J’ai donc décidé de mettre ce projet à disposition gratuitement sur GitHub afin que vous puissiez, vous aussi, en profiter.
Dans ce tutoriel, je vais vous présenter son fonctionnement et vous accompagner dans l’installation de votre propre environnement.
Qu’est-ce que Seedbox Manager ?
Pour ceux qui découvrent le principe, une Seedbox est un serveur distant principalement utilisé pour télécharger et partager des fichiers via le protocole BitTorrent.
L’intérêt est de déporter les transferts sur un serveur disposant généralement d’une bonne connexion Internet et d’un espace de stockage adapté.
Dans mon ancien tutoriel, nous avions installé Transmission manuellement sur Ubuntu Server. Il fallait ensuite créer un utilisateur dédié, configurer les droits d’accès et rendre l’interface accessible à distance.
Avec Seedbox Manager, je suis parti sur une approche différente.
Plutôt que de configurer une seule instance Transmission, le script permet de créer plusieurs environnements indépendants sur un même serveur.
Chaque utilisateur possède sa propre instance Transmission, ses paramètres et ses ports dédiés.
L’ensemble repose sur les utilisateurs Linux, les services systemd et une configuration automatisée.
Les fonctionnalités principales
Voici ce que propose actuellement Seedbox Manager :
- Multi-utilisateurs : création de plusieurs comptes sur un même serveur.
- Instances Transmission indépendantes : chaque utilisateur possède sa propre interface.
- Ports indépendants : configuration séparée des ports RPC et Peer.
- Accès SFTP : récupération des fichiers à distance.
- Isolation des utilisateurs : environnement SFTP restreint grâce au mécanisme chroot.
- Comptes administrateurs : possibilité de créer des comptes avec accès SSH et privilèges sudo.
- Automatisation : installation et génération des configurations nécessaires.
L’idée est de pouvoir utiliser un seul serveur pour plusieurs comptes, sans devoir refaire toute la configuration à chaque nouvel utilisateur.
Ce qu’il vous faut avant de commencer
Avant de passer à l’installation, il faut évidemment disposer d’un serveur.
Seedbox Manager prend actuellement en charge :
- Ubuntu Server 20.04
- Ubuntu Server 22.04
- Ubuntu Server 24.04
Il faut également disposer d’un accès root ou sudo, d’OpenSSH Server et de systemd.
Je recommande de partir sur une installation Ubuntu Server propre, sans ancienne configuration Transmission.
Pour le matériel, tout dépendra de votre utilisation, du nombre d’utilisateurs et surtout de l’espace disque dont vous avez besoin.
Personnellement, je conseille de commencer avec un serveur disposant d’un stockage suffisamment confortable. Il sera toujours possible de faire évoluer la configuration par la suite.
Petite précaution avant de commencer : le script intervient directement sur le système. Il installe plusieurs composants, configure le pare-feu et modifie notamment la configuration SSH. Je vous recommande donc de réaliser cette installation sur un serveur vierge ou préalablement sauvegardé.
Étape 1 : se connecter à son serveur
Nous allons commencer par nous connecter au serveur en SSH.
Depuis macOS ou Linux, ouvrez le Terminal et entrez :
ssh root@IP_DE_VOTRE_SERVEUR
Remplacez bien entendu IP_DE_VOTRE_SERVEUR par l’adresse IP de votre machine.
Sous Windows, vous pouvez utiliser Windows Terminal ou un client SSH.
Une fois connecté, nous allons pouvoir préparer l’installation.
Étape 2 : récupérer Seedbox Manager
Nous allons télécharger le projet directement depuis GitHub.
Pour cela, entrez les commandes suivantes :
apt update
apt install -y git openssh-server
Puis récupérez le dépôt :
git clone https://github.com/metalnodeug/seedbox-manager.git /opt/seedbox-manager
Déplaçons-nous maintenant dans le dossier :
cd /opt/seedbox-manager
Et donnons les droits d’exécution aux scripts :
chmod +x *.sh
chmod +x lib/*.sh
Nous avons maintenant récupéré l’ensemble des fichiers nécessaires.
Étape 3 : lancer l’installation automatique
C’est ici que Seedbox Manager va faire le travail à notre place.
Depuis le répertoire du projet, lancez simplement :
./install.sh
Le script doit être exécuté avec les droits administrateur. Si vous n’êtes pas connecté en root, utilisez :
sudo ./install.sh
L’installation va notamment :
- Mettre à jour le système.
- Installer Transmission.
- Installer Nginx.
- Installer et configurer UFW.
- Préparer les répertoires nécessaires.
- Créer le groupe dédié aux utilisateurs Seedbox.
- Configurer le service SSH pour l’accès SFTP.
- Mettre en place les règles de restriction des utilisateurs.
Le script configure également les règles du pare-feu. Il autorise notamment SSH, HTTP et HTTPS, puis applique une politique qui bloque par défaut les connexions entrantes non autorisées.
Il sauvegarde également la configuration SSH existante avant de la modifier.
C’est une étape importante : prenez le temps de lire les messages affichés dans le terminal et vérifiez que l’installation se termine correctement.
Attention : si votre serveur utilise un port SSH personnalisé ou des règles réseau particulières, vérifiez la configuration avant de lancer le script. Gardez votre session SSH ouverte pendant les vérifications afin de ne pas perdre l’accès à votre serveur.
Une fois l’installation terminée, le script indique que Seedbox Manager est installé dans :
/opt/seedbox-manager
Nous pouvons maintenant passer à la création de notre premier utilisateur.
Étape 4 : créer son premier utilisateur
C’est probablement l’une des fonctionnalités les plus intéressantes du projet.
Nous allons pouvoir créer un compte indépendant sans avoir à configurer manuellement tous les dossiers, les permissions et les services.
Depuis le répertoire Seedbox Manager, lancez :
./add-user.sh
Le script vous accompagne dans la création du compte et vous demande plusieurs informations :
- Le nom de l’utilisateur.
- Le type de compte.
- Le mot de passe système.
- Le mot de passe RPC de Transmission.
- Le port RPC à utiliser.
Deux types de comptes sont proposés.
Le compte Seedbox
C’est celui que je recommande pour une utilisation classique.
Il est destiné à une personne qui souhaite utiliser Transmission et récupérer ses fichiers à distance.
Le compte dispose d’un accès SFTP restreint et ne possède pas d’accès SSH général au serveur.
L’objectif est de limiter son environnement à son espace prévu.
Le compte administrateur
Le second type de compte est destiné à une personne qui doit pouvoir administrer le serveur.
Il dispose d’un accès SSH complet et de privilèges sudo.
Il faut donc bien réfléchir au type de compte que vous souhaitez créer. Pour un simple utilisateur de Seedbox, le profil Seedbox est largement suffisant.
Étape 5 : accéder à Transmission
Une fois l’utilisateur créé, son instance Transmission est disponible sur le serveur.
L’accès à l’interface Web se fait depuis un navigateur :
http://IP_DU_SERVEUR:PORT_RPC
Remplacez l’adresse IP et le port par les informations correspondant à votre installation.
Vous pourrez alors retrouver l’interface de Transmission et gérer vos téléchargements.
Chaque utilisateur dispose de sa propre instance. Il est donc possible d’héberger plusieurs environnements sur le même serveur, avec des ports RPC distincts.
C’est précisément ce qui fait l’intérêt de cette architecture.
Étape 6 : récupérer ses fichiers avec SFTP
Une fois les téléchargements terminés, il faut pouvoir récupérer les fichiers sur son ordinateur.
Seedbox Manager prévoit un accès SFTP pour les comptes Seedbox.
Vous pouvez utiliser votre logiciel habituel, comme FileZilla, Cyberduck ou Transmit.
Il suffit de renseigner les informations suivantes :
- Protocole : SFTP
- Hôte : adresse IP du serveur
- Port : port SSH du serveur
- Identifiant : nom de l’utilisateur créé
- Mot de passe : mot de passe du compte
L’utilisateur Seedbox est limité à son environnement grâce au mécanisme chroot configuré dans SSH.
Vous pouvez ainsi récupérer vos fichiers sans donner un accès général au système.
Gérer les utilisateurs
L’intérêt de Seedbox Manager ne s’arrête pas à l’installation.
Le projet contient également plusieurs scripts pour gérer les comptes et l’environnement.
Tous les scripts se trouvent dans :
/opt/seedbox-manager
Pour ajouter un utilisateur :
./add-user.sh
Pour supprimer un utilisateur :
./remove-user.sh
Le script de suppression est particulièrement important à utiliser avec précaution : il supprime le service associé, le compte Linux, les fichiers et la configuration de l’utilisateur.
Pensez donc à sauvegarder les données importantes avant toute suppression.
Le dépôt contient également des scripts dédiés à la sauvegarde, à la mise à jour et à la réinitialisation du système. Pour connaître leur comportement exact et les éventuelles conséquences, consultez leur documentation et leur code avant de les utiliser.
Attention : le script reset.sh supprime tout ce qui est lié au système Seedbox. Il ne faut surtout pas le lancer sans avoir vérifié les données concernées et réalisé une sauvegarde.
Quelques recommandations de sécurité
Même si Seedbox Manager automatise une grande partie de la configuration, il reste important de garder à l’esprit que vous administrez un véritable serveur exposé à Internet.
Je vous recommande notamment :
- D’utiliser des mots de passe robustes.
- De ne pas partager les identifiants administrateurs.
- De conserver Ubuntu à jour.
- De vérifier les ports ouverts sur le pare-feu.
- De sauvegarder régulièrement vos données.
- De ne donner les privilèges sudo qu’aux personnes qui en ont réellement besoin.
Le projet est fourni sans garantie et peut présenter des problèmes selon les configurations. Il est recommandé pour les environnements de test, les utilisateurs avancés et les serveurs auto-hébergés.
Télécharger Seedbox Manager
Le projet est disponible gratuitement sur GitHub.
Vous pouvez récupérer le code source, consulter les scripts, signaler un problème ou proposer une amélioration.
Le projet est distribué sous licence MIT.
Conclusion
Avec Seedbox Manager, j’ai voulu simplifier une installation que je réalisais auparavant entièrement à la main.
Mon ancien tutoriel reste utile pour comprendre comment fonctionne une installation Transmission classique, mais je voulais aller plus loin et disposer d’un outil capable de reproduire rapidement une configuration multi-utilisateurs.
Le script permet désormais de préparer l’environnement, de créer des comptes indépendants et de gérer les accès sans devoir reprendre toute la configuration à chaque fois.
C’est un projet personnel que je vais continuer à faire évoluer en fonction de mes besoins et des retours que je recevrai.
Si vous avez l’occasion de le tester, n’hésitez pas à me faire part de vos remarques directement sur GitHub. Les retours sont toujours intéressants pour améliorer le projet.
Et si vous avez des idées de fonctionnalités, je suis également preneur !
Retrouvez Seedbox Manager sur GitHub
Petit rappel : utilisez votre Seedbox uniquement pour télécharger et partager des contenus que vous êtes autorisé à utiliser et à distribuer.
