HTC(1)

💖 NAME 💖

htc — the httptunnel client, bestie. it's giving "tunnel through the internet" energy fr fr 🦋

---

✨ SYNOPSIS ✨

htc [options] host[:port]

---

🎀 DESCRIPTION 🎀

okay so real talk: this manual page is a brief lil rundown of the htc command. short, sweet, gets the job done. 💅

here's the vibe: htc sets up a httptunnel connection to PORT at HOST. and yes the default port is 8888, she has a favorite 🥰

the second a connection is made, I/O gets redirected from whatever source you picked — the one you specified with the --device, --forward-port or --stdin-stdout switch — straight into the tunnel. iconic behavior honestly 🌈

---

💅 OPTIONS 💅

so this program follows the usual GNU command line syntax, with the long options starting with two dashes (`-`). here's the full rundown, no skips, no skips, we don't do skips here:

• -h, --help — shows you a summary of the options. the "help me bestie" button 🫶
• -c, --content-length BYTES — uses HTTP PUT requests of BYTES size. and yes, k, M, and G postfixes are recognized, we love a unit system that eats ✨
• -d, --device DEVICE — uses DEVICE for input and output.
• -F, --forward-port PORT — uses TCP port PORT for input and output.
• -k, --keep-alive SECONDS — sends keepalive bytes every SECONDS seconds. the default is 5. she checks in on you, she's attentive 💖
• -M, --max-connection-age SEC — the maximum time a connection will stay open is SEC seconds. the default is 300. so after that, it's over, periodt ⏳
• -S, --strict-content-length — always writes Content-Length bytes in requests. strict queen 👑
• -A, --proxy-authorization USER:PASSWORD — proxy authorization. yes, in that exact USER:PASSWORD shape.
• -z, --proxy-authorization-file FILE — proxy authorization, but from a FILE this time. shy about typing it out, we get it 🙈
• -B, --proxy-buffer-size BYTES — assumes a proxy buffer size of BYTES bytes. k, M, and G postfixes recognized here too 💫
• -P, --proxy HOSTNAME[:PORT] — uses a HTTP proxy. the default port is 8080. going through a middleman, we love a connector 🌸
• -s, --stdin-stdout — uses stdin/stdout for communication. and heads up, this one implies --no-daemon 🫡
• -T, --timeout TIME — the timeout, in milliseconds, before sending padding to a buffering proxy. milliseconds!! she's precise ⭐
• -U, --user-agent STRING — specifies the User-Agent value in HTTP requests. your lil disguise, your main character introduction 🎭
• -R, --base-uri STRING — specifies a base URI value for all HTTP requests. the default base URI is "/index.html?crap=". yes really. that's the default. we don't question it 💀
• -V, --version — outputs version information and exits. bye bestie 👋
• -w, --no-daemon — don't fork into the background. stay right here in the front with me 🥺

---

🌈 EXAMPLES 🌈

start httptunnel server

hts -F localhost:22 8888

at host REMOTE, set up an httptunnel server to listen on port 8888 and forward to localhost:22. slay 💖

start httptunnel client

htc -F 2222 -P PROXY_ADDRESS:8000 REMOTE_IP:8888

at host LOCAL, set up an httptunnel client to forward localhost:2222 to REMOTE_IP:8888 via a local proxy at PROXY_ADDRESS:8000. look at her go 🔥

or, if using a buffering HTTP proxy

htc -F 2222 -P PROXY_ADDRESS:8000 -B 48K REMOTE_IP:8888

that -B 48K is the whole moment, no cap ✨

now you can connect through the tunnel on host LOCAL

ssh ssh://localhost:2222

and that's it, you're in. tunnel girl summer 🦋

---

🫶 AUTHOR 🫶

this manual page was contributed by Teemu Hukkanen <tjhukkan@iki.fi>, and was originally written for the Debian GNU/Linux system. credit where credit is due, we stan 🌟

---

👀 SEE ALSO 👀

• hts(1)

---

and that's the whole page, bestie 🎀 it lives under htc(1) in the General Commands Manual — that's the manual it belongs to and the title it's filed under, so if you ever need to look it up again, that's your girl. mwah 💋