Voir la source de Accéder et capturer une page web via un tunnel SSH

{{DISPLAYTITLE:Accéder et capturer une page web via un tunnel SSH}}

Ce guide explique comment consulter depuis une autre machine un service web qui n'écoute que sur l'interface locale d'un serveur, vérifier son accès, en faire une capture d'écran puis envoyer cette capture dans Telegram avec OpenClaw.

L'exemple utilise l'application '''AI Tester''' de Hermes sur la machine <code>tas</code>. Le service est publié uniquement sur <code>tas:127.0.0.1:5000</code> : il n'est donc pas directement accessible depuis le réseau.

Dernière vérification : 17 juillet 2026.

__TOC__

== Principe ==

Le tunnel local SSH suit ce trajet :

<pre>
Chromium ou curl
    → client:127.0.0.1:15000
    → tunnel SSH
    → tas:127.0.0.1:5000
</pre>

Le port <code>15000</code> est le port d'entrée choisi sur la machine cliente. La destination <code>127.0.0.1:5000</code> est interprétée depuis le serveur SSH <code>tas</code>.

== Prérequis ==

Sur la machine cliente :

* un accès SSH par clé au compte <code>loic@tas</code> ;
* <code>curl</code> pour vérifier la réponse HTTP ;
* Google Chrome ou Chromium pour produire la capture ;
* OpenClaw configuré pour Telegram si la capture doit être envoyée par la CLI.

Le service doit déjà répondre sur <code>tas:127.0.0.1:5000</code>.

== Ouvrir le tunnel SSH ==

Dans un premier terminal sur la machine cliente :

<syntaxhighlight lang="bash">
ssh \
  -N \
  -o ExitOnForwardFailure=yes \
  -L 127.0.0.1:15000:127.0.0.1:5000 \
  loic@tas
</syntaxhighlight>

La commande reste au premier plan pendant toute l'utilisation du tunnel.

Signification des paramètres :

* <code>-N</code> : ne lance aucune commande distante ;
* <code>-L</code> : crée une redirection locale ;
* <code>127.0.0.1:15000</code> : adresse et port d'entrée sur la machine cliente ;
* <code>127.0.0.1:5000</code> : service de destination vu depuis <code>tas</code> ;
* <code>ExitOnForwardFailure=yes</code> : arrête immédiatement SSH si le tunnel ne peut pas être créé.

Si la clé n'est pas sélectionnée automatiquement, préciser son chemin :

<syntaxhighlight lang="bash">
ssh \
  -i ~/.ssh/id_rsa_user \
  -N \
  -o ExitOnForwardFailure=yes \
  -L 127.0.0.1:15000:127.0.0.1:5000 \
  loic@tas
</syntaxhighlight>

Le préfixe local <code>127.0.0.1:</code> empêche les autres machines du réseau d'utiliser ce tunnel.

== Vérifier l'accès HTTP ==

Dans un second terminal sur la machine cliente :

<syntaxhighlight lang="bash">
curl --fail --show-error \
  -o /dev/null \
  -w 'HTTP %{http_code} | %{content_type}\n' \
  http://127.0.0.1:15000/
</syntaxhighlight>

Réponse attendue :

<pre>
HTTP 200 | text/html; charset=utf-8
</pre>

Pour ouvrir la page manuellement, utiliser dans le navigateur de la machine cliente :

<pre>
http://127.0.0.1:15000/
</pre>

== Capturer la page avec Chromium ==

Avec Google Chrome :

<syntaxhighlight lang="bash">
google-chrome \
  --headless \
  --disable-gpu \
  --screenshot="$PWD/hermes-ai-tester-home.png" \
  --window-size=1440,1100 \
  http://127.0.0.1:15000/
</syntaxhighlight>

Avec Chromium, remplacer simplement <code>google-chrome</code> par <code>chromium</code> ou <code>chromium-browser</code> selon la distribution.

Vérifier ensuite le fichier :

<syntaxhighlight lang="bash">
file "$PWD/hermes-ai-tester-home.png"
</syntaxhighlight>

== Envoyer la capture dans Telegram avec OpenClaw ==

Remplacer <code>IDENTIFIANT_DU_CHAT</code> par l'identifiant du chat Telegram destinataire :

<syntaxhighlight lang="bash">
openclaw message send \
  --channel telegram \
  --target 'IDENTIFIANT_DU_CHAT' \
  --message 'Capture de la page d’accueil AI Tester via tunnel SSH.' \
  --media "$PWD/hermes-ai-tester-home.png"
</syntaxhighlight>

Cette commande envoie un fichier existant. Elle ne lance pas de modèle de langage.

Pour vérifier la commande sans envoyer de message :

<syntaxhighlight lang="bash">
openclaw message send \
  --dry-run \
  --channel telegram \
  --target 'IDENTIFIANT_DU_CHAT' \
  --message 'Capture de test.' \
  --media "$PWD/hermes-ai-tester-home.png"
</syntaxhighlight>

== Fermer le tunnel ==

Revenir dans le premier terminal et presser <code>Ctrl+C</code>. Le port local <code>15000</code> est alors libéré.

Vérification facultative :

<syntaxhighlight lang="bash">
curl --max-time 2 http://127.0.0.1:15000/
</syntaxhighlight>

Après fermeture, cette commande doit échouer avec une erreur de connexion.

== Dépannage ==

=== Le port local 15000 est déjà occupé ===

Choisir un autre port d'entrée, par exemple <code>15001</code>, dans la commande SSH et dans toutes les URL locales.

=== SSH affiche « No route to host » ===

Vérifier la résolution de <code>tas</code>, sa route réseau, son adresse IP et l'accessibilité du port SSH :

<syntaxhighlight lang="bash">
getent hosts tas
ssh -v loic@tas
</syntaxhighlight>

=== SSH affiche « Permission denied (publickey) » ===

Vérifier le compte distant, le chemin de la clé et la présence de sa clé publique dans <code>~/.ssh/authorized_keys</code> sur <code>tas</code>.

=== curl renvoie « Connection refused » ===

Le tunnel peut être établi alors que le service cible ne fonctionne pas. Depuis <code>tas</code>, contrôler directement :

<syntaxhighlight lang="bash">
curl -I http://127.0.0.1:5000/
</syntaxhighlight>

=== Précautions de sécurité ===

* conserver l'écoute locale du tunnel sur <code>127.0.0.1</code> ;
* ne pas publier directement AI Tester sur Internet ;
* ne pas exposer un serveur Flask/Werkzeug de développement sans authentification ni reverse proxy adapté ;
* vérifier le destinataire avant d'utiliser <code>openclaw message send</code> sans <code>--dry-run</code>.

== Résumé des commandes ==

<syntaxhighlight lang="bash">
# Terminal 1 : tunnel
ssh -N -o ExitOnForwardFailure=yes \
  -L 127.0.0.1:15000:127.0.0.1:5000 loic@tas

# Terminal 2 : test
curl --fail --show-error -o /dev/null \
  -w 'HTTP %{http_code} | %{content_type}\n' \
  http://127.0.0.1:15000/

# Capture
google-chrome --headless --disable-gpu \
  --screenshot="$PWD/hermes-ai-tester-home.png" \
  --window-size=1440,1100 \
  http://127.0.0.1:15000/

# Envoi Telegram
openclaw message send \
  --channel telegram \
  --target 'IDENTIFIANT_DU_CHAT' \
  --message 'Capture AI Tester via tunnel SSH.' \
  --media "$PWD/hermes-ai-tester-home.png"
</syntaxhighlight>

[[Category:SSH]]
[[Category:OpenClaw]]
[[Category:Hermes]]