Gemini proxy to connect to gemini sites via SOCKS5, e.g. for TOR
Go to file
Alexander e056d9812e write a bit of documentation in the README, remove redundant README.md 2023-08-06 17:26:02 +02:00
src first version, gemini-socks5 proxy 2023-08-06 15:28:14 +02:00
.editorconfig first version, gemini-socks5 proxy 2023-08-06 15:28:14 +02:00
.gitignore first version, gemini-socks5 proxy 2023-08-06 15:28:14 +02:00
LICENSE reformat LICENSE file 2023-08-06 15:30:56 +02:00
README.adoc write a bit of documentation in the README, remove redundant README.md 2023-08-06 17:26:02 +02:00
pom.xml first version, gemini-socks5 proxy 2023-08-06 15:28:14 +02:00

README.adoc

Gemini-socks5-proxy

This application provides a gemini proxy that requests the gemini servers via a SOCKS5 proxy, which can be used for example to access TOR .onion gemini sites.

Building

To build the application you need Java 11 or above and maven 3.3.

To build the program and run it you can do

mvw compile exec:java

To package the application as a runnable jar, you can do

mvw package

The resulting file target/gemini-proxy-1.0.0-SNAPSHOT-fat.jar is a runnable jar without any dependencies and can be run with just java jre installed.

java -jar gemini-proxy-1.0.0-SNAPSHOT-fat.jar

Please note that the program is currently a first shot at the feature, it is lacking most error checking and is probably leaking open fds. It is also not configurable, it accesses localhost:9150 which is usally the TOR proxy, for anything else it has to be recompiled.

For feedback about the program, come by on the irc channel tilde.chat/#gemini or send me a mail at alexlehm/at/gmail.com. A lot more forms of contact can be found on my links page at links.lehmann.cx

Thanks

Obviously this program came into being after the topic of TOR was talked about on the #gemini IRC channel and I found that there was no workable solution for this that did not involve socksifying the application.