HTTP Telescope
Debug HTTP requests using a reverse proxy.
Description
This is a simple single-host reverse proxy that intercept and save HTTP requests and responses (including plaintext bodies) in memory. It has a minimal web dashboard.
How to build
Clone the repo and issue go build ./cmd/http-telescope or use the docker image enrico204/http-telescope:latest.
Usage
Usage: http-telescope [options] [arguments]
OPTIONS
--config-path/$CFG_CONFIG_PATH
(default: /conf/config.yml)
--web-listen/$CFG_WEB_LISTEN
(default: 0.0.0.0:3001)
--web-ui/$CFG_WEB_UI
(default: 0.0.0.0:3002)
--web-read-timeout/$CFG_WEB_READ_TIMEOUT
(default: 5s)
--web-write-timeout/$CFG_WEB_WRITE_TIMEOUT
(default: 5s) --web-shutdown-timeout/$CFG_WEB_SHUTDOWN_TIMEOUT
(default: 5s) --web-upstream/$CFG_WEB_UPSTREAM
--log-level/$CFG_LOG_LEVEL
(default: warn) --log-method-name/$CFG_LOG_METHOD_NAME
(default: false) --log-json/$CFG_LOG_JSON
(default: false) --log-destination/$CFG_LOG_DESTINATION
(default: stderr) --log-file/$CFG_LOG_FILE
(default: /tmp/debug.log) --disable-caching/$CFG_DISABLE_CACHING
(default: false) --store-body/$CFG_STORE_BODY
(default: false) --help/-h display this help message
--web-listen/$CFG_WEB_LISTENis the listen address for the reverse proxy--web-ui/$CFG_WEB_UIis the listen address for the web UI--web-upstream/$CFG_WEB_UPSTREAMis the web upstream--store-body/$CFG_STORE_BODYflag controls whetherhttp-telescopeneed to capture the body or not. Note that the body is stored only if all of these are true:- it's plaintext (e.g.,
text/*, JSON/XML or URL-form encoded mime types) Content-Lengthheader is available (notably, in HTTP/2 is optional)- content length is less than 10KiB
- it's plaintext (e.g.,
Example usage
http-telescope --web-upstream http://www.myserver.com
License
This project is licensed under the MIT license. See LICENSE file.
