Skip to main content

​
Flags

FlagTypeDefaultDescription
--portint8080Proxy listen port
--data-dirstring~/.httpmonData directory for CA certs and scripts
--buffer-sizeint10000Max flows in memory
--blockstringComma-separated host patterns to block
--allowstringComma-separated host patterns to allow
--throttlestringThrottle preset: 3g, 4g, wifi
--latencyduration0Added latency per response
--maplocalstringPath to map-local rules JSON file
--install-caboolfalseInstall CA cert and exit (needs sudo)
--versionboolfalsePrint version and exit

​
Usage examples

httpmon                          # Start on default port
httpmon --port 9090              # Custom port
httpmon --block "*.ads.com"      # Block ad hosts
httpmon --allow "api.example.*"  # Only intercept matching
httpmon --throttle 3g            # Simulate 3G
httpmon --throttle wifi --latency 200ms  # WiFi + custom latency
httpmon --maplocal rules.json    # Serve local files
sudo httpmon --install-ca        # Install CA cert
The --block and --allow flags accept wildcard patterns with *. You can combine them to control which hosts the proxy intercepts. The --throttle flag applies bandwidth limits and base latency from the selected preset. Use --latency alongside it to override the preset’s latency value.