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 pont 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 pont.
OR_PORT=X
# Le port obfs4 de votre pont.
PT_PORT=Y
# Votre adresse mail.
EMAIL=Z

Remplacez X par le port OR désiré, Y par le port obfs4 (assurez-vous que les deux ports sont transférés dans votre pare-feu), et Z par votre adresse mail, qui nous permet de vous contacter en cas de problème avec votre pont. Avec votre configuration de pont 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 démarre maintenant votre nouveau pont obfs4.

2. Mettez à niveau votre conteneur

La mise à jour vers la dernière version de notre image est aussi simple que l'extraction de la dernière version de l'image en cours d'exécution :

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 pont (qui comprend son matériel clé) est stocké dans un volume Docker, vous ne perdrez donc pas l'identité de votre pont lors de la mise à niveau vers la dernière image Docker. Si vous utilisez plusieurs ponts sur votre ordinateur, vous devez répéter cette étape pour chaque pont. Nous annoncerons les nouvelles versions des images sur la liste de diffusion tor-dev.

3. Surveillez vos logs

Vous pouvez inspecter les logs de votre pont en exécutant :

docker logs CONTAINER_ID

Pour utiliser votre nouvelle pont dans le navigateur Tor, vous avez besoin de sa "ligne de pont". Voici comment obtenir une ligne de pont :

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 pont, consultez notre section d'aide. Si votre pont 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.