🇬🇧 English · 🇫🇷 Français

S'applique à Hydranos 4.4.

Cette page couvre tout ce qui n'est pas dans le fichier de configuration : les options de ligne de commande de hydranos et hydranos-update, chaque variable d'environnement que lit le code, et les signaux qui arrêtent proprement le démon. Elle s'adresse à vous si vous écrivez un fichier compose, une unité systemd ou un raccourci Windows. Pour le fichier TOML lui-même, commencez par Configuration : vue d'ensemble.

Aucune variable d'environnement ni option ne remplace une clé de configuration. Le seul moyen de changer un réglage comme un port ou un chemin est le fichier de configuration.

hydranos --help affiche l'usage exact :

usage: hydranos [--config <path/to/default.toml>] [--console]
       hydranos --version
       hydranos reset-password <password> [path/to/default.toml]
       hydranos hash-password <password>

Deux sous-commandes agissent sur le fichier de configuration sans démarrer le démon. Elles doivent être le premier argument :

Les deux refusent un mot de passe de moins de 8 caractères (hydranos: the password must be at least 8 characters). Le mot de passe est un argument de ligne de commande : il est visible des autres utilisateurs dans la liste des processus pendant que la commande tourne, et reste dans l'historique de votre shell. Procédures de récupération : Sécurité & accès.

Tout autre argument est signalé et sauté, et le démon démarre normalement. La ligne va sur stderr (la console, ou le journal du conteneur ; pas hydranos.log) :

hydranos: ignoring unknown argument "--foo"; starting anyway (see hydranos --help)

Les options de la séparation en processus de la 3.x (tout ce qui commence par --agent- ou --front-, aussi avec un seul tiret ou sous la forme --flag=value) reçoivent une ligne plus longue : ignoring <flag>: the agent/front split was removed in 4.x and Hydranos now runs as one process. Starting a normal instance. …, qui renvoie vers l'enrôlement de nœud. La valeur de --agent-addr, --agent-token, --agent-tls-cert, --agent-tls-key et --front-addr est sautée avec son option.

Un --config donné sans valeur affiche hydranos: --config needs a path; using <default path> et le chemin par défaut est utilisé.

hydranos --config /etc/hydranos/default.toml
hydranos --version
hydranos reset-password 'a-long-new-password' /etc/hydranos/default.toml

Sous Windows, hydranos.exe est un programme fenêtré : la sortie de --version, --help, reset-password et hash-password est écrite avant qu'il se rattache à une console, elle n'apparaît donc même pas dans un terminal (lu dans le code, non testé sous Windows). reset-password écrit quand même le fichier et règle le code de sortie ($LASTEXITCODE dans PowerShell) ; vérifiez plutôt la version dans l'en-tête de l'interface web. Les lignes d'argument inconnu et le journal apparaissent bien dans le terminal qui l'a lancé.

L'image Docker ne crée pas le fichier de la même façon : son entrypoint copie lui-même le modèle et règle data_dir sur le dossier de configuration (/config, pas /config/data). Voir Docker.

hydranos-update remplace les binaires par une version publiée sur github.com/Kheopsian/Hydranos. Il est livré dans le zip Windows et l'archive Linux, pas dans l'image Docker (mettez plutôt l'image à jour).

Les options inconnues sont ignorées. Comportement, d'après le code :

• Rien n'est remplacé à moins que l'archive soit téléchargée et que son SHA-256 corresponde au fichier .sha256 publié à côté.
• Seuls les binaires déjà présents dans --dir sont remplacés ; default.toml, le dossier de données et hydranos.log ne sont pas dans l'archive et ne sont jamais touchés.
• Si la version installée est déjà la dernière et qu'aucun --tag n'est donné, il s'arrête là.
• Windows : si hydranos.exe tourne, il déclenche l'événement d'arrêt du démon (Local\HydranosStop), qui donne le même arrêt propre que Quit Hydranos dans la zone de notification, et attend jusqu'à 60 s. Un démon antérieur à la 4.4 n'a pas cet événement : l'outil se rabat alors sur taskkill /IM hydranos.exe /T sans /F, qui ne l'arrête pas ; quittez donc d'abord depuis la zone de notification. S'il tourne encore au bout de 60 s (un très gros vidage), l'outil de mise à jour se termine par hydranos is still running after 60s -- stop it yourself, nothing was replaced. Une fois hydranos.exe arrêté, il remplace les fichiers. Voir Windows. Check for updates dans la zone de notification lance hydranos-update.exe --dir <its own folder> dans une fenêtre cmd.
• Linux : il n'arrête rien. Il remplace les fichiers et affiche note: restart the service for the new binaries to take effect.

# packaging/install.sh l'installe dans /opt/hydranos ; la config est dans /etc/hydranos, nommez-la donc
/opt/hydranos/hydranos-update --dir /opt/hydranos --config /etc/hydranos/default.toml --check
sudo /opt/hydranos/hydranos-update --dir /opt/hydranos --config /etc/hydranos/default.toml --yes && sudo systemctl restart hydranos

Les versions publiées ne livrent plus hydranos-engine (hydranos-engine.exe) : chaque moteur tourne dans le processus hydranos, et les seuls binaires des archives sont hydranos et hydranos-update. Une copie laissée dans /opt/hydranos par une installation plus ancienne n'est jamais lancée et peut être supprimée. Historique : Mettre à jour depuis la 3.x.

Elles sont lues par le démon lui-même, sur toutes les plateformes sauf mention contraire. Elles sont lues une seule fois, au démarrage (ou la première fois que le chemin de code s'exécute) : les changer demande un redémarrage.

Pour toutes les variables entières ci-dessus, une valeur qui ne s'analyse pas (ou qui vaut 0) est ignorée et la valeur par défaut s'applique. HYDRANOS_STOP_TIMEOUT suit ses propres règles (tableau ci-dessus).

Des variables de test HYDRANOS_INTEROP_* existent dans le source mais ne sont compilées que dans la suite de tests.

Le entrypoint.sh de l'image les lit avant de lancer hydranos. Elles n'ont aucun effet sur une installation bare metal ou Windows.

L'entrypoint relève aussi la limite de fichiers ouverts (ulimit -n 1000000, avec repli sur 200000, sauté sans message si ce n'est pas permis), et lance toujours hydranos avec --config "$HYDRANOS_CONFIG_DIR/default.toml".

Il refuse les variables 3.x HYDRANOS_ENGINE_ID et HYDRANOS_ENGINES : quand l'une d'elles n'est pas vide, il affiche sur stderr hydranos: ignoring <VAR>: the 3.x agent mode was removed in 4.x and Hydranos now runs as one process. Starting a normal instance on <config dir>/default.toml. … Remove <VAR> from the container's environment to silence this., puis crée la configuration et démarre comme d'habitude.

L'image elle-même définit une variable :

Le docker-compose.yml livré règle stop_grace_period: 150s et propose HYDRANOS_STOP_TIMEOUT: 120 en commentaire (voir Docker).

Le script d'enrôlement install.sh lit HYDRANOS_VERSION_PIN (un tag de version) dans tous ses chemins, tag de l'image Docker compris ; sans elle, le nœud prend la version du contrôleur dans son /health. C'est le script, pas le démon. Voir Nœuds & plusieurs machines.

Un raccourci ne peut pas définir de variable d'environnement. Sans --config, hydranos.exe utilise le default.toml placé à côté de lui : le --config ci-dessous n'est donc nécessaire que pour une configuration ailleurs. Définissez-la soit pour un seul démarrage dans PowerShell ($env:RUST_LOG = "debug"; & "C:\Hydranos\hydranos.exe" --config "C:\Hydranos\default.toml"), soit pour votre compte avec setx RUST_LOG debug ou Démarrer › tapez environment › Edit environment variables for your account (intitulé Windows ; en français « Modifier les variables d'environnement pour votre compte »). Un Hydranos en cours garde les anciennes valeurs : quittez depuis la zone de notification et relancez-le (déconnectez-vous puis reconnectez-vous si un raccourci du dossier Démarrage ne la voit toujours pas). Détails : Windows.

À savoir :

• Le gestionnaire SIGTERM/SIGINT est installé avec l'écoute HTTP, dans la première seconde du démarrage, avant le chargement des torrents. Un arrêt qui arrive pendant le chargement est entendu : le chargement se termine, rien de plus ne démarre, et les départs et le vidage ont lieu (stop requested during startup; flushing and leaving).
• Le pire cas est d'environ 5 s (vidange) + 5 s (départs) + HYDRANOS_STOP_TIMEOUT, soit 130 s par défaut. Laissez plus que cela à votre superviseur (stop_grace_period / docker stop -t, systemd TimeoutStopSec ; les fichiers livrés utilisent 150 s) : le dimensionnement est sur Exploiter Hydranos.
• Redémarrer depuis l'interface web ou l'API (Appliquer et redémarrer (Apply & restart), POST /api/settings/restart) n'est pas un signal mais prend le même chemin (journalisé restart request received, …), puis quitte avec le code 75 (EX_TEMPFAIL) au lieu de 0, pour que Restart=on-failure, restart: unless-stopped ou toute politique qui redémarre sur échec relance Hydranos. Un processus lancé à la main reste arrêté. Voir Exploiter Hydranos.
• Toutes les 300 s (Linux uniquement), le démon journalise aussi une ligne jemalloc allocated=… resident=….

Windows n'a pas de signaux. Chacun de ces déclencheurs produit le même arrêt propre que SIGTERM (vidange, départs, vidage borné), journalisé sous la forme <trigger>: draining the API and flushing resume data :

• Quit Hydranos dans le menu de l'icône de la zone de notification (tray quit) ;
• Ctrl+C ou Ctrl+Break dans la console à laquelle le processus est rattaché (lancé depuis un terminal, ou avec --console) ;
• la fermeture de cette fenêtre de console (console closed), la déconnexion (sign-out), l'arrêt de Windows (system shutdown) ;
• hydranos-update, via l'événement d'arrêt (une ligne d'information stop requested by the updater, puis la vidange journalisée comme tray quit: …) ; l'événement, comme l'icône de la zone de notification, existe une fois les torrents chargés.

Windows ne laisse que quelques secondes après une fermeture de console, une déconnexion ou un arrêt du système, donc le vidage peut y être écourté : quittez depuis la zone de notification avant d'éteindre. La façon dont ces événements de console atteignent un hydranos.exe fenêtré lancé sans console n'a pas été testée. taskkill /F et Fin de tâche (End task) dans le Gestionnaire des tâches ne lancent jamais le vidage ; taskkill sans /F ne fait rien. Un redémarrage depuis l'interface web enregistre de la même façon, puis hydranos.exe lance lui-même son successeur (mêmes arguments) et quitte avec le code 75. SIGUSR1/SIGUSR2 et la ligne de statistiques mémoire n'existent pas sous Windows (pas de jemalloc). Lanceurs de service et options de démarrage : Windows.

• Configuration : vue d'ensemble — le fichier de configuration et où chaque section est documentée
• Exploiter Hydranos — arrêt, redémarrage, sauvegarde, mises à jour
• Supervision & journaux — hydranos.log, l'onglet Journaux, /health, /metrics
• VPN & sortie réseau — TYPHON_ANNOUNCE_PROXY et ce qui sort par où
• Docker — le fichier compose et le volume /config