hpct-rtunnel(1)

💖 hpct-rtunnel — HiPerConTracer Reverse Tunnel 💖

okay bestie, come sit with me, this one's from the General Commands Manual pile and it's literally the main character of "let me reach my NAT'ed node from far away" 💅

---

✨ NAME ✨

hpct-rtunnel — HiPerConTracer Reverse Tunnel 🫶

---

✨ SYNOPSIS ✨

hpct-rtunnel [-N | --nodeid -node_id]
             [-R remote_location | --remote remote_location]
             [-C collector | --collector collector]
             [-K ssh_private_key_file | --key ssh_private_key_file]
             [-H ssh_known_hosts_file | --known-hosts ssh_known_hosts_file]
             [-q | --quiet] [-w | --verbose]
hpct-rtunnel [-h | --help]
hpct-rtunnel [-v | --version]

---

✨ DESCRIPTION ✨

So hpct-rtunnel is the HiPerConTracer reverse tunnel script, no cap. What it does is it opens up an SSH tunnel from a node over to a collector, and once that's up, SSH forwarding to the node is possible from port 10000+NodeID on the collector. Truth. 🦋

It's meant to be run with the hpct-rtunnel service so the tunnel just... establishes itself, automatically, from a node that has a NAT'ed IP address, purely for remote maintenance. That's the whole vibe. 🔥

---

✨ ARGUMENTS ✨

these are the arguments you may provide, queen:

• -N | --nodeid -node_id — sets the node ID. It's a number from 1 to 9999. periodt.
• -R remote_location | --remote remote_location — sets the remote data directory on the collector. default is /var/hipercontracer/data. 🎀
• -C collector | --collector collector — says which hostname or address the collector's SSH server lives at. 🌸
• -K ssh_private_key_file | --key ssh_private_key_file — sets the SSH private key file that gets used for authentication. default is /var/hipercontracer/ssh/id_ed25519. 🔑
• -H ssh_known_hosts_file | --known-hosts ssh_known_hosts_file — sets the SSH known hosts file. default is /var/hipercontracer/ssh/known_hosts. 👀
• -q | --quiet — turns status output off. shhh 🤫
• -w | --verbose — turns status output on. tell me everything 🗣️
• -h | --help — prints the command help. bestie behaviour honestly 🫶
• -v | --version — prints the program version. 🏷️

---

✨ EXIT STATUS ✨

the tea: hpct-rtunnel exits with 0 when it goes well, and >0 when there's an error. that's it, that's the whole status report. 💀

---

✨ EXAMPLES ✨

here's how you'd actually run it, copy-paste ready, you're welcome 💖

sudo -u hipercontracer hpct-rtunnel -N 1000 -C 10.44.35.16 --key
        /var/hipercontracer/ssh/id_ed25519 --known-hosts
        /var/hipercontracer/ssh/known_hosts

sudo -u hipercontracer hpct-rtunnel -N 1 -C 10.44.35.16 --key
        /var/hipercontracer/ssh/id_ed25519 --known-hosts
        /var/hipercontracer/ssh/known_hosts

hpct-rtunnel --version

hpct-rtunnel -h

---

✨ NOTES ✨

this program is part of HiPerConTracer, fr fr. The latest version of HiPerConTracer can be found on the HiPerConTracer Homepage at HiPerConTracer Homepage: https://www.nntb.no/~dreibh/hipercontracer/. 🌈

---

✨ AUTHORS ✨

Thomas Dreibholz, Homepage: https://www.nntb.no/~dreibh — ty king 👑

---

and that's the whole page babes 🌸 this one lived in the hpct-rtunnel manual, May 26, 2026 era — go forth, tunnel responsibly, and slay 💅✨