Admin : Documentation de la mise en œuvre ngrok sur tas

2026-08-21T22:28:31Z

Documentation de la mise en œuvre ngrok sur tas

Nouvelle page

= Trace install tas - ngrok =


== Rôle et état ==

ngrok fournit un tunnel HTTPS public vers un service HTTP local de <code>tas</code>. L'instance documentée expose temporairement le point d'entrée Caddy local du tunnel, sur le port <code>8099</code>, vers un domaine fixe ngrok.

État vérifié le 22 août 2026 :

* binaire : <code>/usr/local/bin/ngrok</code> ;
* version : <code>3.39.11</code> ;
* domaine fixe : <code>https://noella-oxidizable-nonsuppositively.ngrok-free.dev</code> ;
* cible locale ngrok : <code>8099</code> ;
* service systemd utilisateur : <code>ngrok-8080.service</code> ;
* service : actif et activé au démarrage de la session utilisateur.

Le nom historique <code>ngrok-8080.service</code> est conservé, mais la cible actuelle est le port <code>8099</code>, et non le port <code>8080</code>.


== Mise en œuvre ==

ngrok n'est pas exécuté dans un conteneur. Le binaire est installé sur l'hôte et lancé sous le compte utilisateur <code>loic</code> par systemd utilisateur.

La commande exécutée par le service est :

<syntaxhighlight lang="bash">/usr/local/bin/ngrok http --url=https://noella-oxidizable-nonsuppositively.ngrok-free.dev 8099 --config /home/loic/.config/ngrok/ngrok.yml</syntaxhighlight>
L'installation initiale du paquet a utilisé le dépôt officiel ngrok :

<syntaxhighlight lang="bash">curl -sSL https://ngrok-agent.s3.amazonaws.com/ngrok.asc | sudo tee /etc/apt/trusted.gpg.d/ngrok.asc >/dev/null
echo "deb https://ngrok-agent.s3.amazonaws.com bookworm main" | sudo tee /etc/apt/sources.list.d/ngrok.list
sudo apt update
sudo apt install ngrok</syntaxhighlight>
Le jeton d'authentification n'est pas documenté ici. Il est conservé dans le fichier protégé <code>/home/loic/.config/ngrok/ngrok.yml</code>, dont les permissions attendues sont <code>0600</code> et le propriétaire <code>loic</code>.


== Routage local ==

Le tunnel ngrok vise Caddy, pas directement l'application finale :

<syntaxhighlight lang="text">Internet → domaine ngrok fixe → ngrok → 127.0.0.1:8099 → Caddy → 127.0.0.1:8085</syntaxhighlight>
Le bloc Caddy correspondant est dans <code>/etc/caddy/Caddyfile</code> :

<pre class="caddyfile">:8099 {
reverse_proxy 127.0.0.1:8085
}</pre>
Cette chaîne permet notamment de conserver le tunnel lorsque le service Open WebUI change de port interne, sous réserve d'adapter le backend Caddy.


== Mode d'automatisation ==

L'automatisation repose exclusivement sur l'unité systemd utilisateur :

<code>/home/loic/.config/systemd/user/ngrok-8080.service</code>

Caractéristiques :

* <code>After=network-online.target</code> et <code>Wants=network-online.target</code> ;
* <code>Type=simple</code> ;
* <code>Restart=always</code> ;
* <code>RestartSec=5</code> ;
* <code>WantedBy=default.target</code>.

Il n'y a pas de cron, de timer systemd, de Quadlet ni de conteneur ngrok pour ce tunnel.


== Démarrage ==

Démarrer le tunnel :

<syntaxhighlight lang="bash">systemctl --user start ngrok-8080.service</syntaxhighlight>
Activer le démarrage automatique :

<syntaxhighlight lang="bash">systemctl --user enable ngrok-8080.service</syntaxhighlight>
Après modification de l'unité :

<syntaxhighlight lang="bash">systemctl --user daemon-reload
systemctl --user restart ngrok-8080.service</syntaxhighlight>

== Arrêt et redémarrage ==

Arrêter le tunnel sans supprimer la configuration :

<syntaxhighlight lang="bash">systemctl --user stop ngrok-8080.service</syntaxhighlight>
Empêcher son redémarrage à la prochaine session utilisateur :

<syntaxhighlight lang="bash">systemctl --user disable ngrok-8080.service</syntaxhighlight>
Redémarrer le tunnel :

<syntaxhighlight lang="bash">systemctl --user restart ngrok-8080.service</syntaxhighlight>
Ces opérations ne suppriment ni le binaire, ni le fichier de configuration, ni le domaine réservé.


== Contrôles et journaux ==

<syntaxhighlight lang="bash">systemctl --user status ngrok-8080.service
systemctl --user is-enabled ngrok-8080.service
systemctl --user is-active ngrok-8080.service
journalctl --user -u ngrok-8080.service -n 100 --no-pager
ngrok version
curl -I https://noella-oxidizable-nonsuppositively.ngrok-free.dev</syntaxhighlight>
En cas d'échec, vérifier d'abord que Caddy écoute bien sur <code>8099</code> et que son backend <code>127.0.0.1:8085</code> répond avant de relancer ngrok.


== Retour arrière ==

Le retour arrière courant consiste à arrêter et désactiver le service :

<syntaxhighlight lang="bash">systemctl --user disable --now ngrok-8080.service</syntaxhighlight>
Ne pas supprimer le fichier <code>/home/loic/.config/ngrok/ngrok.yml</code> pendant cette opération. La configuration peut ainsi être réactivée sans réinstallation.


== Fichiers de référence ==

* <code>/usr/local/bin/ngrok</code>
* <code>/home/loic/.config/ngrok/ngrok.yml</code> — secret, ne pas publier ;
* <code>/home/loic/.config/systemd/user/ngrok-8080.service</code>
* <code>/etc/caddy/Caddyfile</code> — bloc <code>:8099</code>.

Trace install tas - ngrok - Historique des versions

Admin : Documentation de la mise en œuvre ngrok sur tas

Admin : Documentation de la mise en œuvre ngrok sur tas