https://github.com/keyweeusr/onser
:whale2: Simple Docker image for Onion Hidden Service (.onion)
https://github.com/keyweeusr/onser
onion onion-address onion-domains onion-service tor tor-hidden-services tor-network
Last synced: about 2 months ago
JSON representation
:whale2: Simple Docker image for Onion Hidden Service (.onion)
- Host: GitHub
- URL: https://github.com/keyweeusr/onser
- Owner: KeyWeeUsr
- License: gpl-3.0
- Created: 2018-09-03T20:28:01.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2018-09-22T12:28:45.000Z (over 6 years ago)
- Last Synced: 2025-03-28T22:32:05.304Z (2 months ago)
- Topics: onion, onion-address, onion-domains, onion-service, tor, tor-hidden-services, tor-network
- Language: Dockerfile
- Homepage: https://hub.docker.com/r/keyweeusr/onser
- Size: 28.3 KB
- Stars: 7
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
# Onser
... or "Onion (Hidden) Service". Onser is a simple Docker image allowing you to
very quickly create an Onion hidden service for the TOR network.
Based on NGINX and latest Tor.
### Run
1. Get [Docker](https://www.docker.com/get-started)
2. Get Tor Browser
[via torproject.org](https://www.torproject.org/download/download-easy.html.en),
[via email](mailto://[email protected]),
[via twitter](https://twitter.com/get_tor)
3. ``git clone https://github.com/KeyWeeUsr/Onser``
4. Put your files into the ``www`` folder
5. Run the ``run.bat`` (Windows) or ``source run.sh`` (MacOS or GNU/Linux)
6. Get your .onion address: ``docker exec -it $(docker ps -q) cat www/hostname``
7. Navigate to the .onion address in the Tor Browser
8. Enjoy
### Multiple services
You can use ``docker-compose.yml`` to run multiple separate onion services with
multiple ``www`` folders set via build argument ``www_folder`` (similarly
``nginx_conf``). See the default compose file.
To build and run the services you need just a single command:
docker-compose up -d
which will build the images and run the containers.
To get the .onion URLs use:
docker-compose exec one cat www/hostname
docker-compose exec two cat www/hostname
docker-compose exec three cat www/hostname
Each service has a separate volume specified in the compose file thus holds
a unique ``private_key`` for the service.
To remove containers, volumes, images, networks use:
docker-compose down --volumes --rmi all
### Default permissions
By default the permissions will be changed during the Docker image build
this way:
* `www` folder permissions to `0700`
(user: rwx, group: ---, others: ---)
* the contents of the `www` folder to `0644`
(user: rw-, group: r--, others: r--).
### Custom permissions
To modify the permissions to your liking you can use this example:
FROM keyweeusr/onser:
USER root
# folder
RUN chmod 0123 /home/onser/www
# folder + files
RUN chmod -R 0123 /home/onser/www
USER onser
### Issues
Sometimes building the Docker image fails due to importing the ``gpg`` keys.
gpg: directory '/root/.gnupg' created
gpg: keybox '/root/.gnupg/pubring.kbx' created
gpg: keyserver receive failed: Cannot assign requested address
### Disclaimer
Made for educational purposes, in my free time, unrelated to any
institution/company/subject/... I was or am in contact with.
### PS
Please do not use it for nasty crap
and/or don't connect me with it if you do anyway.