HTPROXY(1)

📦
version 2.4.23 · 6 versions
, in ubuntu questing

✨ HTPROXY 💖

okay bestie, gather round, because htproxy is genuinely one of those little tools that's lowkey iconic once you get it. it's a User Commands kinda situation, and it does exactly one thing but does it so well: it records an HTTP session. that's the whole vibe. 👑

🌸 NAME 🌸

htproxy — record a HTTP session 🎀

🦋 SYNOPSIS 🦋

htproxy [OPTIONS]

that's it. that's the whole thing. no positional args, no drama, just you and your options. 💅

🌈 DESCRIPTION 🌈

okay so here's the tea: htproxy do record a HTTP session as a httest script. ✨

like, you point it at stuff, it watches the traffic go by, and it writes it all down as a httest script for you. it's giving personal assistant but for HTTP. it's giving "not me being a proxy." it's giving main character energy, fr fr. 💖

💜 OPTIONS 💜

  • -v, --version — prints the version number and then dips. exit stage left. 🫶
  • -h, --help — shows you the usage info (this very message, iconic). 🎀
  • -p, --port — the port. yep. that's the whole description. it's the port, bestie. 🦋
  • -d, --dest — the destination file. and heads up, the default file is literally called "file" — no cap, that's the actual default name. 💀
  • -u, --url-filter — a URL filter regex. the default is none, and it works as a blacklist. so if you don't set it, nothing gets filtered out. 🌸
  • -l, --log-level — log level, and it goes from 0-4. pick your volume. 🔥
  • -H, --host-var — the variable name for host. 🎀
  • -P, --port-var — the variable name for port. (yes, capital P, don't mix it up with lowercase -p, iykyk. 🙈)
  • -U, --root-var — the web application root variable name. 👑
  • -A, --host-header-var — the variable name for the host header value. 🌈
  • -t, --socket-tmo — socket timeout in [ms], and the default is 30000 ms. so thirty seconds of patience, then it's over. ⭐
  • -i, --header-file — a file with header text. 🍓
  • -e, --trailer-file — a file with trailer text. 🧚
  • -c, --cookie-prefix — cookie variable prefix, and the default is COOKIE_. 🍪
  • -C, --config — the configuration file. 💅

🎀 EXAMPLE 🎀

here's the moment you've all been waiting for, the example, served fresh:

htproxy -p 8888 -d init -H HOST -P PORT -u "(.*\.png\;.*$)|(.*\.css\;.*$)|(.*\.ico\;.*$)|(.*\.js\;.*$)"

look at her go. 🦋 port 8888, writing to init, host var HOST, port var PORT, and a regex blacklist that skips all your .png, .css, .ico and .js noise. obsessed. 💖

💖 AUTHOR 💖

Written by Christian Liesch. legend behaviour, honestly. 👑

Copyright © 2006 Free Software Foundation, Inc.

This is free software; see the source for copying conditions. There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

okay so that last bit is the serious part and i need you to actually read it: no warranty, not even for merchantability or fitness for a particular purpose. it's free software, the source has the copying conditions. no cap. 😭

and that's the whole page, bestie!! this was htproxy version 2.4.23, from February 2025, living its best life as a User Commands page. go record something slay. 💅✨🫶

📦 where this page comes from