Concepts FR

🇬🇧 English · 🇫🇷 Français

Concepts

Trois idées expliquent presque tout dans Hydra. Lis ça avant d'installer : c'est ce qui te permet de choisir le montage qui te convient au lieu de recopier celui d'un autre.

1. Un cerveau, un ou plusieurs muscles (front vs agent)

Hydra se divise en un plan de contrôle (« front ») et un plan de données (« agent ») :

• Le front sert l'interface web et les API, route les torrents et agrège les résultats. Il ne parle jamais aux peers.
• Un agent fait tourner le(s) moteur(s) torrent : il se connecte aux peers, s'annonce aux trackers avec sa propre IP / sortie réseau, et détient la persistance.

Par défaut les deux vivent dans un seul processus (le « monolithe ») et tu n'y penses jamais. Mais comme ils sont séparés, tu peux placer des agents sur d'autres machines ou derrière des VPN différents et laisser un seul front tous les agréger. C'est toute la base des Topologies de déploiement.

2. Deux rôles de moteur : hoard vs race

Un moteur = un processus Typhon (Rust). Hydra en lance deux par défaut — le même cœur réglé pour des tâches opposées :

	hoard	race
Rôle	seed longue durée d'une grosse biblio	choper vite les nouveautés chaudes
Optimisé pour	upload pas cher à l'échelle (100k+ torrents)	faible latence, download agressif
Stockage	gros et lent (HDD / grappe)	petit et rapide (NVMe)
Durée de vie	garde les torrents des mois	éphémère, tourne vite

Ce sont des processus séparés — ports, resume et stockage durable distincts — donc l'un ne peut pas bloquer l'autre. Certaines opérations (recheck / vérification, changement de catégorie par torrent) sont hoard uniquement par conception ; race est un chemin de download léger qui les omet volontairement. Tu peux ajouter d'autres moteurs et sharder.

Ce qui envoie un torrent sur un moteur ou l'autre = sa catégorie (Catégories & routage). La catégorie décide du moteur et du save-path. Via le shim qBit, une catégorie inconnue tombe sur race par défaut.

3. Comment lui parler

• API native /api/* (avec une clé API) — la vraie interface complète. À utiliser par défaut.
• Shim qBittorrent /api/v2/* — fait passer Hydra pour qBittorrent, pour que autobrr / Sonarr / Radarr / cross-seed marchent sans rien changer. C'est la surface d'intégration pour l'automatisation (Shim qBittorrent & automatisation).

Tout est dans un default.toml

La configuration tient dans un seul fichier TOML, et la plupart des clés sont aussi modifiables à chaud depuis l'onglet Config (Référence de configuration). Aucun état caché.

---

Et ensuite

Le modèle est clair, choisis maintenant ton installation et façonne-la à ton cas — Docker, bare-metal ou Windows, plus le réseau / VPN / topologie qui correspond à ta situation. Commence par Installation & premier démarrage.

Pour le câblage sous le capot (processus, sockets, persistance), voir Architecture.