docker-tor-hidden-service/README.md
2016-03-21 23:37:24 +01:00

43 lines
1.2 KiB
Markdown

# docker-tor-hidden-service
Create a tor hidden service with a link
```sh
# run a container with an network application
$ docker run -d --name hello_world tutum/hello_world
# and just link it to this container
$ docker run -ti --link hello_world goldy/tor-hidden-service
```
The .onion url is displayed to stdout at startup.
To keep onion keys, just mount volume `/var/lib/tor/hidden_service/`
```sh
$ docker run -ti --link something --volume /path/to/keys:/var/lib/tor/hidden_service/ goldy/tor-hidden-service
```
Look at the `docker-compose.yml` file to see own to use it.
### Tools
A command line tool `onions` is available in container to get `.onion` url when container is running.
```sh
# Get services
$ docker exec -ti torhiddenproxy_tor_1 onions
hello: vegm3d7q64gutl75.onion
world: b2sflntvdne63amj.onion
# Get json
$ docker exec -ti torhiddenproxy_tor_1 onions --json
{"world": "b2sflntvdne63amj.onion", "hello": "vegm3d7q64gutl75.onion"}
```
### pyentrypoint
This container is using [`pyentrypoint`](https://github.com/cmehay/pyentrypoint) to generate its setup.
If you need to use the legacy version, please checkout to the `legacy` branch or pull `goldy/tor-hidden-service:legacy`.