SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor · Mis à jour le 2026-11-13

Contourner le CGNAT avec un tunnel inverse sur VPS

Votre FAI ne vous fournit pas d'IP publique ? Utilisez frp sur un VPS pour créer un tunnel inverse. Exposez vos services locaux en HTTPS avec un certificat valide.

Pourquoi le port forwarding est inopérant derrière un CGNAT

Derrière un CGNAT (Carrier-Grade NAT), l'adresse WAN de votre routeur est partagée avec d'autres abonnés. Aucune adresse IPv4 publique ne vous est attribuée, il n'y a donc aucun port à rediriger. Un tunnel inverse résout ce problème : un VPS peu coûteux détient l'IP publique, votre box domestique initie une connexion vers le VPS, et les requêtes entrantes empruntent ce tunnel déjà ouvert par la box. Vous conservez votre matériel actuel. Vous louez simplement la seule chose que votre FAI ne vous fournit pas : une adresse routable.

Chaque commande ci-dessous est identifiée par la machine sur laquelle elle doit être exécutée. Cette configuration nécessite deux machines : le VPS avec une IP publique et la box domestique hébergeant le service que vous souhaitez rendre accessible.

Comment savoir si vous êtes derrière un CGNAT

Ouvrez la page d'administration de votre routeur et relevez l'adresse WAN indiquée. Demandez ensuite à Internet quelle adresse il voit.

# on the home box
curl -4 -s https://ifconfig.me; echo

Si les deux adresses correspondent, vous disposez d'une IP publique et vous n'avez besoin d'aucune de ces manipulations. Redirigez le port et arrêtez votre lecture. Si l'adresse WAN du routeur se situe dans 100.64.0.0/10, vous êtes derrière un CGNAT. Ce bloc correspond à l'espace d'adressage partagé RFC 6598, réservé précisément à cet usage. Certains FAI utilisent 10.0.0.0/8 sur l'interface WAN, ce qui revient à la même situation sous une étiquette différente.

Vérifiez un point avant de louer quoi que ce soit. De nombreux FAI utilisant le CGNAT distribuent un préfixe IPv6 réel. Si votre box domestique possède une adresse IPv6 globale, vous pouvez ouvrir le pare-feu sur cette adresse et ignorer totalement le tunnel. Cela cesse de fonctionner dès qu'un visiteur utilise un réseau IPv4 uniquement, ce qui explique pourquoi la plupart des gens finissent par arriver ici.

Fonctionnement d'un tunnel inverse VPS, initié depuis l'intérieur

Le CGNAT et les routeurs domestiques standards bloquent les connexions entrantes non sollicitées. Les pare-feux d'entreprise font de même. Aucun ne bloque les connexions sortantes, car c'est ce que font tous les navigateurs et clients de mise à jour en permanence. Un équipement NAT qui détecte une connexion TCP sortante crée un mappage pour celle-ci et autorise le trafic retour sur cette même connexion. Rien à l'extérieur ne peut initier une connexion vers votre machine domestique. C'est donc la machine domestique qui l'initie, et le tunnel transporte le trafic en retour dans l'autre sens sur cette même connexion.

C'est tout le mécanisme. La machine domestique se connecte au VPS sur un port et maintient la connexion ouverte. Le VPS accepte les requêtes publiques et les transmet via cette connexion existante. Rien ne tente jamais d'atteindre votre adresse IP domestique, il n'est donc pas nécessaire que ce soit le cas.

Deux conséquences en découlent, toutes deux utiles. Votre enregistrement DNS pointe vers le VPS, jamais vers votre domicile. Et votre adresse publique est désormais celle du VPS ; ainsi, tout ce qu'un observateur apprend via une recherche IP concerne un serveur loué plutôt que votre ligne domestique.

Trois méthodes de mise en œuvre

  1. ssh -R : déjà installé sur les deux extrémités, adapté à un service unique ou à une démonstration temporaire. Il ne propose ni tableau de bord ni logique de reconnexion robuste.
  2. frp : un serveur léger en Go (frps) et son client correspondant (frpc). Adapté à une configuration permanente avec plusieurs services derrière un même nom d'hôte. C'est le cœur de ce guide.
  3. Un VPN mesh : Tailscale, ou un serveur WireGuard auto-hébergé. Adapté si vous souhaitez que vos propres appareils communiquent entre eux de manière privée plutôt que de publier un service sur l'internet public.

Choisissez le VPN mesh si votre objectif est un accès privé depuis des appareils que vous contrôlez. Tailscale Serve et Funnel traite de la publication depuis un tailnet, et un VPN WireGuard auto-hébergé sur le même VPS offre une architecture similaire sans serveur de coordination tiers. Lisez l'un de ces guides et ignorez le reste de cette page. Tout ce qui suit suppose que vous souhaitez obtenir un nom d'hôte HTTPS public accessible par n'importe qui.

La version rapide : ssh -R pour un service

Supposons que votre machine locale exécute une application sur le port 127.0.0.1:3000 et que vous ayez déjà un accès SSH vers le VPS.

# on the home box
ssh -N \
  -o ExitOnForwardFailure=yes \
  -o ServerAliveInterval=30 \
  -o ServerAliveCountMax=3 \
  -R 127.0.0.1:8080:127.0.0.1:3000 \
  tunnel@vps.example.com

-R 127.0.0.1:8080:127.0.0.1:3000 indique au service sshd du VPS d'écouter sur son propre port 127.0.0.1:8080 et de transmettre tout ce qui y arrive vers le port 127.0.0.1:3000 de la machine locale. -N signifie qu'aucun shell ne doit être lancé. Les deux options ServerAlive permettent à ssh de détecter une connexion rompue en environ quatre-vingt-dix secondes au lieu de rester bloqué sur une connexion qui n'existe plus.

Voici maintenant la partie qui porte à confusion. Cet écouteur est sur l'interface de loopback, donc une connexion curl http://vps.example.com:8080 depuis n'importe où ailleurs échouera. sshd est livré avec GatewayPorts no, ce qui signifie qu'un transfert distant se lie uniquement à l'interface de loopback. Ne corrigez pas cela en activant GatewayPorts yes. Laissez le transfert sur le loopback et placez nginx devant, de la même manière que pour la configuration frp ci-dessous, afin que le port public soit le 443 avec un certificat et que le port du tunnel ne soit jamais exposé sur Internet. Si vous n'êtes pas sûr de ce qui écoute actuellement et sur quelle interface, un tour rapide des ports et des écouteurs sous Linux mérite dix minutes de lecture.

Si le port est déjà utilisé sur le VPS, ssh affiche ceci, et ExitOnForwardFailure=yes force l'arrêt au lieu de se connecter sans tunnel fonctionnel :

Warning: remote port forwarding failed for listen port 8080

La cause habituelle est une session précédente qui s'est terminée sans que sshd ne le remarque. Configurez ClientAliveInterval 30 et ClientAliveCountMax 3 dans le fichier /etc/ssh/sshd_config du VPS afin que les sessions mortes soient supprimées et libèrent le port. Encapsulez toute la commande dans une unité systemd avec Restart=always et une clé dédiée, ou utilisez autossh. Pour tout ce qui concerne plus d'un service, arrêtez-vous ici et utilisez frp.

Installer frp sur le VPS, en verrouillant la version

frp est distribué sous forme de binaire Go statique et n'est pas présent dans les dépôts Ubuntu ou Debian. Vous devez donc télécharger une version et la vérifier vous-même. Verrouillez la version utilisée. Le format de configuration a changé à partir de la v0.52.0 et les noms des options ont évolué depuis ; un tutoriel obsolète vous donnera des clés que votre binaire ne reconnaîtra pas. Ce guide utilise la v0.71.0, publiée le 14 août 2026.

# on the VPS
FRP_VERSION=0.71.0
ARCH=amd64   # use arm64 if `uname -m` prints aarch64
cd /tmp
curl -fsSLO "https://github.com/fatedier/frp/releases/download/v${FRP_VERSION}/frp_${FRP_VERSION}_linux_${ARCH}.tar.gz"
curl -fsSLO "https://github.com/fatedier/frp/releases/download/v${FRP_VERSION}/frp_sha256_checksums.txt"
sha256sum --check --ignore-missing frp_sha256_checksums.txt

sha256sum doit afficher exactement une ligne :

frp_0.71.0_linux_amd64.tar.gz: OK

--ignore-missing est nécessaire car le fichier de somme de contrôle couvre les dix-sept archives de la version alors que vous n'en avez téléchargé qu'une seule. Sans ce flag, sha256sum signale les seize autres comme manquantes et renvoie un code de sortie différent de zéro, ce qui ressemble à une vérification échouée alors qu'il n'y a aucun problème.

# on the VPS
tar xzf "frp_${FRP_VERSION}_linux_${ARCH}.tar.gz"
sudo install -m 755 "frp_${FRP_VERSION}_linux_${ARCH}/frps" /usr/local/bin/frps
sudo useradd --system --no-create-home --shell /usr/sbin/nologin frp
sudo install -d -m 750 -o root -g frp /etc/frp
frps --version

frps --version affiche 0.71.0. Seul frps doit être installé sur le VPS. frpc doit être installé sur la machine locale. Installer les deux binaires partout est la raison pour laquelle certains utilisateurs lancent accidentellement un serveur de tunnel depuis chez eux.

La configuration du VPS : jeton, TLS forcé et écoute sur loopback

Générez d'abord un jeton. C'est la seule protection entre votre tunnel et quiconque scanne les ports du VPS.

# on the VPS
openssl rand -base64 32

Écrivez cette valeur dans /etc/frp/frps.toml :

bindAddr = "0.0.0.0"
bindPort = 7000

# Every listener frp creates for a proxy, including the HTTP vhost, stays on loopback.
proxyBindAddr = "127.0.0.1"
vhostHTTPPort = 8080

auth.method = "token"
auth.token = "PASTE_THE_OPENSSL_OUTPUT_HERE"

transport.tls.force = true

webServer.addr = "127.0.0.1"
webServer.port = 7500
webServer.user = "admin"
webServer.password = "PASTE_A_SECOND_SECRET_HERE"

log.level = "info"

Quatre de ces lignes assurent la sécurité ; étudions-les une par une.

auth.token doit correspondre à auth.token sur le client. Sans cela, frps accepte tout client trouvant le port 7000, et ce client peut alors publier ce qu'il souhaite via votre VPS et votre certificat.

transport.tls.force = true rejette toute connexion de contrôle qui n'est pas en TLS (transport layer security). Les clients utilisent TLS par défaut depuis la version v0.50.0 ; cela ne vous coûte donc rien en pratique et empêche le cas où un client ancien ou personnalisé se connecterait en clair sans vous en avertir.

proxyBindAddr = "127.0.0.1" est la ligne que la plupart des guides omettent, et c'est pourquoi cette configuration peut rester active sans risque. Elle déplace chaque écouteur ouvert par frp pour un proxy, tant le vhost HTTP que tout remotePort demandé par un client, sur l'interface loopback. Internet ne peut pas atteindre ces écouteurs. Deux portes restent publiques : nginx sur le port 443, que vous configurez et contrôlez, et le port de contrôle frp sur le port 7000, que proxyBindAddr ne touche pas et que le jeton ainsi que le TLS forcé protègent.

webServer.addr = "127.0.0.1" maintient le tableau de bord hors de l'interface publique. Le tableau de bord est une carte complète de vos services privés et de leur trafic, protégée par un seul mot de passe HTTP basic auth ; il n'a donc pas sa place sur 0.0.0.0.

Définissez le propriétaire du fichier pour que le jeton ne soit pas lisible par tous, puis vérifiez la syntaxe avant de lancer quoi que ce soit :

# on the VPS
sudo chown root:frp /etc/frp/frps.toml
sudo chmod 640 /etc/frp/frps.toml
sudo -u frp frps verify -c /etc/frp/frps.toml

Un fichier valide affiche :

frps: the configuration file /etc/frp/frps.toml syntax is ok

Une remarque sur le format qui vous fera gagner du temps. frp lit les fichiers .toml, .yaml, .yml et .json, et il reconnaît un ancien fichier INI par sa section [common] plutôt que par son extension. Ces fichiers INI se chargent toujours via un chemin de conversion hérité, mais le format INI est obsolète et sera supprimé dans une version future ; les nouvelles fonctionnalités ne fonctionnent qu'en TOML, YAML ou JSON. Si un tutoriel vous montre une section [common] et des server_addr = x.x.x.x, il date d'avant la version v0.52.0. Ses noms de clés en snake_case appartiennent à ce format hérité : collés dans le frps.toml ci-dessus, ils échouent à la vérification stricte que frps verify exécute par défaut.

Exécuter frps en tant que service sans privilèges

bindPort est 7000 et vhostHTTPPort est 8080. Les deux sont supérieurs à 1024, donc frps n'a jamais besoin de root et n'a jamais besoin de CAP_NET_BIND_SERVICE. C'est la raison pour laquelle il ne faut pas placer le vhost sur le port 80 et laisser nginx s'en charger à la place.

Écrivez /etc/systemd/system/frps.service :

[Unit]
Description=frp reverse tunnel server
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=frp
Group=frp
ExecStart=/usr/local/bin/frps -c /etc/frp/frps.toml
Restart=on-failure
RestartSec=5s
LimitNOFILE=65535
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true
ProtectKernelTunables=true

[Install]
WantedBy=multi-user.target
# on the VPS
sudo systemctl daemon-reload
sudo systemctl enable --now frps
sudo journalctl -u frps -n 20 --no-pager

Le journal doit afficher les deux listeners, et les adresses importent plus que les ports :

frps tcp listen on 0.0.0.0:7000
http service listen on 127.0.0.1:8080

ProtectSystem=strict rend tout le système de fichiers en lecture seule pour ce service. frps le tolère car son journal est envoyé vers la sortie standard par défaut et journald le capture. Si vous définissez log.to sur un chemin de fichier, le service échouera à y écrire tant que vous n'aurez pas ajouté une ligne ReadWritePaths= correspondante, donc conservez la valeur par défaut.

Pare-feu : ouvrir un port unique, pas une plage

# on the VPS
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 7000/tcp
sudo ufw enable
sudo ufw status numbered

Quatre règles, dont une existe uniquement pour le renouvellement des certificats. Le port 22 est réservé au SSH. Le port 80 redirige vers le 443 et répond au challenge ACME (automatic certificate management environment). Le port 443 dessert toutes les applications tunnelisées. Le port 7000 est le port de contrôle de frp ; c'est le seul port qu'un client doit pouvoir atteindre.

Les guides qui vous conseillent d'ouvrir une plage telle que sudo ufw allow 20000:30000/tcp décrivent une autre architecture, où chaque service utilise son propre port TCP public. Vous n'en avez pas besoin ici, car tout arrive sur le port 443 et frp effectue le routage selon le nom d'hôte. Si vous avez besoin plus tard d'un port TCP réellement public, remettez proxyBindAddr à 0.0.0.0 et ajoutez des limites pour qu'un client ne puisse réclamer que les ports que vous avez spécifiés :

allowPorts = [
  { start = 20000, end = 20010 }
]
maxPortsPerClient = 5

La plupart des fournisseurs proposent également un pare-feu réseau dans leur panneau de contrôle, distinct de ufw sur la machine. Une règle qui semble correcte dans sudo ufw status mais qui génère un délai d'attente (timeout) est généralement bloquée à ce niveau. Les règles ufw réellement nécessaires pour un VPS détaille la configuration par défaut « tout refuser » (default-deny) supposée dans cette section.

Terminer le HTTPS sur le VPS avec un certificat valide

Faites pointer un enregistrement A pour home.example.com vers l'adresse IP publique du VPS. Pas vers votre domicile. Votre domicile n'a pas d'adresse vers laquelle pointer, ce qui est précisément le problème que vous résolvez.

# on the VPS
sudo apt update
sudo apt install -y nginx certbot python3-certbot-nginx

Créez /etc/nginx/sites-available/home.example.com avec un bloc écoutant sur le port 80 en premier, afin que certbot dispose d'un server_name correspondant pour fonctionner :

server {
    listen 80;
    listen [::]:80;
    server_name home.example.com;
    location / { return 404; }
}
# on the VPS
sudo ln -s /etc/nginx/sites-available/home.example.com /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx
sudo certbot certonly --nginx -d home.example.com

nginx -t affiche nginx: configuration file /etc/nginx/nginx.conf test is successful lorsque les fichiers sont analysés correctement. Exécutez-la avant chaque rechargement. nginx maintient l'ancienne configuration active si un rechargement échoue ; une modification erronée donne donc l'impression qu'aucune modification n'a été prise en compte.

Les mises à niveau WebSocket nécessitent une directive map au niveau http. Placez-la dans /etc/nginx/conf.d/upgrade.conf :

map $http_upgrade $connection_upgrade {
    default upgrade;
    ''      close;
}

Remplacez maintenant le fichier du site par la version finale :

server {
    listen 80;
    listen [::]:80;
    server_name home.example.com;
    return 301 https://$host$request_uri;
}

server {
    listen 443 ssl;
    listen [::]:443 ssl;
    server_name home.example.com;

    ssl_certificate     /etc/letsencrypt/live/home.example.com/fullchain.pem;
    ssl_certificate_key /etc/letsencrypt/live/home.example.com/privkey.pem;

    client_max_body_size 512m;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host              $host;
        proxy_set_header X-Real-IP         $remote_addr;
        proxy_set_header X-Forwarded-For   $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
        proxy_set_header Upgrade           $http_upgrade;
        proxy_set_header Connection        $connection_upgrade;
        proxy_read_timeout 3600s;
    }
}

proxy_set_header Host $host; n'est pas optionnel ici. Le vhost HTTP de frp route les requêtes via l'en-tête Host, en le comparant à la liste customDomains dans la configuration du client. Si vous omettez cet en-tête, nginx envoie Host: 127.0.0.1, frp ne trouve aucun proxy pour ce nom, et votre visiteur reçoit une erreur 404 brute de la part de frp au lieu de la page de l'application. Chaque ligne d'un bloc reverse proxy nginx, expliquée détaille le rôle des autres en-têtes.

# on the VPS
sudo nginx -t && sudo systemctl reload nginx
sudo certbot renew --dry-run

Le test à blanc (dry run) prouve que le renouvellement fonctionnera dans quatre-vingt-dix jours, moment où vous ne serez pas devant votre écran. Il nécessite que le port 80 soit accessible, c'est pourquoi cette règle ufw est présente.

Le côté domicile : frpc en tant que service sans privilèges

Installez frpc sur la machine domestique exactement comme vous avez installé frps, avec la même version et la même étape de vérification de somme de contrôle, puis créez le même utilisateur frp et le même répertoire /etc/frp. Rédigez /etc/frp/frpc.toml :

serverAddr = "vps.example.com"
serverPort = 7000

auth.method = "token"
auth.token = "PASTE_THE_SAME_TOKEN_HERE"

transport.tls.enable = true
loginFailExit = false

proxies = [
  { name = "home-app", type = "http", localIP = "127.0.0.1", localPort = 3000, customDomains = ["home.example.com"] }
]

L'ordre des clés est important dans ce fichier, et pas pour des raisons de style. TOML assigne chaque clé située après un en-tête de table à cette table ; ainsi, un paramètre de haut niveau tel que serverAddr écrit sous un en-tête de table proxy devient silencieusement un paramètre de proxy que frp ignore. Écrire la liste des proxys sous forme de tableau en ligne, comme illustré ci-dessus, évite ce piège : chaque clé de haut niveau reste sans ambiguïté au niveau supérieur.

type = "http" achemine ce proxy via l'écouteur vhost au lieu de réclamer son propre port TCP public, ce qui explique pourquoi le pare-feu est resté à quatre règles. customDomains doit contenir le nom d'hôte que nginx transmet dans l'en-tête Host, il s'agit donc de home.example.com et jamais de l'adresse IP du VPS.

loginFailExit = false est plus important qu'il n'y paraît. La valeur par défaut est true, ce qui provoque l'arrêt de frpc si sa première tentative de connexion échoue. Sur une machine domestique qui termine son démarrage avant que la connexion du FAI ne soit établie, c'est un service qui reste inactif jusqu'à ce que vous vous en aperceviez. Réglez-le sur false et frpc continuera de réessayer jusqu'à ce que le VPS réponde.

Rédigez /etc/systemd/system/frpc.service :

[Unit]
Description=frp reverse tunnel client
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
User=frp
Group=frp
ExecStart=/usr/local/bin/frpc -c /etc/frp/frpc.toml
Restart=always
RestartSec=10s
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=strict
ProtectHome=true

[Install]
WantedBy=multi-user.target
# on the home box
sudo chown root:frp /etc/frp/frpc.toml
sudo chmod 640 /etc/frp/frpc.toml
sudo -u frp frpc verify -c /etc/frp/frpc.toml
sudo systemctl daemon-reload
sudo systemctl enable --now frpc
sudo journalctl -u frpc -n 20 --no-pager

Un client qui s'est connecté enregistre un run id :

login to server success, get run id [3a1f9c2b7d4e5f60]

Ouvrez https://home.example.com dans un navigateur et vous devriez obtenir l'application qui réside sur 127.0.0.1:3000 à domicile. Restart=always sur le client est intentionnel : les connexions domestiques sont instables et le service doit revenir sans votre intervention.

Restreindre l'accès au tableau de bord

Avec webServer.addr = "127.0.0.1", le tableau de bord ne répond que sur le VPS lui-même. Accédez-y depuis votre ordinateur portable via un tunnel local au lieu d'ouvrir un port :

# on your laptop
ssh -N -L 7500:127.0.0.1:7500 you@vps.example.com

Ouvrez http://127.0.0.1:7500 et connectez-vous avec le webServer.user et le webServer.password issus de frps.toml. La page liste chaque client connecté ainsi que les compteurs de trafic pour chaque proxy ; c'est le moyen le plus rapide de vérifier si la box domestique est bien connectée. Fermez la session ssh et le tableau de bord redevient inaccessible.

Ce que le tunnel ne fait pas

Lisez attentivement cette section, car c'est ici que les erreurs surviennent. Le tunnel rend un service privé accessible depuis l'internet public. Il n'authentifie pas les personnes qui y accèdent. Une fois que https://home.example.com est résolu, les scanners le trouveront en quelques jours, que vous ayez communiqué le nom ou non. Les journaux de transparence des certificats publient chaque nom d'hôte pour lequel vous émettez un certificat ; le nom est donc public dès que certbot réussit.

Tout ce que vous exposez doit disposer de sa propre authentification. Si l'application possède une connexion réelle avec limitation de débit, c'est parfait. Si sa connexion repose sur un mot de passe partagé, ou si elle n'en a aucune, placez un proxy d'authentification devant elle sur le VPS. Un oauth2-proxy placé devant l'application est la solution habituelle ; il s'insère entre nginx et le vhost frp sans modifier les extrémités du tunnel. Si l'application que vous publiez est Home Assistant et que vous l'ouvrez pour que Claude puisse la piloter à distance, le guide pour connecter Claude à Home Assistant avec MCP montre comment limiter ce qu'il peut faire avec un compte dédié, un accès en lecture seule et les seules entités que vous choisissez d'exposer.

Le jeton dans frps.toml protège le tunnel, pas les applications. Il empêche un inconnu d'enregistrer son propre proxy sur votre VPS. Il n'a aucun effet sur une requête arrivant sur le port 443 pour un nom d'hôte que vous avez publié volontairement.

Deux habitudes sont à prendre. Renouvelez le jeton en modifiant les deux fichiers et en redémarrant les deux services, car il n'expire jamais de lui-même. Maintenez également frp à jour : ce binaire est votre porte d'entrée publique. Les notes de la version v0.71.0 mentionnent une panique serveur déclenchée par une valeur incorrecte envoyée depuis un client ; c'est le type de bug qu'il vaut mieux corriger par une mise à jour plutôt que d'essayer de contourner.

Modes de défaillance et messages associés

Le client ne se connecte jamais. journalctl -u frpc répète connect to server error: suivi d'un délai d'attente (dial timeout). Rien n'atteint le port 7000. Vérifiez ufw sur le VPS, puis le pare-feu réseau du fournisseur dans le panneau de contrôle, et confirmez que le nom est bien résolu avec getent hosts vps.example.com.

Le jeton est incorrect. Le client l'indique explicitement à chaque tentative :

connect to server error: token in login doesn't match token from configuration

Copiez à nouveau le jeton. Un saut de ligne en fin de chaîne, ou une variable $ dans une chaîne shell non protégée par des guillemets qui s'est développée en rien, sont à l'origine de la quasi-totalité de ces erreurs. C'est pourquoi la sortie de openssl rand -base64 32 doit être placée entre guillemets dans le fichier TOML.

Le tunnel est actif mais le navigateur reçoit une erreur 404. frpc a enregistré une connexion réussie et le tableau de bord liste le proxy, pourtant la page renvoie une erreur 404 sans aucun style de l'application. Il s'agit de la page « not found » propre à frp. frp la sert lorsqu'aucun proxy ne correspond à l'en-tête Host, ou lorsqu'il ne parvient pas à transmettre la requête à l'application sur la machine domestique. Testez le vhost directement sur le VPS, en contournant nginx et TLS :

# on the VPS
curl -s -o /dev/null -w '%{http_code}\n' -H 'Host: home.example.com' http://127.0.0.1:8080/

Une erreur 404 issue de cette commande ne constitue pas une preuve en soi, car l'application peut renvoyer sa propre erreur 404. Exécutez-la à nouveau sans -o /dev/null et lisez le corps de la réponse. Si le message indique The page you requested was not found., il provient de frp : soit customDomains ne correspond pas à home.example.com, soit frp n'a pas pu joindre l'application ; exécutez alors curl -I http://127.0.0.1:3000/ sur la machine domestique. Si la réponse provient de l'application elle-même, le vhost est correct et la requête n'a jamais reçu le bon Host de la part de nginx.

Erreur 502 de nginx. Généralement, nginx répond mais pas frp. Le vhost HTTP de frp signale ses propres échecs par des erreurs 404 ou 504, et non 502. Cependant, nginx transmet une erreur 502 sans modification si l'application distante en envoie une ; vérifiez donc la source avant de redémarrer quoi que ce soit. sudo ss -lntp | grep 8080 sur le VPS doit montrer frps en écoute sur 127.0.0.1:8080. Une sortie vide signifie que frps est arrêté, ou que vhostHTTPPort n'est pas défini dans frps.toml.

L'application considère que chaque visiteur est local. Votre application enregistre 127.0.0.1 pour chaque requête. nginx définit X-Forwarded-For et frp y ajoute des informations, l'adresse réelle du client se trouve donc dans cet en-tête. Configurez l'application pour qu'elle s'y fie. Ne négligez pas cette étape si l'application limite le débit par adresse IP, car sinon, tous les visiteurs sur Internet partagent le même quota.

Les requêtes longues sont coupées à 60 secondes. Les téléversements ou les flux de données s'interrompent en cours de route. Il s'agit de la valeur par défaut proxy_read_timeout de nginx, et non du tunnel. Le bloc ci-dessus l'augmente à 3600s. client_max_body_size est la limite correspondante pour la taille des téléversements ; sa valeur par défaut de 1 MB rejette les corps plus volumineux avec une erreur 413.

Tout fonctionne, puis s'arrête après un redémarrage du routeur. Restart=always dans l'unité frpc ainsi que loginFailExit = false permettent de gérer ce cas. Confirmez avec sudo systemctl is-enabled frpc, qui doit afficher enabled.

FAQ

Comment savoir si je suis derrière un CGNAT ?

Comparez l'adresse WAN affichée sur la page d'administration de votre routeur avec celle que curl -4 -s https://ifconfig.me rapporte depuis le même réseau. Si elles diffèrent et que l'adresse WAN du routeur se trouve dans 100.64.0.0/10, votre FAI utilise du carrier-grade NAT. Cette plage correspond à l'espace d'adressage partagé RFC 6598, réservé à cet usage. Certains FAI utilisent 10.0.0.0/8 sur l'interface WAN, ce qui signifie la même chose. Si les deux adresses correspondent, vous disposez d'une IP publique : redirigez le port et l'opération est terminée.

Ai-je besoin d'un nom de domaine pour un tunnel inverse ?

Pour la configuration HTTPS décrite ici, oui. Un certificat est émis pour un nom d'hôte, et le vhost HTTP de frp achemine les requêtes selon l'en-tête Host ; les deux extrémités doivent donc s'accorder sur un nom. Un proxy TCP brut sur un port numéroté fonctionne avec l'IP nue du VPS sans aucun domaine, mais vous n'aurez alors ni certificat ni routage par nom d'hôte, ce qui signifie qu'un port public ne peut servir qu'un seul service.

Est-il sûr d'exécuter frp sur un VPS public ?

C'est sûr si le port de contrôle est le seul écouteur frp exposé et qu'il est authentifié. Définissez auth.token sur une valeur aléatoire aux deux extrémités et transport.tls.force = true sur le serveur. Configurez ensuite proxyBindAddr = "127.0.0.1" afin qu'aucun proxy ouvert par frp ne soit exposé à Internet, et gardez le tableau de bord sur webServer.addr = "127.0.0.1", accessible via un tunnel SSH local. Mettez à jour le binaire lors de la sortie de nouvelles versions, car c'est le processus qui écoute sur votre adresse publique.

Pourquoi personne ne peut atteindre mon port redirigé ssh -R ?

sshd est livré avec GatewayPorts no, donc un transfert distant ne se lie qu'à l'interface de loopback du VPS. curl exécuté sur le VPS lui-même fonctionne, mais curl depuis n'importe où ailleurs expire. La solution correcte consiste à laisser le transfert sur le loopback et à placer nginx sur le port 443 devant. Activer GatewayPorts yes publie un port brut sans certificat ni TLS, ce qui est pire que le problème initial.

Dois-je utiliser frp ou un VPN mesh comme Tailscale ou WireGuard ?

Utilisez un VPN mesh lorsque seuls vos propres appareils ont besoin d'un accès, car rien n'est alors publié et aucun nom d'hôte public n'est disponible pour être scanné. Utilisez frp lorsque vous avez besoin d'une adresse HTTPS publique accessible par n'importe quel navigateur, comme pour un récepteur de webhook ou une page partagée avec des personnes qui n'installeront pas de client VPN. Les deux coexistent parfaitement sur un même VPS, sur des ports différents, pour des usages distincts.

Cet article vous a-t-il été utile ?