This guide will walk you through the installation, operation, and maintenance of Snowflake proxy on Linux-based systems. Running a Snowflake proxy is an easy way to contribute to the Tor Project's anti-censorship efforts.

1. Install Go

First you will need to install and configure the Go compiler to build the standalone proxy from source code. Veuillez vous connecter en utilisant un compte utilisateur avec les droits sudo ou directement avec root (dans ce dernier cas, omettez la partie sudo dans les commandes suivantes).

Si vous utilisez Ubuntu ou Debian, vous pouvez installer Go en exécutant sudo apt install golang. Si vous utilisez Fedora, Red Hat ou Amazon Linux utilisez sudo yum install golang ou sudo dnf install golang.

You will need Go 1.21 or newer to run the Snowflake proxy. Please check your Go version by using the command go version. Otherwise download Go binary from the official website and follow its installation instructions.

2. Install git and clone Snowflake repository

Second you need the git client to download the Snowflake source code.

Si vous utilisez Ubuntu ou Debian, vous pouvez installer git en exécutant sudo apt install git. Si vous utilisez Fedora, Red Hat ou Amazon Linux utilisez sudo yum install git ou sudo dnf install git. Sinon, consultez la documentation de votre système d'exploitation.

Please execute the following steps with the user account under which the proxy should be executed. N'utilisez pas root.

Il est recommandé de créer un compte snowflake séparé avec des droits restreints sur le système.

Open your terminal and clone the source code:

git clone https://gitlab.torproject.org/tpo/anti-censorship/pluggable-transports/snowflake.git

3. Build Snowflake proxy

After you cloned the repository, you can build Snowflake proxy binary by running the command:

cd snowflake/proxy
go build

4. Run the Snowflake proxy

After your proxy finished to compile, you can run it with the command:

nohup ./proxy &

Note: The command nohup allows the program to run in the background even after the terminal is closed, and & puts the command in the background immediately.

If you want to save the proxy output to a logfile, for example, to see your proxy usage, you can use:

nohup ./proxy >snowflake.log 2>&1 &

5. Make sure the proxy is started after a reboot of the system

Edit your crontab by running the command:

crontab -e

Entrez la ligne suivante (exemple, adaptez les chemins à votre situation)

@reboot nohup /home/snowflake/snowflake/proxy/proxy > /home/snowflake/snowflake/proxy/snowflake.log 2>&1 &

Veuillez vérifier que cela fonctionne en redémarrant le système et en consultant le journal. Note: On some Linux installations this might not work.

6. Keep your Snowflake proxy updated

Pour maintenir votre proxy snowflake à jour, exécutez les commandes suivantes régulièrement (en vous connectant avec le compte utilisateur que vous avez utilisé lors de l'installation du proxy) :

kill -9 $(pidof proxy)
cd snowflake/
git pull
cd proxy
go build
nohup ./proxy >snowflake.log 2>&1 &