🇬🇧 English · 🇫🇷 Français

S'applique à Hydranos 4.4.

Cette page s'adresse à toute personne qui ouvre l'interface web sur le port 8199 pour la première fois. Elle parcourt l'en-tête, les quatorze onglets, les listes de torrents, le menu contextuel et le panneau de détail, et indique quelle page du wiki couvre chaque partie en profondeur. À la fin, vous saurez où se trouve chaque chose, ce qui tourne en arrière-plan tant qu'un onglet est ouvert, et ce qui a encore des limites en 4.4.

La barre du haut affiche HYDRANOS, le sous-titre Démon torrent (Torrent Daemon) et la version en cours d'exécution. Quand une version plus récente existe, un lien màj {v} (update {v}) apparaît à côté de la version ; la vérification lit les tags de Kheopsian/Hydranos sur GitHub (voir Exploiter Hydranos).

Les chiffres à droite portent sur l'instance entière (moteurs race et hoard additionnés) :

Les compteurs cumulés et leur origine sont expliqués sur Supervision & journaux.

• IP de sortie (Exit IP) : rafraîchie toutes les 2 minutes ; cliquez dessus pour la rafraîchir tout de suite (info-bulle Refresh the IP now). Le chiffre n'est pas affiché du tout quand l'instance ne fait tourner aucun moteur.
• Incognito (l'icône en forme d'œil, info-bulle Anonymiser noms, catégories et IP pour les captures (Anonymize names, categories & IPs for screenshots)) : remplace les noms de torrents, catégories, IP, chemins et trackers par des hachages dans tous les tableaux, pour que vous puissiez faire une capture d'écran sans risque. Le réglage est stocké dans ce navigateur uniquement et recharge la page quand vous le basculez. Il change l'affichage, rien sur le serveur.
• Polygone réseau (la petite forme à droite d'Incognito) : un point par moteur de cette instance ; son info-bulle indique {n} engines — suivi du pire état. La couleur du point indique seulement si la vérification sortante de l'IP de sortie de ce moteur a obtenu une réponse : vert (la sonde de sortie a répondu (exit probe answered)) = un service d'écho extérieur a renvoyé une adresse ; ambre (pas encore de réponse par son interface (no answer yet from its interface)) = le moteur est épinglé sur une interface (Linux seulement en 4.4) et aucune réponse n'est encore revenue par elle, par exemple pendant qu'un tunnel s'établit ; rouge (la sonde de sortie n'a pas eu de réponse (exit probe got no answer)) = aucune réponse du tout. Vert ne veut pas dire que les pairs peuvent se connecter à vous. Cliquez sur le polygone pour ouvrir le panneau Réseau (Network) : une ligne par moteur, nommée par son identifiant de moteur, puis le rôle, l'interface sur laquelle il est épinglé (ou default route), port {port} et ses IPv4/IPv6 de sortie. Échap le ferme. La page relit ces valeurs toutes les 30 secondes ; le serveur les remesure toutes les 3 minutes, ou immédiatement quand vous cliquez sur IP de sortie. Que les pairs puissent joindre un moteur n'est affiché nulle part dans la page en 4.4 (l'info-bulle de la ligne renvoie à un « point de santé » que la page ne dessine pas) : lisez-le dans GET /api/port-forward (engines[].reachable, inbound_peers). Ce que signifient ces valeurs et comment les changer : Réseau : ports & redirection et VPN & sortie réseau.
• Se déconnecter (Sign out ; l'icône porte-et-flèche tout à droite) : oublie la clé API que détient ce navigateur et recharge sur la boîte de connexion ; un cookie de session du shim qBittorrent, si ce navigateur en a un, est aussi clos (POST /api/v2/auth/logout). La clé elle-même reste valide, si bien que les autres navigateurs et la pile *arr continuent de fonctionner (voir Connexion et déconnexion plus bas).

Une bannière Pause au démarrage : {engines} n'annonce rien (Startup pause: {engines} not announcing) avec un bouton Démarrer maintenant (Start now) apparaît au-dessus des onglets, sur chaque onglet, tant que start_paused retient des moteurs après un démarrage : aucune annonce ni connexion de pair ne part tant que vous n'avez pas cliqué sur Démarrer maintenant ; les torrents que vous avez arrêtés vous-même restent arrêtés (voir File d'attente, limites de partage et de débit et Moteurs : race & hoard).

Si data_dir se trouve sur un stockage réseau (NFS, SMB/CIFS ou FUSE sous Linux ; un lecteur réseau ou un chemin UNC sous Windows ; jamais détecté sur les autres systèmes), une barre orange Configuration détectée sur un stockage réseau ({kind})… (Config on network storage detected ({kind})…) vous demande de garder des sauvegardes de data_dir ; Compris (Got it) la masque dans ce navigateur.

La barre d'onglets apparaît toujours dans cet ordre. L'onglet actif est conservé dans la barre d'adresse (http://hydranos.example.org:8199/#hoard), si bien qu'un favori ou un rechargement rouvre le même onglet.

Deux onglets portent un badge quand quelque chose demande votre attention. Race affiche un badge rouge avec le nombre de torrents bloqués (des torrents race que le drain ne peut ni supprimer ni graduer, voir Drain race & graduation) ; cliquer dessus ouvre l'historique du drain. Trackers affiche le nombre de trackers qui demandent une action ou qui sont limités/injoignables : le badge est rouge quand au moins un demande une action, ambre quand ils sont seulement limités ou injoignables. Les deux badges se rafraîchissent toutes les 30 secondes.

L'assistant d'import pour qBittorrent et Transmission n'est pas un onglet : il s'ouvre de lui-même à chaque chargement de page tant que rien n'a été importé, jusqu'à ce que vous cliquiez sur Passer (Skip) dans ce navigateur (le choix est stocké dans ce navigateur uniquement), puis plus tard depuis Config › Paramètres avancés (default.toml) › Import › Importer… (Import…). Son récapitulatif liste les échecs avec leur motif, et Réessayer les {n} échecs (Retry the {n} failed) les relance sans retaper le mot de passe (voir Migrer depuis qBittorrent).

Les onglets Race et Hoard affichent un tableau de torrents. Il n'y a pas de boutons par ligne : un clic ouvre le panneau de détail, un clic droit ouvre le menu contextuel.

• Un clic sélectionne une ligne et ouvre son panneau de détail.
• Ctrl-clic (Cmd-clic sous macOS) ajoute ou retire une ligne ; Maj-clic sélectionne une plage parmi les lignes affichées.
• Ctrl+A sur l'onglet Hoard sélectionne tous les torrents qui correspondent à la recherche, aux puces et aux facettes en cours, pas seulement les lignes dessinées à l'écran. Le nombre s'affiche brièvement sous la forme {n} selected. La sélection est mémorisée comme le filtre lui-même : si le filtre change, la sélection est abandonnée ; si davantage de torrents correspondent au moment où vous agissez, l'interface redemande confirmation avec le nouveau nombre. Ctrl+A ne fait rien sur l'onglet Race.
• Échap ou un clic à l'extérieur efface la sélection et ferme les panneaux.

Faites un clic droit sur une ligne sélectionnée. Le menu a pour titre {n} torrent selected ({n} torrents selected pour plusieurs) et comporte jusqu'à cinq groupes :

• Limiter le débit… ouvre Limit rate: {n} torrents avec Limite d'envoi (Kio/s) (Upload limit (KiB/s)) et Limite de réception (Kio/s) (Download limit (KiB/s)) : le plafond propre au torrent, 0 = pas de plafond propre (celui du moteur s'applique toujours), un champ vide garde la valeur actuelle. Avec un seul torrent sélectionné, les champs sont préremplis depuis le démon.
• Limites de partage… ouvre Share limits: {n} torrents avec Limite de ratio (Ratio limit), Limite de durée de seed (minutes) (Seeding time limit (minutes)) et Limite de seed inactif (minutes) (Inactive seeding time limit (minutes)) : -2 = celle du moteur, -1 = pas de limite, vide = inchangé. Un seed qui doit encore à son tracker son temps de seed minimum n'est jamais arrêté ni retiré. Ce que font les limites : File d'attente, limites de partage et de débit.
• Téléchargement séquentiel et Première/dernière pièce d'abord basculent sur toute la sélection ; la coche n'apparaît que quand tous les torrents sélectionnés ont le réglage. Les coches sont lues depuis le démon pour 50 torrents sélectionnés au plus ; au-delà, ou après Ctrl+A sur un filtre, elles s'affichent décochées et un clic active le réglage. Voir la section Ordre de téléchargement de Ajouter des torrents & données existantes.
• Changer de catégorie + déplacer les fichiers › vers une catégorie qui tourne dans un autre moteur avertit que le torrent cesse de seeder pendant la copie de ses données, puis continue dans ce moteur (suivez-le sur Jobs).

Ce que chaque élément fait aux données, aux liens physiques et aux catégories est décrit sur Jobs, actions groupées & déplacement ; sur les lignes qui viennent d'un autre nœud, plusieurs éléments échouent ou agissent sur la copie locale (voir Nœuds & plusieurs machines).

Que vous ayez sélectionné une ligne ou des milliers, chaque élément du menu contextuel, sauf le groupe Exporter, fonctionne de la même façon : la page envoie la sélection au serveur, qui lance une tâche groupée (bulk task) et renvoie son identifiant. Si la tâche dure plus de 400 ms, un panneau de progression s'ouvre avec une barre et des lignes de résultat comme {n} done, {n} refused (cooldown), {n} not on this node, {n} left in place (hardlinks) ou {n} failed.

Les trois éléments Exporter ne sont pas des tâches groupées : le navigateur télécharge le fichier directement depuis POST /api/torrents/export, sans panneau de progression. Télécharger les .torrent (.zip) demande d'abord s'il faut Garder les trackers (Keep trackers) ou Retirer les trackers (Remove trackers), car le .torrent d'un tracker privé contient votre passkey.

flowchart LR
    A["Clic droit sur les lignes sélectionnées"] --> B["Élément du menu contextuel"]
    B -->|"tout groupe sauf Export"| C["POST /api/selection/:action<br/>sélection + paramètres"]
    C --> D["Le serveur lance une tâche groupée<br/>et renvoie son id"]
    D --> E["Panneau de progression<br/>affiché après 400 ms"]
    E -->|"interroge"| F["GET /api/selection/jobs/:id"]
    F --> E
    E -->|"Annuler"| G["POST /api/selection/jobs/:id/cancel<br/>s'arrête entre deux torrents"]

• Réduire (Minimize) ancre le panneau dans un coin ; Annuler (Cancel) arrête la tâche entre deux torrents ; Fermer (Close) fait disparaître une tâche terminée.
• Le panneau survit à un rechargement de la page : le navigateur garde les identifiants des tâches et s'y rattache. Le serveur garde une tâche terminée consultable pendant une heure.
• Une tâche groupée vit uniquement dans la mémoire du démon. Après un redémarrage, son résultat est perdu, et elle n'apparaît jamais sur l'onglet Jobs.
• Au-delà de 500 torrents, Arrêter, Démarrer et les deux éléments Supprimer demandent d'abord une confirmation.

Une tâche groupée n'est pas un job. Les Jobs sont uniquement les déplacements de données persistants listés sur l'onglet Jobs ; Changer de catégorie + déplacer les fichiers › et Déplacer vers un dossier… lancent un tel job pour chaque torrent dont les données doivent bouger. Voir Jobs, actions groupées & déplacement.

Le moteur hoard est conçu pour de très grosses bibliothèques, donc sa liste fonctionne différemment de la liste race :

• Côté serveur. La recherche, le tri, les puces d'état et les facettes sont appliqués par le serveur. Seules les 500 premières lignes correspondantes sont dessinées ; affinez le filtre ou le tri pour voir les autres. Ctrl+A agit malgré tout sur toutes les correspondances.
• Recherche (Search…) : les mots se combinent (tous doivent correspondre), ., _ et - comptent comme des espaces, et 6 caractères hexadécimaux ou plus correspondent à un info hash.
• Puces d'état (une à la fois, avec les nombres) : Tout (All), En partage (Seeding), En partage actif (Actively Seeding), En téléchargement (Downloading), Forced, Arrêté (Stopped), En file (Queued), Vérification (Checking), Erreur de tracker (Tracker Error), Erreur (Error).
• Facettes (les listes de filtres à côté du tableau) : groupes Erreurs de tracker (Tracker errors ; seulement tant qu'un tracker est en erreur : Mort chez le tracker (Dead on the tracker), Passkey invalide (Bad passkey), Quota atteint (Rate-limited), Tracker injoignable (Tracker unreachable), Autre erreur (Other error)), Trackers, Catégories (Categories), Tags, plus les puces No tracker, Uncategorized, Untagged. Cliquez sur une puce pour inclure, clic droit pour exclure. Plusieurs puces se combinent.
• Retirer les filtres (Reset filters) apparaît dès que quelque chose filtre, et efface tout.
• Badges d'état des lignes : stopped (arrêté par vous, survit à un redémarrage), queued (en attente d'un emplacement de téléchargement, ou d'un emplacement de seed quand queueing est actif), error (ses données n'ont pas pu être lues).

La liste Race est plus simple : tout le moteur race est récupéré d'un coup, la recherche filtre dans le navigateur (mêmes règles de correspondance), et il n'y a ni puces ni facettes. Elle liste les torrents de tous les moteurs de rôle race de cette instance.

Sur les deux listes et les deux tableaux de pairs : cliquez sur un en-tête pour trier, faites-le glisser pour réordonner, faites glisser son bord pour redimensionner, et faites un clic droit sur un en-tête pour ouvrir le menu Colonnes (Columns) afin d'afficher ou masquer des colonnes (par exemple Chemin d'enregistrement, Liens physiques (Hardlinks) ou Vérifié (Checked) sur le tableau Hoard). La disposition est enregistrée dans ce navigateur.

Cliquez sur une ligne pour ouvrir son panneau de détail sous le tableau. Il se rafraîchit toutes les 3 secondes tant qu'il est ouvert.

Sur l'onglet Info :

• Général (General) : état, progression, taille, téléchargé, envoyé, ratio, Chemin d'enregistrement, Info hash (Info Hash).
• Débit et connexions (Speed & Connections) : débits, Limites de débit (Speed limits : ↑ … · ↓ … : le plafond propre au torrent, … (engine) quand celui du moteur est le plus serré, ou illimité (unlimited)), Limites de partage (Share limits : ratio … · seeding … min · inactive … min, aucune (none) pour un champ sans limite, (engine) là où la valeur vient du moteur, puis → l'action, par exemple arrêt (stop), quand une limite est réglée), moyennes, pairs et seeds connectés, pièces et taille de pièce, date d'ajout, Temps de partage (Seeding Time) (le panneau race affiche aussi les seeds/leechers de l'essaim).
• Pairs connectés (Connected Peers) : une carte des Pièces (Pieces) et le tableau des pairs (IP, Client, Progression (Progress), Descendant (Down), Montant (Up), Téléchargé (Downloaded), Envoyé (Uploaded), Drapeaux (Flags)), qui défile à l'intérieur de sa carte. Chaque ligne a un bouton Bannir (Ban) : l'adresse est déconnectée tout de suite et refusée à partir de là. Les bannissements sont listés et retirés dans Config › Filtre IP (voir Réseau : ports & redirection).
• Trackers : une ligne Announced as / Next announce avec le peer id annoncé par ce moteur, puis le tableau Tracker / Statut (Status) / Last / Suivant (Next) / Scrape et le bouton Edit trackers. L'éditeur prend une URL par ligne, une ligne vide commençant un nouveau palier (tier). Voir Trackers & annonces.

Sur le panneau hoard, un torrent dont les données ne peuvent pas être lues affiche l'encadré This torrent cannot read its data avec le conseil de restaurer les fichiers puis de lancer une revérification.

Tout ce qui suit est stocké dans ce navigateur uniquement (localStorage) : un autre navigateur, ou une autre personne utilisant la même instance, garde ses propres réglages. Rien ne demande de redémarrage.

Le bouton Revenir aux valeurs par défaut (Reset to defaults) de la carte Personnalisation ne réinitialise que le thème et les onglets masqués. Ce n'est pas le Revenir aux valeurs par défaut des Paramètres avancés, qui réécrit default.toml et redémarre. Les boutons de redémarrage de l'interface (Redémarrer maintenant (Restart now), Appliquer et redémarrer (Apply & restart), Enregistrer et redémarrer (Save and restart), Réinitialiser et redémarrer (Reset and restart)) arrêtent le démon comme le fait SIGTERM (drain, état de reprise écrit), puis quittent avec le code 75, si bien que la politique de redémarrage de Docker ou une unité Restart=on-failure le relance ; sous Windows, le processus lance lui-même son successeur. Lancé à la main sous Linux sans superviseur, il reste arrêté (voir Exploiter Hydranos).

Seul le français est traduit de façon substantielle. Les cinq autres langues couvrent quelques écrans (premier démarrage, certains noms d'onglets) et retombent sur l'anglais partout ailleurs ; même en français, des parties de l'interface restent en anglais (les noms des onglets Nodes, Workflows et RSS, des puces d'état hoard, le titre Interface per engine, le bouton Remove d'un nœud, de nombreux boutons).

• Premier démarrage : l'écran Bienvenue dans Hydranos (Welcome to Hydranos) demande une langue, un nom d'utilisateur (prérempli avec admin) et un mot de passe d'au moins 8 caractères, puis Créer le compte (Create account). Détails et restriction au réseau local : Installation & premier démarrage et Sécurité & accès.
• Démarrage : pendant que le démon restaure son état, la page affiche un écran de démarrage avec la phase (Restauration de l'état… (Restoring state…), Connexion au réseau… (Connecting to the network…), Ouverture de la base… (Opening the database…), Démarrage… (Starting…)) et un compteur {restored} / {total} torrents ; il cède la place à l'interface de lui-même.
• Ensuite : la boîte de dialogue Hydranos login (Sign in). Elle échange votre nom d'utilisateur et votre mot de passe contre la clé API de l'instance, que le navigateur garde dans localStorage (hydra_api_key) et envoie avec chaque requête. La même clé ouvre l'API REST, le shim qBittorrent et le serveur MCP.
• Si une requête répond 401 (par exemple après un changement de clé), la boîte de connexion revient avec Session invalide, se reconnecter. (Session invalid, please sign in again.).
• Open sur l'onglet Nodes vous connecte à un autre nœud en passant sa clé dans le fragment de l'adresse (#key=…) ; la page la stocke et la retire de la barre d'adresse.
• Se déconnecter (Sign out ; l'icône tout à droite de l'en-tête) oublie la clé dans ce navigateur et clôt son cookie de session du shim qBittorrent, s'il en a un (POST /api/v2/auth/logout). La clé reste valide pour tous les autres navigateurs et clients. Pour les couper tous, changez [daemon] api_key : dès que la nouvelle clé est en vigueur, chaque navigateur qui détient encore l'ancienne revoit la boîte de connexion. Voir Sécurité & accès.
• La clé API n'est affichée qu'à un seul endroit : Config › Paramètres avancés (default.toml) › Général, ligne api_key (avec des boutons pour la générer et la copier).

En dessous de 768 pixels de large :

• l'en-tête ne garde que Envoi (Upload) et Téléchargement (Download) (plus l'œil incognito, le polygone réseau et Se déconnecter) ;
• les tableaux passent à un jeu réduit de colonnes, chaque cellule étiquetée : Race Nom (Name), Progression, Descendant, Montant ; Hoard Nom, État (State), Progression, Montant ; pairs IP, Progression, Descendant, Montant ;
• les facettes hoard se replient derrière un bouton ▸ Filtres (▸ Filters), qui affiche le nombre de filtres actifs, par exemple ▸ Filtres (2).

Tout le reste (onglets, menu contextuel, panneau de détail) est identique à la version bureau.

Les commandes qui étaient des ébauches en 4.3 (le Mode de l'onglet d'ajout, Changer le mot de passe (Change password), les modes VPN et proxy du sous-onglet Réseau, Test de débit ▶ Lancer maintenant, les filtres des Journaux et En direct, Annuler (Cancel) sur l'onglet Jobs) agissent toutes en 4.4, et la carte morte Étranglement (Choking), la boîte de dialogue Retirer le torrent (Remove Torrent) et le badge SEEDBOX ont disparu de la page. Ce qui reste partiel :

Bug connu en 4.4 : la page n'indique jamais si les pairs peuvent joindre un moteur. La couleur du panneau Réseau ne reflète que la sonde de sortie, et l'info-bulle de sa ligne renvoie à un point de santé qui n'est pas dessiné. Lisez plutôt GET /api/port-forward (engines[].reachable, inbound_peers).

• Les coches Téléchargement séquentiel / Première/dernière pièce d'abord ne sont pas lues pour plus de 50 torrents sélectionnés ni après Ctrl+A sur un filtre : elles s'affichent décochées et un clic active le réglage.
• Une Priorité de fichier ne peut pas valoir ne pas télécharger : chaque fichier d'un torrent est toujours téléchargé (volontairement).
• Annuler sur l'onglet Jobs abandonne un job en attente, arrête un déplacement vers un autre moteur après le fichier en cours (remis comme avant) et fait cesser l'attente d'un déplacement vers un nœud (les deux copies sont gardées) ; tout autre déplacement en cours ne peut pas être interrompu et se termine.
• L'onglet RSS, le Dry-run et le Lancer maintenant (Run now) de l'onglet Workflows (leur résultat affiché en JSON brut) et le bouton Bannir du tableau des pairs confirment et signalent encore leurs erreurs avec les boîtes de dialogue du navigateur, pas celles, stylées, de l'interface. Le Supprimer (Delete) de l'onglet Workflows et le Supprimer (Remove) d'un fichier de configuration WireGuard sur l'onglet Réseau confirment aussi avec la boîte du navigateur ; un Supprimer raté est signalé dans l'encadré de résultat stylé, un Supprimer de workflow raté n'est pas signalé du tout.

La liste complète est sur Limites connues de la 4.4.

La page interroge le serveur chaque seconde et ne rafraîchit que l'onglet actif. Le coût dépend de l'onglet :

Quel que soit l'onglet, les chiffres de l'en-tête se mettent à jour environ une fois par seconde, le polygone réseau toutes les 30 secondes, les badges Race/Trackers toutes les 30 secondes et l'IP de sortie toutes les 2 minutes. Le flux en direct saute les mises à jour tant que l'onglet du navigateur est masqué.

Avec un très gros moteur race, gardez l'onglet Race fermé quand vous n'en avez pas besoin : il télécharge la liste complète chaque seconde. L'onglet Hoard, lui, pagine sa liste côté serveur. Quitter un onglet suffit à arrêter ses interrogations. Les chiffres de dimensionnement pour les grosses bibliothèques sont sur Topologies de déploiement.

• Concepts & glossaire : les mots employés dans cette page.
• Ajouter des torrents & données existantes, Catégories & routage, Jobs, actions groupées & déplacement.
• Sécurité & accès : la clé API, la récupération du mot de passe, l'exposition de l'interface.
• RSS et téléchargements automatiques, File d'attente, limites de partage et de débit : l'onglet RSS et les boîtes de dialogue de limites en détail.
• Limites connues de la 4.4 : toutes les lacunes de la 4.4 au même endroit.