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

README update and go fmt

Browse source
This commit is contained in:
Serene Han 2016-01-14 16:30:51 -08:00
parent fa9f58c9ab
commit fb304c673c
2 changed files with 33 additions and 24 deletions
Download patch file Download diff file Expand all files Collapse all files

52
README.md
View file

@ -14,6 +14,13 @@ 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 browser proxy (which will soon be the only way) requires copy and
pasting between 3 terminals and a browser tab.
Once a signalling facilitator is implemented
([issue #1](https://github.com/keroserene/snowflake/issues/1))
this will become much simpler to use.
Setting up the client is the same in both cases. Setting up the client is the same in both cases.
Open up three terminals for the **client:** Open up three terminals for the **client:**
@ -22,55 +29,56 @@ cd client/
go build go build
``` ```
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`
Now, to connect directly to a server plugin: ##### -- Via WebRTC Server --
Open up another three terminals for the **server:** To connect directly to a server plugin,
open up another three terminals for the **server:**
``` ```
cd server/ cd server/
go build go build
``` ```
D: tor -f torrc D: `tor -f torrc`
E: cat > signal E: `cat > signal`
F: tail -F snowflake.log F: `tail -F snowflake.log`
Look for the offer in terminal C; copy and paste it into terminal E. - 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. - Copy and paste the answer in terminal F to terminal B.
At this point the tor client should bootstrap to 100%. - At this point the tor client should bootstrap to 100%.
#### Snowflake proxy ##### -- Via Browser Proxy --
Otherwise, to connect through the WebRTC proxy in the browser, build with: To connect through the WebRTC browser proxy, first make sure
coffeescript is installed. Then, build with:
``` ```
cd proxy/ cd proxy/
cake build cake build
``` ```
Then start a local http server in the `proxy/build/` however you wish Then start a local http server in the `proxy/build/` in any way you like.
For instance: For instance:
''' ```
cd build/ cd build/
python -m http.server python -m http.server
''' ```
Open a browser tab to `0.0.0.0:8000/snowflake.html`. Open a browser tab to `0.0.0.0:8000/snowflake.html`.
The page will ask you to input a relay. Input your desired relay address, or nothing/gibberish, which will cause
Input your desired relay address, or input nothing/gibberish which will cause snowflake to just use a default relay.
snowflake to use a default relay.
Look for the offer in terminal C; copy and paste it into the browser. - Look for the offer in terminal C; copy and paste it into the browser.
Copy and paste the answer generated in the browser back to terminal B. - Copy and paste the answer generated in the browser back to terminal B.
Once WebRTC successfully connects, the browser terminal should turn green. - Once WebRTC successfully connects, the browser terminal should turn green.
Shortly after, the tor client should bootstrap to 100%. Shortly after, the tor client should bootstrap to 100%.

1
client/snowflake.go
View file

@ -50,6 +50,7 @@ type webRTCConn struct {
dc *data.Channel dc *data.Channel
recvPipe *io.PipeReader recvPipe *io.PipeReader
} }
var webrtcRemote *webRTCConn var webrtcRemote *webRTCConn
func (c *webRTCConn) Read(b []byte) (int, error) { func (c *webRTCConn) Read(b []byte) (int, error) {