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

Installer un bridge Tor obfs4 sur un VPS

Configurez un bridge Tor obfs4 sur un VPS économique : directives torrc, port, pare-feu, lignes de log attendues et méthode pour transmettre vos accès aux utilisateurs.

Ce qu’est un bridge Tor et pourquoi il existe

Un bridge Tor est un point d’entrée dans le réseau Tor dont l’adresse n’est pas publiée dans la liste publique des relais. Cette liste, appelée consensus, est un document signé que n’importe qui peut télécharger, y compris un censeur. Il suffit d’un après-midi pour bloquer Tor à partir de cette liste : télécharger le consensus, puis bloquer toutes les adresses qu’il contient à la frontière du réseau. Les bridges existent parce que cette liste publique est le point faible. Les adresses des bridges sont distribuées par petits lots, afin qu’aucune requête ne fournisse l’ensemble des adresses.

Une adresse absente de la liste ne suffit pas. L’inspection approfondie des paquets (DPI), qui classe le trafic selon son contenu plutôt que selon son adresse, reconnaît une connexion Tor à la forme de sa négociation TLS (transport layer security). Un censeur qui ne dispose d’aucune liste peut tout de même voir que « cela ressemble à Tor » et bloquer la connexion. Un transport enfichable supprime ce signal. Il encapsule le flux Tor dans autre chose côté client, puis votre bridge le désencapsule.

obfs4 est le transport utilisé par la plupart des bridges. Il transforme le flux en octets sans en-tête ni négociation initiale fixe, de sorte que la DPI ne dispose d’aucun motif à reconnaître. Il authentifie également le client. La valeur cert= présente dans une ligne de bridge est une clé dont le client doit prouver qu’il dispose avant que le bridge ne réponde, ce qui empêche les sondages actifs : un censeur qui se connecte à votre adresse pour vérifier si elle parle Tor n’obtient aucune réponse et n’apprend rien.

Quel transport enfichable devriez-vous utiliser ?

  • obfs4 nécessite un seul VPS, deux ports TCP et aucun nom de domaine. C’est la solution utile la plus simple à mettre en œuvre, et c’est le sujet de ce guide.
  • WebTunnel dissimule la connexion dans du trafic HTTPS ordinaire à destination d’un site web réel. Le projet Tor indique comme prérequis, dans la mesure du possible, une adresse IPv4 statique, un domaine que vous contrôlez, un serveur web opérationnel tel que NGINX ou Apache, un certificat TLS valide, ainsi qu’au moins 1 GB de RAM, avec 4 GB recommandés. Cette solution convient aux réseaux où le trafic à l’apparence aléatoire est lui-même suspect, car un pays qui autorise peu de choses en dehors de la navigation web autorise tout de même le HTTPS.
  • Snowflake correspond à une autre forme de contribution. Des volontaires exécutent des proxies WebRTC à courte durée de vie. Les points d’entrée changent donc constamment et le censeur ne dispose d’aucune adresse stable à bloquer. Vous n’exploitez pas de bridge pour ce transport. Vous exécutez un proxy, qui ne nécessite aucune adresse fixe.

Commencez par obfs4. Vous pourrez ajouter ultérieurement un bridge WebTunnel sur une seconde adresse : exécuter les deux sur une seule adresse IP signifie qu’un blocage de cette adresse désactive les deux.

Quel est le coût d’un bridge ?

GraphiqueTor Project published minimum bandwidth, October 2026
Les données de ce graphique
[
  {
    "label": "Bridge, minimum",
    "min_upstream_mbit": 1
  },
  {
    "label": "Guard or middle relay, minimum",
    "min_upstream_mbit": 10
  },
  {
    "label": "Guard or middle relay, recommended",
    "min_upstream_mbit": 16
  }
]

En octobre 2026, le projet Tor demande à un bridge au moins 1 Mbit/s de bande passante montante et descendante. Il demande 10 Mbit/s à un guard ou à un relais intermédiaire, avec 16 Mbit/s recommandé. Il s’agit d’exigences publiées, pas de mesures. Un nouveau bridge reste généralement bien en dessous de son propre minimum pendant plusieurs semaines. La même page d’exigences demande à un relais au moins 100 GByte de trafic sortant par mois. Les offres les moins chères couvrent déjà ce volume. Consultez donc le coût mensuel réel d’un petit VPS avant de choisir une configuration plus importante.

La surface d’abus est limitée. C’est le point que l’on comprend souvent mal. Un bridge est le premier saut. Le trafic qui quitte votre serveur va vers un autre relais Tor, jamais vers un site web choisi par l’utilisateur. Votre adresse IP n’apparaît jamais dans le journal web d’un tiers comme source d’une requête. Les e-mails de plainte que traitent les opérateurs de relais de sortie n’arrivent donc pas ici. Vérifiez malgré tout la politique d’utilisation acceptable de votre fournisseur, car certains hébergeurs traitent tout service Tor comme un cas particulier. Un bridge et un service onion sont opposés sur ce point : un bridge n’est utile que parce que son adresse est accessible et finit par être distribuée, tandis que un service onion v3 sur le même type de VPS peut garder votre IP publique totalement masquée.

Ne convertissez pas un relais public existant en bridge à la même adresse. Pour ce cas, le projet Tor conseille de modifier « l’adresse IP, le nom et l’empreinte », car l’ancienne adresse figure déjà dans le consensus que les censeurs téléchargent. Un bridge qui était un relais public la semaine dernière figure déjà probablement sur une blocklist.

La disponibilité compte davantage que la vitesse. Les exigences applicables aux relais indiquent que « si votre relais ne fonctionne pas plus de 2 heures par jour, son utilité est limitée ». Un bridge est encore plus pénalisé qu’un relais, car un client ne connaît que les lignes de bridge qui lui ont été fournies. Tor Browser en accepte plusieurs, une par ligne. Mais dès qu’elles cessent toutes de répondre, l’utilisateur doit en demander de nouvelles. Un redémarrage déconnecte tous les utilisateurs de votre bridge. Configurez un contrôle de port TCP dans Uptime Kuma sur le port obfs4 afin de savoir le jour où il cesse de répondre.

Installer Tor depuis le dépôt du projet Tor

Les paquets des distributions sont souvent en retard, alors qu’un bridge est un logiciel de sécurité qui doit rester à jour. Ajoutez d’abord le dépôt officiel du projet.

sudo apt update
sudo apt install -y apt-transport-https gnupg wget lsb-release
wget -qO- https://deb.torproject.org/torproject.org/A3C4F0F979CAA22CDBA8F512EE8CBC9E886DDD89.asc | gpg --dearmor | sudo tee /usr/share/keyrings/deb.torproject.org-keyring.gpg >/dev/null

Créez ensuite le fichier de sources. La ligne Suites: doit contenir le nom de code de votre version. Récupérez-le depuis le système au lieu de le saisir de mémoire.

sudo tee /etc/apt/sources.list.d/tor.sources >/dev/null <<EOF
Types: deb deb-src
URIs: https://deb.torproject.org/torproject.org/
Suites: $(lsb_release -cs)
Components: main
Signed-By: /usr/share/keyrings/deb.torproject.org-keyring.gpg
EOF
sudo apt update
sudo apt install -y tor deb.torproject.org-keyring obfs4proxy

Si apt update indique que le dépôt ne contient aucun fichier Release pour votre nom de code, le projet Tor ne prend pas en charge cette version. Supprimez /etc/apt/sources.list.d/tor.sources, exécutez de nouveau sudo apt update, puis installez le paquet tor fourni par votre distribution. Tout le reste est identique.

Le paquet obfs4proxy provient directement de Debian et d’Ubuntu (version 0.0.14 dans Debian 13, en octobre 2026). Vérifiez où le binaire a été installé, car son chemin sera utilisé dans la configuration :

command -v obfs4proxy || command -v lyrebird

Le projet amont a été renommé lyrebird. Un paquet plus récent peut donc installer /usr/bin/lyrebird à la place. Utilisez le chemin affiché par cette commande.

Configuration du pont dans /etc/tor/torrc

BridgeRelay 1
ORPort 8443
ServerTransportPlugin obfs4 exec /usr/bin/obfs4proxy
ServerTransportListenAddr obfs4 0.0.0.0:9443
ExtORPort auto
ContactInfo you@example.com
Nickname PickANickname
BridgeDistribution any

Chacune de ces lignes est associée à un risque d'échec, traitez-les donc une par une.

BridgeRelay 1 indique à tor d'envoyer son descripteur à l'autorité de pont plutôt qu'au consensus public. Cette simple ligne rend le relais non listé.

ORPort est le port Tor réel. Il doit être accessible depuis Internet, car tor le teste et refuse de publier un descripteur tant que ce test n'est pas réussi.

ServerTransportPlugin donne à tor la commande à exécuter. tor démarre obfs4proxy en tant que processus enfant et communique avec lui via un pipe ; obfs4proxy n'a donc pas d'unité de service propre. Il apparaît tout de même dans systemctl status tor@default, listé dans le CGroup de cette unité aux côtés de tor lui-même.

ServerTransportListenAddr fixe le port sur lequel obfs4proxy écoute. Si vous omettez cette ligne, obfs4proxy choisit un port libre au démarrage, puis généralement un autre port après la plupart des redémarrages ; ainsi, chaque ligne de pont que vous avez déjà distribuée pointera vers un port où rien n'écoute. Ces clients recevront une connexion refusée et cesseront d'essayer.

ExtORPort auto ouvre l'extended ORPort, un canal de loopback qu'obfs4proxy utilise pour renvoyer les connexions terminées à tor avec l'adresse du client. Le guide d'installation du Tor Project l'inclut pour chaque pont, car sans lui, le transport ne peut pas transmettre cette adresse à tor.

ContactInfo et Nickname sont tous deux publics. Utilisez une adresse que vous consultez, car c'est par ce biais que le Tor Project vous contacte en cas de pont défectueux, et choisissez un surnom qui ne vous identifie pas si vous préférez rester discret.

BridgeDistribution choisit quel distributeur fournit votre adresse aux utilisateurs. Les valeurs acceptées sont https, email, telegram, settings, none et any. Utilisez any pour un premier pont et laissez le système décider. Utilisez none pour un pont privé que vous distribuez vous-même, ce qui maintient l'adresse totalement hors de la distribution publique.

Pourquoi le choix du port est important

Évitez d’utiliser 9001 pour les deux ports. Le projet Tor le recommande explicitement, car 9001 est l’ORPort traditionnel et les censeurs analysent Internet à sa recherche. Les deux ports doivent également être différents, car tor et obfs4proxy écoutent chacun sur leur propre port.

Le port obfs4 le plus robuste est 443. Le trafic sortant vers 443 est autorisé sur presque tous les réseaux restreints. Un filtre qui laisse passer peu de trafic en dehors des ports web laisse donc généralement passer celui-ci. Le port ne masque pas le protocole : le trafic obfs4 ressemble toujours à des données aléatoires, et non à du HTTPS. Faire ressembler une connexion à un accès web relève de WebTunnel. L’utilisation d’un port inférieur à 1024 nécessite une étape supplémentaire, car obfs4proxy ne s’exécute pas en tant que root :

sudo setcap cap_net_bind_service=+ep /usr/bin/obfs4proxy
sudo systemctl edit tor@.service tor@default.service

Ajoutez ces deux lignes dans chaque éditeur qui s’ouvre :

[Service]
NoNewPrivileges=no

La capability ne suffit pas à elle seule. Le NoNewPrivileges de systemd empêche un processus d’obtenir un privilège que son processus parent ne possédait pas. Une file capability correspond précisément à ce cas. obfs4proxy ne peut donc pas se mettre en écoute sur 443 tant que ce paramètre est activé.

Si vous préférez éviter cette étape, choisissez un port élevé peu remarquable et notez-le. Quel que soit votre choix, ne modifiez plus tard pas le port obfs4. Une ligne de bridge associe l’adresse, le port, l’empreinte et le certificat. Toutes les copies déjà présentes dans le navigateur d’un utilisateur cessent donc de fonctionner dès que le port change.

Ouvrir les ports sur les deux pare-feu

sudo ufw allow 8443/tcp
sudo ufw allow 9443/tcp
sudo ufw status

Les deux ports doivent être ouverts. La plupart des fournisseurs exécutent aussi un second pare-feu dans leur panneau de contrôle, dont ufw n’a pas connaissance. Une règle présente sur le serveur mais absente du panneau crée un bridge qui n’est jamais joignable et ne publie jamais de descripteur. Si l’un de ces deux éléments vous est inconnu, consultez les règles ufw nécessaires sur un VPS neuf et ce qu’est réellement un port en écoute sous Linux. Profitez-en pour sécuriser SSH avec des clés et une configuration sshd renforcée. Un bridge non répertorié sur un serveur où SSH accepte les mots de passe reste un serveur où SSH accepte les mots de passe.

Démarrez-le, puis consultez le journal

sudo systemctl enable --now tor.service
sudo systemctl restart tor.service
sudo journalctl -e -u tor@default

Debian et Ubuntu fournissent deux unités. tor.service est un wrapper léger et tor@default.service est le processus qui effectue le travail. C’est pourquoi journalctl -u tor semble presque vide, alors que le journal recherché se trouve sous tor@default.

Deux lignes indiquent que tout a fonctionné :

Self-testing indicates your ORPort is reachable from the outside. Excellent. Publishing server descriptor.
Registered server transport 'obfs4' at '0.0.0.0:9443'

La première signifie que le test d’accessibilité a réussi et que le descripteur a été transmis à l’autorité du bridge. Si elle n’apparaît jamais, un élément entre Internet et votre serveur bloque le trafic vers l’ORPort. La deuxième ligne doit afficher le port que vous avez configuré. Si elle affiche un autre port, tor n’a jamais appliqué ServerTransportListenAddr. La cause habituelle est un nom de transport différent : il doit être obfs4 dans les deux directives.

Vérifiez que les deux listeners existent :

sudo ss -lntp | grep -E 'tor|obfs4|lyrebird'

Où se trouve ma ligne de bridge ?

obfs4proxy écrit un modèle dans le répertoire de données de tor :

sudo cat /var/lib/tor/pt_state/obfs4_bridgeline.txt

Ce répertoire appartient à l’utilisateur tor et ses permissions sont définies à 700. Sans sudo, vous obtenez donc Permission denied. Le fichier contient une ligne de cette forme :

Bridge obfs4 <IP ADDRESS>:<PORT> <FINGERPRINT> cert=<CERTIFICATE> iat-mode=0

Remplacez <IP ADDRESS> par l’adresse publique de votre serveur, <PORT> par le port obfs4 et non par l’ORPort, et <FINGERPRINT> par l’empreinte d’identité que tor a écrite dans son répertoire de données :

sudo cat /var/lib/tor/fingerprint
sudo cat /var/lib/tor/hashed-fingerprint

Le premier fichier contient votre pseudonyme et l’empreinte d’identité à placer dans une ligne de bridge. Le second contient l’empreinte hachée. C’est cette valeur que vous collez dans Relay Search pour vérifier que votre bridge fonctionne et obtenir une estimation du nombre de clients qui l’atteignent. Ces deux valeurs ne sont pas interchangeables. Une ligne de bridge contenant la valeur hachée ne correspond pas à la clé d’identité présentée par votre bridge. Le client rejette donc la connexion qu’il vient d’ouvrir.

Comment un bridge atteint-il réellement les utilisateurs ?

Vous ne transmettez pas vous-même la ligne de votre bridge à qui que ce soit. Une fois la description reçue par l’autorité des bridges, le système de distribution (rdsys, le successeur de BridgeDB) attribue votre bridge à un distributeur, puis les utilisateurs demandent des bridges à ce distributeur. En octobre 2026, les canaux sont les suivants :

  • Le site des bridges à l’adresse bridges.torproject.org/options, où « Just give me bridges! » renvoie immédiatement des lignes obfs4. Il n’y a pas de captcha : le Tor Project l’a supprimé lorsque rdsys a remplacé BridgeDB, changement annoncé en décembre 2024.
  • Un e-mail envoyé à bridges@torproject.org depuis une adresse Gmail ou Riseup, qui renvoie des lignes de bridges. Cette restriction sur les fournisseurs existe parce que des comptes gratuits illimités permettraient à un censeur d’énumérer tous les bridges.
  • Le bot Telegram @GetBridgesBot. Envoyez /start, puis /obfs4 ou /webtunnel.
  • Tor Browser lui-même, dans Settings puis Connection, où « Request bridges » les récupère via le canal moat.

Un nouveau bridge apparaît dans Relay Search environ trois heures après sa configuration. Les utilisateurs mettent beaucoup plus de temps à arriver : le Tor Project indique lui-même qu’« il peut falloir plusieurs jours ou semaines avant de voir un ensemble d’utilisateurs stable ». Une faible activité pendant les deux premières semaines est normale. Ce n’est pas un dysfonctionnement.

La configuration de BridgeDistribution none vous exclut de tous ces mécanismes. Vous devez alors transmettre vous-même la ligne du bridge aux personnes qui en ont besoin, via un canal que le censeur ne surveille pas.

En cas de dysfonctionnement

Aucune ligne d’auto-test dans le journal. L’ORPort n’est pas accessible. Testez-la depuis une autre machine avec nc -vz your.ip 8443. Un blocage indique que les paquets sont filtrés. Vérifiez donc ufw et le panneau du fournisseur. Un refus indique que tor n’écoute pas. Vérifiez donc ss -lntp et recherchez une erreur de configuration dans le journal.

Le transport enregistré indique un port que vous n’avez pas choisi. tor a ignoré ServerTransportListenAddr. Le nom du transport doit correspondre exactement à celui de ServerTransportPlugin, et les deux doivent être obfs4.

obfs4proxy ne peut pas se lier au port 443. Vérifiez la capacité avec getcap /usr/bin/obfs4proxy, puis vérifiez que la surcharge a bien été transmise à l’unité avec systemctl show tor@default -p NoNewPrivileges. Si cette commande affiche NoNewPrivileges=yes, votre drop-in a été appliqué à une unité qui n’est pas en cours d’exécution.

Le répertoire /var/lib/tor/pt_state/ est vide. tor n’a jamais démarré le transport. Le chemin indiqué dans ServerTransportPlugin est donc incorrect. Comparez-le avec la sortie de command -v obfs4proxy.

Les clients ne se connectent plus après une modification. Toute modification de l’adresse ou du port obfs4 invalide toutes les lignes de bridge déjà distribuées. Vérifiez également si l’adresse IP publique du serveur a changé. Cela peut arriver après une reconstruction chez certains fournisseurs.

tor ne démarre pas du tout. Exécutez sudo -u debian-tor tor --verify-config -f /etc/tor/torrc. Cette commande analyse le fichier, affiche la ligne concernée et laisse le service en cours d’exécution intact.

FAQ

Mon fournisseur de VPS se plaindra-t-il de l’exécution d’un bridge Tor ?

Un bridge est un point d’entrée. Le trafic qui quitte votre serveur est donc destiné à d’autres relais Tor, et non au site choisi par un utilisateur. Votre adresse IP n’apparaît dans aucun journal web comme source d’une requête. C’est ce qui provoque les plaintes auxquelles les opérateurs de relais de sortie doivent répondre. Les règles d’hébergement varient toutefois. Certains fournisseurs traitent tout service Tor comme un cas particulier. Consultez donc leur politique d’utilisation acceptable avant de commencer, puis saisissez une adresse que vous avez lue dans ContactInfo.

Quelle bande passante un bridge Tor utilise-t-il ?

Le minimum publié est de 1 Mbit/s en montée et en descente, contre 10 Mbit/s pour un relais guard ou middle. L’utilisation réelle commence près de zéro, car votre bridge ne transporte que le trafic des utilisateurs qu’un distributeur lui envoie. Pour imposer une limite stricte, définissez RelayBandwidthRate et RelayBandwidthBurst dans torrc.

Pourquoi personne ne s’est-il connecté à mon nouveau bridge ?

Un bridge met environ trois heures à apparaître dans Relay Search. Selon les recommandations du Tor Project, il faut plusieurs jours ou semaines pour obtenir un ensemble d’utilisateurs régulier. Vérifiez que le descripteur a bien été publié, ce que confirme la ligne d’auto-test dans journalctl -u tor@default. Recherchez votre empreinte hachée dans Relay Search et vérifiez que BridgeDistribution n’est pas défini sur none.

Dois-je exécuter obfs4 ou WebTunnel ?

Exécutez obfs4 s’il s’agit de votre premier bridge : un VPS, deux ports, aucun domaine et aucun certificat. Utilisez WebTunnel lorsque le trafic à l’apparence aléatoire est lui-même bloqué. Il nécessite un domaine que vous contrôlez, un véritable serveur web, un certificat TLS valide et au moins 1 GB de RAM. Utilisez des adresses distinctes si vous exécutez les deux services. Sinon, le blocage d’une seule adresse IP supprimerait deux bridges à la fois.

Que se passe-t-il si je modifie ultérieurement le port obfs4 ?

Toutes les lignes de bridge déjà distribuées cessent de fonctionner. Une ligne de bridge associe l’adresse, le port, l’empreinte et le certificat. Un client qui possède l’ancienne ligne tente donc d’ouvrir une connexion vers un port sur lequel aucun service n’écoute, puis abandonne. Le même problème se produit si l’adresse IP publique du serveur change. Choisissez le port lors de la configuration et ne le modifiez plus.

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