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

keep readme up to date

Browse source
This commit is contained in:
Serene Han 2016-03-08 18:23:28 -08:00
parent 39be8403a4
commit d61534b3a0
2 changed files with 16 additions and 12 deletions
Download patch file Download diff file Expand all files Collapse all files

26
README.md
View file

@ -51,8 +51,9 @@ Proxy:
The client uses the following `torrc` options: The client uses the following `torrc` options:
``` ```
ClientTransportPlugin snowflake exec ./client \ ClientTransportPlugin snowflake exec ./client \
--url https://snowflake-reg.appspot.com/ \ -url https://snowflake-reg.appspot.com/ \
--front www.google.com -front www.google.com \
-ice stun:stun.l.google.com:19302
``` ```
Which allows it to speak to the Broker, Which allows it to speak to the Broker,
@ -93,18 +94,21 @@ cd build/
python -m http.server python -m http.server
``` ```
Open a browser tab to `0.0.0.0:8000/snowflake.html`. Then, open a browser tab to `0.0.0.0:8000/snowflake.html`,
which causes you to act as an ephemeral Tor bridge.
TODO: Turn the snowflake proxy into a more deployable badge.
### Appendix ### Appendix
##### -- Testing directly via WebRTC Server -- ##### -- Testing directly via WebRTC Server --
Using the server plugin uses an HTTP server that simulates the interaction Ordinarily, the WebrTC client plugin speaks with a Broker which helps
that a client would have with a broker. match and signal with a browser proxy, which ultimately speaks with a default
Using the browser proxy (which will soon be the only way) requires copy and websocket server.
pasting between 3 terminals and a browser tab.
However, there is a WebRTC server plugin which uses an HTTP server that
simulates the interaction that a client would have with the broker, for
direct testing.
Edit server/torrc and add "-http 127.0.0.1:8080" to the end of the Edit server/torrc and add "-http 127.0.0.1:8080" to the end of the
ServerTransportPlugin line: ServerTransportPlugin line:
@ -124,11 +128,11 @@ ClientTransportPlugin line:
ClientTransportPlugin snowflake exec ./client -url http://127.0.0.1:8080/ ClientTransportPlugin snowflake exec ./client -url http://127.0.0.1:8080/
``` ```
##### -- Via Browser Proxy -- ##### -- Testing Copy-Paste Via Browser Proxy --
Open up three terminals for the **client:** Open up three terminals for the **client:**
A: `tor -f torrc SOCKSPort auto` A: `tor -f torrc-manual SOCKSPort auto`
B: `cat > signal` B: `cat > signal`

2
client/torrc
View file

@ -4,6 +4,6 @@ DataDirectory datadir
ClientTransportPlugin snowflake exec ./client \ ClientTransportPlugin snowflake exec ./client \
-url https://snowflake-reg.appspot.com/ \ -url https://snowflake-reg.appspot.com/ \
-front www.google.com \ -front www.google.com \
-ice stun:stun.l.google.com:19302,stun:s1.taraba.net -ice stun:stun.l.google.com:19302
Bridge snowflake 0.0.3.0:1 Bridge snowflake 0.0.3.0:1