Changes

Page history
Update standalone proxy instructions authored by Cecylia Bocovich's avatar Cecylia Bocovich
Show whitespace changes
Inline Side-by-side
home.md
View page @ cbe42586
...@@ -27,28 +27,23 @@ In a browser where WebRTC is enabled: ...@@ -27,28 +27,23 @@ In a browser where WebRTC is enabled:
1. 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. 1. 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) ### Option 3 (standalone)
0. 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). 1. 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/. You will need Go 1.13+ to run the Snowflake proxy.
```
mkdir -p ~/go/src 2. Clone the [source code](#source-code).
echo "export GOPATH=$HOME/go" >> ~/.bash_profile
source ~/.bash_profile
```
1. Clone the [source code](#source-code) the `src/` directory of your workspace.
``` ```
cd $GOPATH/src
git clone https://git.torproject.org/pluggable-transports/snowflake.git git clone https://git.torproject.org/pluggable-transports/snowflake.git
``` ```
2. Get the dependencies and build the source code. 3. Build the Snowflake proxy.
``` ```
cd snowflake
cd proxy
go get
go build go build
``` ```
3. For our fallback proxy-go instances on snowflake-broker, [we manage proxy-go instances using runit](https://trac.torproject.org/projects/tor/wiki/org/teams/AntiCensorshipTeam/SnowflakeBridgeSurvivalGuide#Standaloneproxy-goinstances). However, a simpler nohup command will also allow you to run an instance in the background. 4. Run the Snowflake proxy.
For our fallback proxy-go instances on snowflake-broker, [we manage proxy-go instances using runit](https://trac.torproject.org/projects/tor/wiki/org/teams/AntiCensorshipTeam/SnowflakeBridgeSurvivalGuide#Standaloneproxy-goinstances). However, a simpler nohup command will also allow you to run an instance in the background.
``` ```
nohup ./proxy & nohup ./proxy &
``` ```
There is now an ansible role to install a Snowflake proxy on Debian [created by Jacobo Nájera](https://lists.torproject.org/pipermail/anti-censorship-team/2021-March/000143.html): https://galaxy.ansible.com/nvjacobo/snowflake
## Source code ## Source code
https://gitweb.torproject.org/pluggable-transports/snowflake.git https://gitweb.torproject.org/pluggable-transports/snowflake.git
... ...
......