https://github.com/purplebooth/tor-hidden-service
Simple Tor container to make a service available over tor.
https://github.com/purplebooth/tor-hidden-service
docker hidden-services tor
Last synced: 12 months ago
JSON representation
Simple Tor container to make a service available over tor.
- Host: GitHub
- URL: https://github.com/purplebooth/tor-hidden-service
- Owner: PurpleBooth
- License: mit
- Created: 2017-05-13T21:26:07.000Z (about 9 years ago)
- Default Branch: main
- Last Pushed: 2022-02-03T00:23:55.000Z (over 4 years ago)
- Last Synced: 2024-04-14T23:20:06.814Z (about 2 years ago)
- Topics: docker, hidden-services, tor
- Language: Dockerfile
- Homepage:
- Size: 13.7 KB
- Stars: 8
- Watchers: 2
- Forks: 2
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
- Code of conduct: code_of_conduct.md
Awesome Lists containing this project
README
# Tor Hidden Service Docker Container
Simple container to make a service available over tor. This is not a minimal
container, rather being built onto of Ubuntu bionic so we can use the official
packages and repository for tor.
## Running
```
export PRIVATE_KEY=$(cat private_key)
export HOSTNAME=$(cat hostname)
docker-compose up
```
Then connect to your service through tor. You'll see a hello world message if it
has worked.
Using docker-compose in production probably isn't advisable. You probably want
to use Deis, Kubernetes, Docker Swarm or similar to deploy it for real.
## Environment Variables
* `TOR_PORT=80` Port to expose the service on inside tor
* `SERVICE_URI=your-service:80` URI for tor to connect to the service on
* `HOSTNAME=eesh4eeChiepitee5rai.onion` Your services hostname
* `PRIVATE_KEY=-----BEGIN RSA PRIVATE KEY-----...` The private key. Can be
multiline.
## Parameters
None required.
If you provide any it'll run them, so:
```
$ docker run tor-container echo 1234
1234
```
## Ports
All the magic happens in the tor service, so no ports are exposed.
## License
See [LICENSE.md](LICENSE.md)