🇬🇧 English · 🇫🇷 Français

S'applique à Hydranos 4.4.

Cette page est la référence clé par clé de toutes les parties de default.toml qui ne concernent pas un moteur : les clés de premier niveau, [daemon], [proxy], [network], [auth], [mcp], [dedup], [rss], [vpn_speedtest], [bench], les cinq tables par hôte de tracker, et les sections et clés qu'Hydranos signale au démarrage comme ignorées. Pour chaque clé, vous trouvez son type, la valeur qu'écrit le modèle livré, la valeur qu'utilise le code quand la clé est absente, si la 4.4 la lit vraiment, et quand une modification prend effet. Les clés des moteurs ([race], [hoard], blocs de moteur, [race_drain]) sont sur Config : moteurs & drain race. Comment le fichier est trouvé, créé et modifié est expliqué sur Configuration : vue d'ensemble. Les termes comme store, état de reprise et moteur sont définis sur Concepts & glossaire.

Trois règles valent pour toutes les sections de cette page :

• L'éditeur générique de Paramètres avancés (default.toml) ne change que les clés déjà présentes dans le fichier. Une clé que le modèle ne contient pas (marquée « — ») doit être ajoutée à la main, démon arrêté ou suivi d'un redémarrage. Voir Configuration : vue d'ensemble.
• Après tout enregistrement dans Paramètres avancés, l'interface affiche « Réglages daemon/auth modifiés, un redémarrage complet est nécessaire. » (« Daemon/auth settings changed, a full restart is required. ») pour chaque section de cette page, même quand le code lit la clé à chaud. La colonne Prise d'effet ci-dessous indique ce que fait le code.
• L'éditeur masque, dans [race]/[hoard] seulement, les clés que possède l'onglet Réseau (Network), ainsi que toute clé signalée au démarrage comme ignorée. [daemon] bind_interface, kill_switch, egress et les clés de [proxy] ne sont pas masquées : une fois que l'onglet Réseau les a écrites, elles apparaissent sous Général et Other, et peuvent y être modifiées une par une. Il masque aussi trois clés de [vpn_speedtest] que la 4.4 lit ; voir cette section.

Bug connu en 4.4 : la liste des clés de l'onglet Réseau dans l'éditeur inclut [daemon] kill_switch, egress et les clés de [proxy], censées être masquées, mais le filtre ne s'applique qu'à [race]/[hoard]. Changez-les sur l'onglet Réseau, qui les écrit d'un bloc.

Une clé de premier niveau doit se trouver avant le premier en-tête [table]. Écrite en fin de fichier, elle atterrit dans la dernière table et est ignorée sans message.

Détails, mises en garde Docker et lignes de journal : Réseau : ports & redirection.

# Premières lignes de default.toml, avant [daemon]
auto_port_forward = false   # le port est redirigé à la main sur le routeur

[daemon]
api_port = 8199

Où create_torrent_folder ne s'applique pas (magnets ajoutés en natif, dossiers surveillés, ajouts MCP, assistant d'import) : voir Téléchargement, revérification ou mode seed.

bind_interface, kill_switch et egress sont écrites d'un bloc par l'onglet Réseau (Enregistrer le trafic du démon (Save daemon traffic)) avec [proxy]. Une fois écrites, elles apparaissent aussi dans Paramètres avancés › Général (l'éditeur ne masque que les clés de l'onglet Réseau de [race]/[hoard]). Ce que donne chaque valeur d'egress, les verdicts du kill switch par moteur et les lignes de journal : VPN & sortie réseau (Le kill switch, Les requêtes propres au démon).

agent_token n'est plus une clé : le modèle 4.4 ne la contient pas, et un fichier qui l'a encore reçoit config: daemon.agent_token is ignored: … au démarrage (voir Sections et clés signalées au démarrage). Revenir aux valeurs par défaut (Reset to defaults) la supprime. Le contexte 3.x est sur Mettre à jour depuis la 3.x.

Remarques :

• Changer api_key depuis l'interface prend effet à la requête suivante. L'interface enregistre la nouvelle clé dans ce navigateur, mais tous les autres clients (Sonarr, Radarr, autobrr, scripts, clients MCP, nœuds déclarés qui pointent vers cette instance) doivent être mis à jour à la main.
• N'enregistrez pas une api_key vide depuis l'interface. Une clé vide refuse tous les appels API jusqu'au démarrage suivant, qui en génère alors une nouvelle. Le navigateur qui l'a enregistrée est bloqué lui aussi.
• api_host avec une adresse IPv6 : le serveur écoute sur <api_host>:<api_port> tel qu'écrit, une adresse IPv6 littérale a donc besoin de crochets : "[::]".
• Le mode de secours (le store ne peut pas être ouvert) répond sur le même api_host:api_port que le serveur normal. Voir Exploiter Hydranos.
• Le data_dir = "/config" du modèle correspond à l'organisation Docker. Pour la différence entre la création du fichier au premier lancement sous Docker et en binaire, voir Configuration : vue d'ensemble.

[daemon]
api_host = "0.0.0.0"
api_port = 8199
api_key = ""                    # vide : une clé est générée et écrite ici au premier démarrage
data_dir = "/config"
update_check_disabled = true    # absente du modèle : à ajouter à la main
# egress = "auto"              # commentée dans le modèle ; réglée depuis l'onglet Réseau

Le proxy SOCKS5 des requêtes propres du démon, utilisé quand [daemon] egress = "proxy". Le proxy des moteurs est un autre jeu de clés (socks5_outbound_* dans [race]/[hoard], voir Config : moteurs & drain race). En 3.x, cette section portait la recherche d'IP publique et le test de débit ; la 4.4 la relit pour les requêtes du démon.

Une fois la section créée, les quatre clés apparaissent sous Paramètres avancés › Other, toujours avec leur description 3.x (« used by the orchestrator (public IP + speedtest) »). Changez-les sur l'onglet Réseau. Détails : VPN & sortie réseau.

[daemon]
egress = "proxy"

[proxy]
socks5_host = "198.51.100.20"
socks5_port = 1080

L'onglet l'écrit ; la modifier seule (elle apparaît sous Paramètres avancés › Other une fois la table créée) peut laisser en place les clés de moteur d'un autre mode. Ce qu'écrit chaque mode : Réseau : ports & redirection et WireGuard géré.

• Le shim qBittorrent (/api/v2/auth/login) accepte soit ce nom d'utilisateur et ce mot de passe, soit n'importe quel nom d'utilisateur avec la clé API comme mot de passe.
• password_hash doit être un hash bcrypt. Saisir un mot de passe en clair dans ce champ fait échouer toutes les connexions (la clé API continue de fonctionner). hydranos hash-password <password> en affiche un (8 caractères minimum) ; le commentaire du modèle l'appelle encore hydra hash-password.
• Config › Compte (Account) › Changer le mot de passe (Change password) (POST /api/auth/password) écrit aussitôt un nouveau hash dans password_hash, 8 caractères minimum ; l'ancien mot de passe est refusé dès la connexion suivante et ce navigateur reste connecté (la clé API ne change pas).
• hydranos reset-password <password> [path/to/default.toml] écrit le hash dans le fichier depuis la ligne de commande, pour un admin bloqué dehors ; redémarrez Hydranos pour qu'il s'applique.
• Il n'y a qu'un compte. La récupération d'un mot de passe perdu et les règles d'exposition au premier lancement sont sur Sécurité & accès, qui en est la référence.

[auth]
username = "admin"
password_hash = ""   # vide = l'écran du premier lancement demande un mot de passe

La table n'est pas dans le modèle : ajoutez-la à la main. Tout le reste concernant ce point d'accès est sur Serveur MCP.

[mcp]
allow_destructive = false

• Table absente = activé. Pour le désactiver, utilisez la carte Duplicate data (elle crée la table, POST /api/dedup/config) ou ajoutez la table à la main. L'éditeur générique ne peut pas la créer.
• Enregistrer et redémarrer sur la carte écrit le fichier puis redémarre le processus par le chemin de redémarrage de l'interface (le même arrêt propre que SIGTERM ; voir Exploiter Hydranos). Le code lit la nouvelle valeur au prochain ajout : modifier la table à la main puis redémarrer revient au même.
• path_collision doit être ajoutée à la main. Ce qui compte comme collision, les événements journalisés et la revérification protégée : Fichiers qu'un autre torrent détient déjà.
• Ce qui compte comme « la même charge utile » et l'interaction avec le mode seed : Ajouter des torrents & données existantes.

[dedup]
enabled = false   # toujours télécharger, ne jamais créer de liens physiques vers une charge utile déjà présente
path_collision = "refuse"   # absente du modèle : à ajouter à la main

La section n'est pas dans le modèle : ajoutez-la à la main. Les flux et les règles eux-mêmes vivent dans le store, pas ici. Tout le reste : RSS & téléchargements automatiques.

[rss]
enabled = true
refresh_minutes = 30
max_articles = 200

Le test de ligne iperf3 de l'onglet Performances (Benchmark) (▶ Lancer maintenant (▶ Run now), POST /api/vpn-speedtest/run), et sa planification optionnelle.

« À chaud » vaut pour une modification via l'éditeur de l'interface ; les clés sont relues à chaque exécution. Une modification du fichier à la main est lue au démarrage suivant, ou dès qu'un enregistrement via l'interface web ou l'API réécrit le fichier (ce qui recharge tout le fichier) — le seul moyen de changer les trois clés masquées sans redémarrer.

Bug connu en 4.4 : Paramètres avancés semble lister toutes les clés de [vpn_speedtest] — iperf3_port, duration_secs et interval_secs y sont masquées alors que la 4.4 les lit — modifiez default.toml à la main et redémarrez.

Mise à jour : un fichier créé à partir du modèle 4.3 (ou repris de la 3.x) contient enabled = true, iperf3_server = "ping.online.net" et interval_secs = 3600. La 4.3 ignorait cette dernière clé ; la 4.4 la lit, donc un tel fichier sature la ligne avec un test toutes les heures après la mise à jour. Mettez interval_secs = 0 à la main (ou décochez enabled dans Paramètres avancés › Maintenance, ce qui coupe aussi Lancer maintenant).

Ce que mesure le test et comment il est affiché : Supervision & journaux (Test de débit (test de ligne)).

[vpn_speedtest]
enabled = true
iperf3_server = "ping.online.net"
interval_secs = 0     # un fichier 4.3 peut indiquer 3600 : un test saturant par heure en 4.4

Toute la section est Ignorée, signalée : aucune de ses clés n'apparaît dans le code, le modèle 4.4 ne la contient plus, et Paramètres avancés la masque. L'enregistrement des mesures ne peut pas être désactivé et son échantillonnage est fixe (voir Supervision & journaux). Un fichier qui contient encore la section reçoit, à chaque démarrage :

config: [bench] is ignored: bench recording and its retention are built in; none of these keys is read. Instead: nothing; delete the section.

Les clés qu'un fichier 4.3 peut contenir : enabled, retention_days, race_snapshot_retention_days, snapshot_interval_secs, prune_interval_mins, vacuum. Supprimez la section.

Cinq tables associent un hôte de tracker à une valeur. Ce sont toutes les cinq des tables host = "value" de chaînes : mettez toujours la valeur entre guillemets. Un nombre nu ("tracker.example.org" = 48) est une erreur de type, et une erreur de type dans le fichier arrête Hydranos au démarrage. Mettez aussi l'hôte entre guillemets quand il contient des points.

L'onglet Trackers écrit les cinq via des routes dédiées ; c'est la méthode recommandée. Son formulaire et ses boutons sont décrits sur Trackers & annonces, qui fait référence pour leur comportement.

Aucune de ces tables n'est dans le modèle ; les routes les créent.

• Les passkeys et modes IP modifiés à la main dans le fichier ne sont pas poussés aux annonceurs en cours : ils s'appliquent au démarrage suivant. Tout enregistrement ultérieur via une route de passkey ou de mode IP pousse la table complète actuelle.
• Paramètres avancés peut changer la valeur d'un hôte déjà présent dans l'une des cinq tables (une clé d'hôte entre guillemets est reconnue par son nom nu). Il ne peut ni ajouter ni retirer un hôte : utilisez pour cela l'onglet Trackers. Une passkey ou un mode IP enregistré là est écrit et relu mais pas poussé aux annonceurs en cours : il s'applique au redémarrage suivant (le bandeau d'enregistrement en demande un) ou au prochain enregistrement via une route de passkey ou de mode IP. Les valeurs muettes, masquées et de seed minimum enregistrées là s'appliquent aussitôt.
• La forme groupée de la route de masquage ("hosts" avec plus d'un hôte) saute les hôtes qui ont une passkey ou un mode IP, et les liste dans skipped_configured.
• Sémantique de l'obligation de seed (quels torrents le drain peut supprimer, et quand) : Drain race & graduation.
• Un moteur avec enable_ipv6 = false annonce en IPv4 seulement, quoi que dise le mode IP : voir Trackers & annonces.
• Le commentaire du modèle dit que les passkeys sont reconnues par « sous-chaîne d'hôte » et poussées à toute la flotte, vers les autres machines. Les deux sont périmés : la correspondance suit le tableau ci-dessus, et les tables ne s'appliquent qu'aux moteurs de cette instance.

[announce_passkeys]
"tracker.example.org" = "0123456789abcdef"

[announce_ip_modes]
"tracker.example.org" = "v4"

[announce_min_seed_hours]
"tracker.example.org" = "72"     # une chaîne, pas un nombre nu
"public.example.org" = "0"       # aucune obligation : le drain peut supprimer

[announce_muted]
"dead.example.org" = "1"

[announce_hidden]
"old.example.org" = "1"

Ancienne table [announce_clients]. L'identité client par tracker a été supprimée. Si un fichier contient encore des tables [announce_clients], le premier démarrage de la 4.3 ou d'une version ultérieure arrête une fois les torrents dont le premier tracker y correspond, et retire les tables du fichier. Voir Mettre à jour depuis la 3.x.

Config › Paramètres avancés (default.toml) › Revenir aux valeurs par défaut (Reset to defaults) (en haut à droite de l'éditeur) › Réinitialiser et redémarrer (Reset and restart) (POST /api/settings/reset) enregistre le fichier actuel sous <config file>.bak-reset-<unix seconds>, réécrit le modèle livré, et ne garde que quatre valeurs, quand ce sont des chaînes non vides : [auth] username, [auth] password_hash, [daemon] api_key et [daemon] data_dir. Ensuite l'interface redémarre le démon.

Tout le reste de cette page revient au modèle ou à sa valeur « Si absente », en particulier :

• [network] mode, [daemon] kill_switch, egress, bind_interface et [proxy] (ainsi que les clés allow_direct et wireguard_* des moteurs) : une installation qui tournait en mode WireGuard, SOCKS5, PROXY-v2 ou Gluetun revient en mode Direct avec le kill switch désarmé, si bien que ses moteurs sortent par la route par défaut de l'hôte après le redémarrage. Les requêtes propres du démon passent sur la route par défaut dès que le fichier est écrit, avant le redémarrage ;
• les cinq tables par hôte de tracker (passkeys, modes IP, heures de seed minimum, muets, masqués) ;
• [mcp], [dedup] (de nouveau activé, isolate), [rss], auto_port_forward, update_check_disabled, create_torrent_folder, et chaque bloc de moteur ;
• [vpn_speedtest] (de nouveau enabled = true, ping.online.net, sans planification).

Recopiez ce dont vous avez besoin depuis la sauvegarde avant que les moteurs ne rencontrent un tracker ; le texte de la boîte de dialogue (« Tous les réglages reviennent à ceux d'une installation neuve : ports, mode réseau, passkeys de trackers, masquages de client, réglages des moteurs. » (Every setting goes back to what a fresh install ships: ports, network mode, tracker passkeys, client spoofs, engine tuning.)) ne mentionne pas le kill switch. Plus : Configuration : vue d'ensemble et Exploiter Hydranos.

Certaines clés et sections de fichiers plus anciens sont acceptées et ne font rien. À chaque démarrage, Hydranos lit le fichier brut et journalise une ligne WARN par clé de ce genre présente, sous cette forme :

config: <where> is ignored: <why>. Instead: <what to use>.

L'avertissement n'est jamais fatal ; un fichier qui ne s'analyse pas reçoit son erreur d'analyse à la place. Aucune de ces clés n'est dans le modèle 4.4, et Paramètres avancés les masque toutes. La liste complète (deadkeys.rs) :

Un bloc est désigné par son name (ou engine_id), sinon par sa position :

config: [[engine]] "vpn7" token is ignored: …
config: [[engine]] #2 session.file_pool_size is ignored: …

Les champs de catégorie 3.x placement, agents, strategy et min_free_bytes (stockés avec les catégories, pas dans ce fichier) reçoivent une ligne semblable par champ une fois le store ouvert, qui liste les catégories qui les définissent ; ils sont conservés pour un retour en arrière vers la 3.x. Contexte de mise à jour : Mettre à jour depuis la 3.x.

[proxy] et [vpn_speedtest] ne sont pas dans cette liste : la 4.4 les lit (voir plus haut).

Toute autre clé ou section inconnue est toujours acceptée sans message : une faute de frappe dans un nom de clé (enable_dth) ne produit ni avertissement ni effet. Deux clés de moteur de la famille du modèle sont aussi silencieuses et inertes, inactivity_timeout et announce_rate_limit ; voir Config : moteurs & drain race. La liste générale des clés qui ne font rien est sur Configuration : vue d'ensemble.

• Configuration : vue d'ensemble : où se trouve le fichier, comment il est créé et modifié, règles de redémarrage, clés qui ne font rien.
• Config : moteurs & drain race : [race], [hoard], blocs de moteur, [race_drain].
• Config : environnement, CLI & signaux : tout ce qui est hors du TOML.
• Sécurité & accès · Serveur MCP · Trackers & annonces · Drain race & graduation · Réseau : ports & redirection · VPN & sortie réseau · RSS & téléchargements automatiques · File d'attente, limites de partage et de débit · Limites connues de la 4.4