archives/snowflake
2
0
Fork 0
mirror of https://gitlab.torproject.org/tpo/anti-censorship/pluggable-transports/snowflake.git synced 2025-10-13 20:11:19 -04:00
Code Issues Projects Releases Packages Wiki Activity Actions

Simpler instructions now for connecting directly to WebRTC server.

Browse source
This commit is contained in:
David Fifield 2016-01-18 23:07:22 -08:00
parent 5279e32e3e
commit ff5d23b08c
1 changed files with 28 additions and 24 deletions
Download patch file Download diff file Expand all files Collapse all files

52
README.md
View file

@ -14,48 +14,52 @@ There are currently two ways to try this:
- Directly to the go-webrtc server plugin. - Directly to the go-webrtc server plugin.
- Through a browser snowflake proxy. - Through a browser snowflake proxy.
Using the server plugin requires copy and pasting between 6 terminals. Using the server plugin uses an HTTP server that simulates the interaction
that a client would have with a facilitator.
Using the browser proxy (which will soon be the only way) requires copy and Using the browser proxy (which will soon be the only way) requires copy and
pasting between 3 terminals and a browser tab. pasting between 3 terminals and a browser tab.
Once a signalling facilitator is implemented Once a signalling facilitator is implemented
([issue #1](https://github.com/keroserene/snowflake/issues/1)) ([issue #1](https://github.com/keroserene/snowflake/issues/1))
this will become much simpler to use. this will become much simpler to use.
Setting up the client is the same in both cases. ##### -- Via WebRTC Server --
Open up three terminals for the **client:**
Edit server/torrc and add "-http 127.0.0.1:8080" to the end of the
ServerTransportPlugin line:
```
ServerTransportPlugin snowflake exec ./server -http 127.0.0.1:8080
```
```
cd server/
go build
tor -f torrc
```
Edit client/torrc and add "-url http://127.0.0.1:8080" to the end of the
ClientTransportPlugin line:
```
ClientTransportPlugin snowflake exec ./client -url http://127.0.0.1:8080/
```
``` ```
cd client/ cd client/
go build go build
tor -f torrc
``` ```
At this point the tor client should bootstrap to 100%.
##### -- Via Browser Proxy --
Open up three terminals for the **client:**
A: `tor -f torrc SOCKSPort auto` A: `tor -f torrc SOCKSPort auto`
B: `cat > signal` B: `cat > signal`
C: `tail -F snowflake.log` C: `tail -F snowflake.log`
##### -- Via WebRTC Server --
To connect directly to a server plugin,
open up another three terminals for the **server:**
```
cd server/
go build
```
D: `tor -f torrc`
E: `cat > signal`
F: `tail -F snowflake.log`
- Look for the offer in terminal C; copy and paste it into terminal E.
- Copy and paste the answer in terminal F to terminal B.
- At this point the tor client should bootstrap to 100%.
##### -- Via Browser Proxy --
To connect through the WebRTC browser proxy, first make sure To connect through the WebRTC browser proxy, first make sure
coffeescript is installed. Then, build with: coffeescript is installed. Then, build with: