🇬🇧 English · 🇫🇷 Français

S'applique à Hydranos 4.4.

Hydranos est un client BitTorrent conçu pour garder en seed une très grande bibliothèque. Un seul programme (hydranos) fait tourner d'emblée deux moteurs : race pour les torrents qui ne font que passer (faire la course sur les nouvelles sorties, puis les laisser partir), et hoard pour les torrents que vous gardez (dans le doute, classez vos catégories en Hoard). Vous le pilotez depuis une interface web, une API REST native, une API compatible qBittorrent (Sonarr, Radarr, autobrr et cross-seed continuent donc de fonctionner) et un point d'accès MCP pour les clients IA. Les quatre répondent sur un seul port (8199 par défaut) et acceptent la même clé API. Hydranos peut aussi suivre le flux RSS d'un tracker, mettre en file et limiter les torrents par moteur, et placer chaque moteur derrière son propre tunnel VPN. Le vocabulaire est expliqué dans Concepts & glossaire. Cette page vous oriente vers la bonne page.

Nouvelle installation, étape par étape :

flowchart TD
    A{"Hydranos 3.x aujourd'hui ?"} -- oui --> U["Mettre à jour depuis la 3.x"]
    A -- non --> P{"Quelle plateforme ?"}
    P -- "Docker, NAS, Unraid" --> D["Installer avec Docker"]
    P -- "Linux avec systemd" --> L["Installer sous Linux (bare metal)"]
    P -- Windows --> W["Installer sous Windows"]
    D --> F["Installation et premier démarrage<br/>compte admin, première catégorie"]
    L --> F
    W --> F
    F --> Q{"Remplacer qBittorrent<br/>derrière Sonarr ou Radarr ?"}
    Q -- oui --> M["Migrer depuis qBittorrent"]
    Q -- non --> C["Catégories et routage"]
    M --> V{"VPN devant ?"}
    C --> V
    V -- oui --> E["VPN et sortie réseau"]
    V -- non --> K["Limites connues de la 4.4"]
    E --> K

Pour qui vient de la 4.3. Ce qui change pour une installation existante (clés désormais lues, nouvelles valeurs par défaut, code de sortie au redémarrage) est sur Mettre à jour de la 4.3 vers la 4.4 ; l'historique complet est dans le journal des modifications (Liens du projet).

• RSS : flux, dossiers et règles de téléchargement dans un nouvel onglet RSS, aussi par l'API qBittorrent (rss/*). Voir RSS et téléchargements automatiques.
• File d'attente, limites de partage et de débit : plafonds de téléchargements et de seeds par moteur, limites de ratio et de temps de seed (arrêter ou supprimer), plafonds d'envoi et de réception par torrent, par moteur et pour tout le client, et un choker facultatif. Voir File d'attente, limites de partage et de débit.
• Ordre de téléchargement : priorités de fichiers (normale, haute, maximale), téléchargement séquentiel et première et dernière pièces d'abord. Voir Ajouter des torrents & données existantes.
• Les cinq modes réseau sont réels : Direct, WireGuard géré, Gluetun, SOCKS5 et SOCKS5 + relais PROXY-v2, avec un kill switch, l'épinglage d'interface d'un moteur qui couvre chacune de ses sockets, et une sortie séparée pour les requêtes propres du démon. Voir VPN & sortie réseau et WireGuard géré.
• Le shim rapporte les vrais chiffres : Sonarr, Radarr et autobrr voient les vrais uploaded et ratio, donc leurs objectifs de seed agissent désormais. Voir Shim qBittorrent & automatisation.
• Commandes corrigées : les boutons de redémarrage de l'interface web arrêtent proprement, Changer le mot de passe (Change password) enregistre le mot de passe, hydranos reset-password existe, l'en-tête a Se déconnecter (Sign out), et les options Mode, sous-dossier (pas pour un magnet) et saut de la vérification de l'onglet d'ajout sont appliquées. Voir Exploiter Hydranos, Sécurité & accès, Ajouter des torrents & données existantes.

La barre latérale suit l'ordre de lecture d'un nouvel utilisateur.

• Démarrer : cette page, Concepts & glossaire, Visite de l'interface web.
• Installer : Installation & premier démarrage (ports, premier démarrage), Docker, Linux (bare metal), Windows, Migrer depuis qBittorrent, Mettre à jour depuis la 3.x.
• Utiliser : Catégories & routage, Ajouter des torrents & données existantes, RSS et téléchargements automatiques, File d'attente, limites de partage et de débit, Moteurs : race & hoard, Drain race & graduation, Trackers & annonces, Jobs, actions groupées & déplacement, Workflows.
• Intégrer : Shim qBittorrent & automatisation, API REST, Serveur MCP.
• Réseau et machines : Topologies de déploiement, Réseau : ports & redirection, VPN & sortie réseau, WireGuard géré, Nœuds & plusieurs machines.
• Exploiter : Exploiter Hydranos (arrêt, redémarrage, sauvegarde, mises à jour), Supervision & journaux, Métriques Prometheus, Sécurité & accès, Dépannage, Limites connues de la 4.4.
• Référence : Architecture, Configuration : vue d'ensemble, Config : démon, auth & global, Config : moteurs & drain race, Config : environnement, CLI & signaux.

Les manques sur lesquels vous risquez le plus de tomber. Chacun est expliqué sur la page liée ; la liste complète est sur Limites connues de la 4.4.

• Pas de recherche, pas de téléchargement sélectif (chaque fichier est toujours téléchargé : la priorité 0 est refusée), pas de limites de débit alternatives ni planifiées, un seul utilisateur. Voir Migrer depuis qBittorrent et File d'attente, limites de partage et de débit.
• Forcer le téléchargement (Force download) ne fait que marquer un torrent : la file de téléchargement ne lit pas cette marque, donc un torrent forcé attend un emplacement comme les autres, et il n'y a pas de positions dans la file. Le Force Start de Sonarr ou de Radarr répond 409 sur un moteur qui a un plafond de téléchargements (hoard, avec le modèle). Voir File d'attente, limites de partage et de débit.
• Déplacer vers un dossier… (Set location…), un changement de catégorie de même mode et l'action de workflow move files to a folder réajoutent le torrent en mode seed : un torrent inachevé est alors traité comme complet, les modifications de trackers sont perdues et les compteurs d'octets repartent de 0. Ne déplacez que des torrents complets. Voir Jobs, actions groupées & déplacement.
• Enregistrer une règle RSS depuis le formulaire web efface les tags qu'elle avait reçus par l'API ou par un client qBittorrent, et le formulaire n'a pas de champ de priorité ni de tags. Voir RSS et téléchargements automatiques.
• L'interface web n'indique jamais si les pairs peuvent joindre un moteur ; lisez GET /api/port-forward. Voir Réseau : ports & redirection.
• Les routes de l'onglet Réseau renvoient en clair les mots de passe SOCKS5 et la clé API de gluetun à quiconque détient la clé API. Voir Sécurité & accès.

• Dépôt : github.com/Kheopsian/Hydranos
• Versions publiées : github.com/Kheopsian/Hydranos/releases
• Journal des modifications : CHANGELOG.md
• Conformité BitTorrent (ce que le client envoie aux trackers, avec les tests qui le vérifient) : docs/BITTORRENT-CONFORMANCE.md
• Licence : GNU Affero General Public License v3.0 (AGPL-3.0)