Easily expose local services via Tor
- Tunnel traffic via Tor to your locally running service
- Serve static via Tor with a single command
- All-in-one binary for macOS, linux and windows
Note: This software is functional, but in early development. Expect breaking changes till v1.0 is reached.
Download from GitHub releases or from Jitpack.
- java >=17
Serve the specified port via Tor (default is 8080
).
$ ./ngtor.jar http --port=3000
Setting up hidden service 'ngtor_main' for port 3000
✔ Service 'ngtor_main' to 127.0.0.1:3000 activated on: https://0123456789abcdef.onion
Spin up a webserver and serve a demo page via tor.
$ ./ngtor.jar demo
2009-01-03 22:00:10.937 INFO [...] : Starting NgtorApplication v0.1.0-dev
2009-01-03 22:00:12.208 INFO [...] : Starting Tor
2009-01-03 22:00:15.427 INFO [...] : Started NgtorApplication in 6.972 seconds (JVM running for 7.538)
2009-01-03 22:00:15.505 INFO [...] : =================================================
2009-01-03 22:00:15.505 INFO [...] : url: https://0123456789abcdef.onion
2009-01-03 22:00:15.507 INFO [...] : virtual host: 0123456789abcdef.onion
2009-01-03 22:00:15.507 INFO [...] : virtual port: 80
2009-01-03 22:00:15.507 INFO [...] : host: 127.0.0.1
2009-01-03 22:00:15.507 INFO [...] : port: 8080
2009-01-03 22:00:15.507 INFO [...] : directory: /home/tbk/.ngtor/tor-working-dir/ngtor_demo
2009-01-03 22:00:15.507 INFO [...] : -------------------------------------------------
2009-01-03 22:00:15.507 INFO [...] : Or browse to https://0123456789abcdef.onion in Tor Browser, or
2009-01-03 22:00:15.507 INFO [...] : run: `torsocks -p 38155 curl https://0123456789abcdef.onion/index.html -v`
2009-01-03 22:00:15.508 INFO [...] : =================================================
Performs some health checks, e.g. if outbound connection via Tor can be established.
$ ./ngtor.jar check
Check started..
✔ Tor is working.
Check finished after 1.452 s
Print help text.
$ ./ngtor.jar help
Usage: ./ngtor.jar COMMAND [OPTION...]
Command
http serve the specified port
demo spin up a webserver and serve a demo page via tor
check perform system health checks (e.g. tor connection)
version print application version
help print this help text
Examples
./ngtor.jar http # onion url for port 8080 (default) web server
./ngtor.jar http --port=80 # onion url for port 80 web server
Version
0.1.0-dev
./gradlew build -x test
./gradlew -p ngtor/ngtor-app bootRun --args='check'
or
./ngtor/ngtor-app/build/libs/ngtor.jar check
./gradlew test integrationTest
Gradle is used for checksum and signature verification of dependencies.
# write metadata for dependency verification
./gradlew --write-verification-metadata pgp,sha256 --export-keys
See Gradle Userguide: Verifying dependencies for more information.
Checkstyle with adapted google_checks is used for checking Java source code for adherence to a Code Standard.
# check for code standard violations with checkstyle
./gradlew checkstyleMain
SpotBugs is used for static code analysis.
# invoke static code analysis with spotbugs
./gradlew spotbugsMain
All contributions and ideas are always welcome. For any question, bug or feature request, please create an issue. Before you start, please read the contributing guidelines.
See Awesome Tunneling by @anderspitman for other pretty cool tools that might fit your needs.
- Tor: https://www.torproject.org/
- Spring Boot (GitHub): https://github.com/spring-projects/spring-boot
- tor-binary (GitHub): https://github.com/bisq-network/tor-binary
- netlayer (GitHub): https://github.com/bisq-network/netlayer
- tor-spring-boot-starter (GitHub): https://github.com/theborakompanioni/tor-spring-boot-starter
The project is licensed under the Apache License. See LICENSE for details.