Qbittorrent

De Wiki doc

Révision datée du 15 février 2025 à 16:03 par Ycharbi (discussion | contributions) (Correction de fautes + changement de certaines balises + ordonnancement de la page en sections + ajout d'une section "Script post téléchargement")
(diff) ← Version précédente | Voir la version actuelle (diff) | Version suivante → (diff)


Qbittorrent est un client Bittorrent libre multi-plateforme sur FreeBSD, Linux, MacOS, OS/2 et Windows. Basé sur le cadriciel QT, il dispose d'un démon, d'une interface graphique optionnelle, et d'une interface WEB installable dans le cas d'une nécessité d'accès distant. Il est léger et très simple à mettre en œuvre dans un usage serveur.

Usage serveur

Ce logiciel peut être utilisé dans le cadre d'un service de téléchargement Bittorrent hébergé sur un serveur (seedbox). Dans ce cas, une interface graphique n'est pas requise et il est souhaitable de passer par HTTP pour l'interaction avec lui.

Installation

Installation via le paquet disponible dans la distribution GNU/Linux Debian 11

apt install --no-install-recommends qbittorrent-nox

Ajout d'un utilisateur pour lancer le service

adduser --system --group qbittorrent-nox

Création du service

mkdir -p /usr/local/etc/systemd/system/
vim /usr/local/etc/systemd/system/qbittorrent-nox.service
[Service]
Type=forking
User=qbittorrent-nox
Group=qbittorrent-nox
UMask=007
ExecStart=/usr/bin/qbittorrent-nox -d --webui-port=8080
Restart=always

[Install]
WantedBy=multi-user.target
ln -s /usr/local/etc/systemd/system/qbittorrent-nox.service /etc/systemd/system/

Activation du service et démarrage du programme

systemctl daemon-reload
systemctl enable qbittorrent-nox
systemctl start qbittorrent-nox
systemctl status qbittorrent-nox

Une chiée de port a par la suite été ouvert et c'est par le TCP/8080 que l'on prendre en main l'outil.

INFORMATION

L'identifiant par défaut est admin avec comme mot de passe adminadmin. Il est bien évidemment destiné à être changé par vos soins.

Source de la section

Configuration

La configuration du logiciel se trouve dans le fichier ~/.config/qBittorrent/qBittorrent.conf. En l'absence de modification de celle-ci, ce dernier est presque vide et les valeurs par défaut sont chargées de façon transparente au démarrage. Ce n'est qu'à la modification d'une option qu'il se remplira des valeurs de chaque onglet des paramètres.

Journalisation

Vous pouvez journaliser les événements du logiciel avec les paramètres suivants :

[Application]
FileLogger\Enabled=true
FileLogger\Age=6
FileLogger\DeleteOld=true
FileLogger\Backup=true
FileLogger\AgeType=1
FileLogger\Path=/chemin/du/fichier/de/journal/
FileLogger\MaxSize=10

Où :

  • FileLogger\Backup= : sauvegarde du fichier de journal lorsque celui-ci est plus grand que la limite définie dans FileLogger\MaxSize= x (mégaoctet)
  • FileLogger\DeleteOld= : supprime le journal (roulement) après la valeur de FileLogger\Age= 6FileLogger\AgeType= x dont x peut être 0=jours; 1=mois; 2=années

Script post téléchargement

Il est possible de faire exécuter un script par le démon à la fin d'un téléchargement. Ceci peut être utile pour, par exemple, permettre la lecture des fichiers par un autre compte de service les rendant disponible via un protocole de partage sur réseau TCP/IP.

cat << '_EOF_' > /usr/local/bin/post-fini.sh
#/bin/bash

# Changement des permissions par défaut des fichiers téléchargés
find "$1" -type f -exec chmod 644 -- {} +
find "$1" -type d -exec chmod 755 -- {} +
_EOF_
chmod +x /usr/local/bin/post-fini.sh

Ce fichier exécutable est alors à spécifier dans la configuration de Qbittorrent au menu Option (icône de roue crantée) > Téléchargements > Lancer un programme externe à la fin d'un téléchargement > entrer dans le champ de texte /bin/bash /usr/local/bin/post-fini.sh "%F" et sauvegarder.

Cette opération a pour effet d'ajouter la section suivante à la configuration du démon

[AutoRun]
enabled=true
program=/bin/bash /usr/local/bin/post-fini.sh \"%F\"