GNUNET-GNS-PROXY(1)

✨ GNUNET-GNS-PROXY(1) ✨

okay bestie, this is the manual page for gnunet-gns-proxy, living in the General Commands Manual section of your terminal. she's a little vintage (iykyk) but she WORKS 💅

🌸 NAME 🌸

gnunet-gns-proxy — run a client-side GNS SOCKS proxy 🧦✨

🦋 SYNOPSIS 🦋

gnunet-gns-proxy [-c FILENAME | --config=FILENAME]
                 [-a AUTHORITY | --authority=AUTHORITY]
                 [-p PORT | --port=PORT] [-h | --help]
                 [-L LOGLEVEL | --loglevel=LOGLEVEL] [-v | --version]

💖 DESCRIPTION 💖

okay so most users are gonna want to run this SOCKS proxy. fr fr. it plays nicely with browsers that support the SOCKS 4a protocol, so if that's your browser, we're so back 🔥

here's the tea: the proxy will perform SSL authentication of GNS names and rewrite GNS enabled HTML content. but to assert the validity of GNS names, a local root CA certificate has to be generated that the proxy then uses. so basically you can't just rawdog this — you need a CA first.

which means: gnunet-gns-proxy-setup-ca should be executed before the first launch of this proxy, OR you can use the --authority switch to point at an appropriate CA certificate that's already trusted by the browser. either way, handle it 💅

🎀 OPTIONS 🎀

• -c FILENAME, --config=FILENAME — use the configuration file FILENAME. that's it, that's the vibe 🗂️
• -a AUTHORITY, --authority=AUTHORITY — path to a PEM CA file that contains the certificate and private key of the CA to use to assert the validity of GNS names. 🔐 the default port is specified in the configuration file for the gns service under "[gns-proxy]": "[gns-proxy]" PROXY_CACERT. yes bestie, it's nested like that, no cap.
• -p PORT, --port=PORT — the port this proxy should listen on. default is 7777. lucky number honestly 🍀
• -h, --help — print short help on options. the classic 🫶
• -L LOGLEVEL, --loglevel=LOGLEVEL — use LOGLEVEL for logging. valid values are DEBUG, INFO, WARNING and ERROR. pick your fighter ⚔️
• -v, --version — print GNUnet version number. she's got receipts 📜

🌈 SEE ALSO 🌈

• gnunet-gns(1)

the full documentation for gnunet is maintained as a Texinfo manual. if the info(1) and gnunet programs are properly installed at your site, the command

info gnunet

should give you access to the complete handbook, and

info gnunet-c-tutorial

will give you access to a tutorial for developers. (devs, this one's for you 🧚)

depending on your installation, this information is also available in gnunet(7) and gnunet-c-tutorial(7).

🙈 BUGS 🙈

report bugs by using https://bugs.gnunet.org or by sending electronic mail to ⟨gnunet-developers@gnu.org⟩. don't be shy, they wanna hear it 💜

not me writing a whole love letter to a SOCKS proxy... anyway, this page came from the Debian crew and it's dated October 25, 2012 — a true vintage icon, still serving looks and TLS. periodt 👑💖