Snowflake is a pluggable transport that proxies traffic through temporary proxies using WebRTC, a peer-to-peer protocol with built-in NAT punching. It aims to work kind of like flash proxy, but without flash proxy's problems with NAT.
Work in progress.
Evaluation at PluggableTransports/SnowFlakeEvaluation.
How to run a Snowflake proxy
Option 1 (addon)
Firstly make sure you have WebRTC enabled. Then you can install this addon for Firefox or this one for Chrome which will let you become a Snowflake proxy. It can also inform you about how many people you have helped in the last 24 hours.
Option 2 (web browser)
In a browser where WebRTC is enabled:
- Go to https://snowflake.torproject.org/embed and toggle the button to opt in to being a proxy. You shouldn't close that page if you want to remain a snowflake bridge.
Option 3 (standalone)
- First you will need to install and configure Go to build the standalone proxy-go code. If you are running Ubuntu or Debian, you can install Go by executing
apt install golang. Otherwise visit https://golang.org/dl/. Once it is installed, set up your workspace and environment variables (more detailed instructions here: https://golang.org/doc/code.html#Workspaces).
mkdir -p ~/go/src echo "export GOPATH=$HOME/go" >> ~/.bash_profile source ~/.bash_profile
- Clone the source code the
src/directory of your workspace.
cd $GOPATH/src git clone https://git.torproject.org/pluggable-transports/snowflake.git
- Get the dependencies and build the source code.
cd snowflake cd proxy go get go build
- For our fallback proxy-go instances on snowflake-broker, we manage proxy-go instances using runit. However, a simpler nohup command will also allow you to run an instance in the background.
nohup ./proxy &
The following should result in a 100% bootstrap over WebRTC:
git clone https://git.torproject.org/pluggable-transports/snowflake.git cd snowflake/client go get go build tor -f torrc
Integration with Tor Browser
Snowflake is included in alpha releases of Tor Browser.
Integration of Snowflake into stable Tor Browser is being tracked at ticket #19001 (closed).
To build from source code, see doc/TorBrowser/Hacking. In the tor-browser-build directory,
make alpha or
make testbuild will result in browsers with included Snowflake.
Notes at Fingerprinting.
There are two ways to file a bug report:
- Request an account at the Tor Project GitLab, then open a new issue in the Snowflake project.
- Edit the public bug-reporting pad of the anti-censorship team.
Please try to be as descriptive as possible with your ticket and if possible include log messages that will help us reproduce the bug.