« Qbittorrent » : différence entre les versions

De Wiki doc

(→‎Usage serveur : Ajout d'une méthode de journalisation)
(Correction de fautes + changement de certaines balises + ordonnancement de la page en sections + ajout d'une section "Script post téléchargement")
 
Ligne 1 : Ligne 1 :
[[Category:Outils de téléchargements]]
[[Category:Outils de téléchargements]]


[https://www.qbittorrent.org/ Qbittorrent] est un client [https://fr.wikipedia.org/wiki/BitTorrent Bittorrent] libre multiplate-forme sur [https://fr.wikipedia.org/wiki/FreeBSD FreeBSD], [https://fr.wikipedia.org/wiki/Linux Linux], [https://fr.wikipedia.org/wiki/MacOS MacOS], [https://fr.wikipedia.org/wiki/OS/2 OS/2] et [https://fr.wikipedia.org/wiki/Microsoft_Windows Windows]. Basé sur le cadriciel [https://www.qt.io/ 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.
[https://www.qbittorrent.org/ Qbittorrent] est un client [https://fr.wikipedia.org/wiki/BitTorrent Bittorrent] libre multi-plateforme sur [https://fr.wikipedia.org/wiki/FreeBSD FreeBSD], [https://fr.wikipedia.org/wiki/Linux Linux], [https://fr.wikipedia.org/wiki/MacOS MacOS], [https://fr.wikipedia.org/wiki/OS/2 OS/2] et [https://fr.wikipedia.org/wiki/Microsoft_Windows Windows]. Basé sur le cadriciel [https://www.qt.io/ 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=
=Usage serveur=
Ce logiciel peut être utilisé dans le cadre d'un service de téléchargement ''Bittorrent'' hébergé sur un serveur ([https://fr.wikipedia.org/wiki/Seedbox seedbox]). Dans ce cas, une interface graphique n'est pas requise et il est souhaitable de passer par ''HTTP'' pour l'interaction avec lui.
Ce logiciel peut être utilisé dans le cadre d'un service de téléchargement ''Bittorrent'' hébergé sur un serveur ([https://fr.wikipedia.org/wiki/Seedbox seedbox]). Dans ce cas, une interface graphique n'est pas requise et il est souhaitable de passer par ''HTTP'' pour l'interaction avec lui.


Installtion
=Installation=
  apt install qbittorrent-nox
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
Ajout d'un utilisateur pour lancer le service
Ligne 37 : Ligne 38 :
  systemctl status qbittorrent-nox
  systemctl status qbittorrent-nox


Une chiée de port a été ouvert et c'est par le ''8080 TCP'' que l'on prendre en main l'outil.
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.


{{info|L'identifiant par défaut est <syntaxhighlight lang="bash" inline>admin</syntaxhighlight> avec comme mot de passe <syntaxhighlight lang="bash" inline>adminadmin</syntaxhighlight>. Il est bien évidemment destiné à être changé par vos soins.}}
{{info|L'identifiant par défaut est <code>admin</code> avec comme mot de passe <code>adminadmin</code>. Il est bien évidemment destiné à être changé par vos soins.}}


La configuration du logiciel se trouve dans le fichier <syntaxhighlight lang="bash" inline>~/.config/qBittorrent/qBittorrent.conf</syntaxhighlight>. 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.
==Source de la section==
* https://www.linuxcapable.com/install-qbittorrent-on-debian-linux/
 
=Configuration=
La configuration du logiciel se trouve dans le fichier <code>~/.config/qBittorrent/qBittorrent.conf</code>. 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 [https://github.com/qbittorrent/qBittorrent/issues/6033#issuecomment-266416355 journaliser] les événements du logiciel avec les paramètres suivants :
Vous pouvez [https://github.com/qbittorrent/qBittorrent/issues/6033#issuecomment-266416355 journaliser] les événements du logiciel avec les paramètres suivants :


Ligne 57 : Ligne 63 :


Où :
Où :
* '''FileLogger\Backup=''' : sauvegarde du fichier de journal lorsque celui-ci est plus grand que la limite définie dans <syntaxhighlight lang="bash" inline>FileLogger\MaxSize= x</syntaxhighlight> (mégaoctet)
* '''FileLogger\Backup=''' : sauvegarde du fichier de journal lorsque celui-ci est plus grand que la limite définie dans <code>FileLogger\MaxSize= x</code> (mégaoctet)
* '''FileLogger\DeleteOld=''' : supprime le journal (roulement) après la valeur de <syntaxhighlight lang="bash" inline>FileLogger\Age= 6</syntaxhighlight> où  <syntaxhighlight lang="bash" inline>FileLogger\AgeType= x</syntaxhighlight> dont ''x'' peut être ''0=jours''; ''1=mois''; ''2=années''
* '''FileLogger\DeleteOld=''' : supprime le journal (roulement) après la valeur de <code>FileLogger\Age= 6</code> où  <code>FileLogger\AgeType= x</code> 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, [https://github.com/qbittorrent/qBittorrent/issues/8016 permettre la lecture] des fichiers par un autre compte de service les rendant disponible via un protocole de partage sur réseau ''TCP/IP''.
 
<syntaxhighlight lang="bash">
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_
</syntaxhighlight>


==Source de la section==
chmod +x /usr/local/bin/post-fini.sh
* https://www.linuxcapable.com/install-qbittorrent-on-debian-linux/
 
Ce fichier exécutable est alors à spécifier dans la configuration de ''Qbittorrent'' au menu <code>Option</code> (icône de roue crantée) > <code>Téléchargements</code> > <code>Lancer un programme externe à la fin d'un téléchargement</code> > entrer dans le champ de texte <code>/bin/bash /usr/local/bin/post-fini.sh "%F"</code> et sauvegarder.
 
Cette opération a pour effet d'ajouter la section suivante à la configuration du démon
 
<syntaxhighlight lang="ini">
[AutoRun]
enabled=true
program=/bin/bash /usr/local/bin/post-fini.sh \"%F\"
</syntaxhighlight>

Dernière version du 15 février 2025 à 16:03


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\"