1. Déployer un conteneur

Nous fournissons un fichier docker-compose qui vous aide à déployer le conteneur. Tout d’abord, téléchargez docker-compose.yml, puis écrivez votre configuration de bridge dans un nouveau fichier, .env, qui se trouve dans le même répertoire que docker-compose.yml. Voici un modèle :

# Le port Tor de votre bridge.
OR_PORT=X
# Le port obfs4 de votre bridge.
PT_PORT=Y
# Votre adresse courriel.
EMAIL=Z

Remplacez X par le port OR désiré, Y par votre port obfs4 (assurez-vous que les deux ports sont redirigés dans votre pare-feu), et Z par votre adresse électronique, qui nous permet de vous contacter en cas de problème avec votre bridge. Avec votre configuration de bridge en place, vous pouvez maintenant déployer le conteneur en exécutant :

docker-compose up -d obfs4-bridge

Cette commande chargera automatiquement votre fichier docker-compose.yml en tenant compte des variables d’environnement dans .env.

Vous devriez maintenant obtenir un résultat similaire à celui qui suit :

Starting docker-obfs4-bridge_obfs4-bridge_1 ... done

Voilà, c’est fait ! Votre conteneur amorce maintenant votre nouveau bridge obfs4.

2. Mettez à niveau votre conteneur

La mise à niveau vers la dernière version de notre image est aussi simple que de récupérer la dernière version de l’image en exécutant :

docker-compose pull obfs4-bridge

Puis redémarrer le conteneur :

docker-compose up -d obfs4-bridge

Notez que le répertoire de données de votre bridge (qui comprend ses clés) est stocké dans un volume Docker, vous ne perdrez donc pas l’identité de votre bridge lors de la mise à niveau vers la dernière image Docker. Si vous utilisez plusieurs bridges sur votre ordinateur, vous devez répéter cette étape pour chaque bridge. Nous annoncerons les nouvelles versions des images sur la liste de diffusion tor-dev.

3. Surveillez vos journaux

Vous pouvez inspecter les journaux de votre bridge en exécutant :

docker logs CONTAINER_ID

Pour utiliser votre nouveau bridge dans le Navigateur Tor, vous avez besoin de sa « ligne de bridge ». Voici comment obtenir votre ligne de bridge :

docker exec CONTAINER_ID get-bridge-line

Cette opération renvoie une chaîne de caractères similaire à la suivante :

obfs4 1.2.3.4:1234 B0E566C9031657EA7ED3FC9D248E8AC4F37635A4 cert=OYWq67L7MDApdJCctUAF7rX8LHvMxvIBPHOoAp0+YXzlQdsxhw6EapaMNwbbGICkpY8CPQ iat-mode=0

Si vous avez des difficultés à configurer votre bridge, consultez notre section d’aide. Si votre bridge fonctionne maintenant, consultez les notes post-installation.

4. Utilisation avancée

Vous pouvez définir des variables torrc supplémentaires dans votre fichier .env en mettant OBFS4_ENABLE_ADDITIONAL_VARIABLES à 1 et en préfixant les options torrc désirées avec OBFS4V_. Par exemple, pour définir l’option AddressDisableIPv6, incluez les lignes suivantes dans votre .env :

OBFS4_ENABLE_ADDITIONAL_VARIABLES=1
OBFS4V_AddressDisableIPv6=1

Vous pouvez télécharger notre modèle .env pour commencer.