|
@@ -1,37 +1,21 @@
|
|
|
-# docker: hidden tor .onion service 🐳
|
|
|
+# docker: tor obfs4 bridge 🐳
|
|
|
|
|
|
-repo: https://github.com/fphammerle/docker-onion-service
|
|
|
+ansible port of https://dip.torproject.org/torproject/anti-censorship/docker-obfs4-bridge
|
|
|
|
|
|
-docker hub: https://hub.docker.com/r/fphammerle/onion-service
|
|
|
+## usage
|
|
|
|
|
|
-defaults to creating a [v3](https://trac.torproject.org/projects/tor/wiki/doc/NextGenOnions) service
|
|
|
+select a random `$OR_PORT` and `$PT_PORT`
|
|
|
|
|
|
-## example 1
|
|
|
+(see `/proc/sys/net/ipv4/ip_local_port_range` for range)
|
|
|
|
|
|
```sh
|
|
|
-$ docker run --name onion-service \
|
|
|
- -e VIRTUAL_PORT=80 -e TARGET=1.2.3.4:8080 \
|
|
|
- fphammerle/onion-service
|
|
|
+docker run --name tor_obfs4_bridge \
|
|
|
+ -e OR_PORT=42218 -p 42218:42218 \
|
|
|
+ -e PT_PORT=51804 -p 51804:51804 \
|
|
|
+ -e CONTACT_INFO=admin@optional.com \
|
|
|
+ fphammerle/tor-obfs4-bridge
|
|
|
```
|
|
|
|
|
|
-## example 2
|
|
|
+# further reading
|
|
|
|
|
|
-```sh
|
|
|
-$ docker create --name onion-service \
|
|
|
- --env VERSION=3 \
|
|
|
- --env VIRTUAL_PORT=80 \
|
|
|
- --env TARGET=1.2.3.4:8080 \
|
|
|
- --volume onion-key:/onion-service \
|
|
|
- --restart unless-stopped \
|
|
|
- --cap-drop all --security-opt no-new-privileges \
|
|
|
- fphammerle/onion-service:latest
|
|
|
-
|
|
|
-$ docker start onion-service
|
|
|
-```
|
|
|
-
|
|
|
-## retrieve hostname
|
|
|
-
|
|
|
-```sh
|
|
|
-$ docker exec onion-service cat /onion-service/hostname
|
|
|
-abcdefghijklmnopqrstuvwxyz1234567890abcdefghijklmnopqrst.onion
|
|
|
-```
|
|
|
+https://community.torproject.org/relay/setup/bridge/
|