Skip to content

Latest commit

 

History

History
59 lines (39 loc) · 1.4 KB

README.MD

File metadata and controls

59 lines (39 loc) · 1.4 KB

GoTorWeb

This project as has the objective of providing an easy and automatic way of eposing your containers to the Tor network.

Running GoTorWeb

docker run --rm --name gtw  \
    -v /var/run/docker.sock:/var/run/docker.sock  \
    -e "GTW-USERNAME=<auth user>" \
    -e "GTW-PASSWORD=<auth password>" \
    -v <config location>:/config knoker/go_tor_web

Runtime Parameters

  • GTW-USERNAME: web ui username
  • GTW-PASSWORD: web ui password
  • config location: location of the tor generated certificates and hostnames

Finding the web ui

After tor has initialized there will be a file config/local/hostname containning the web ui address, and the following log will appear in the container stdout

------------------------------------
Local: something.onion 80
------------------------------------

Other containers

docker run --rm -it \
    -l "GTW=1" \
    -l "GWT-PORT=8080" \
    -l "GWT-PORT-FW=80"  \
    hashicorp/http-echo -listen=:8080 -text="hello world"

Other containers parameters

  • -l "GTW=1": GoTorWeb enabled

  • -l "GWT-PORT=8080": Internal container port

  • -l "GWT-PORT-FW=80": Tor exposed port

TODO

  • Improve the web ui's current "design"

  • Improve the name discovery routine to run only when a new container is launched and until it's name is discovered

  • Allow disabling the web ui

Feedback and pull requests are apreciated