From 66fd8df00607c0c1e2cf32f6277933bc5935f80d Mon Sep 17 00:00:00 2001 From: a4dyn Date: Sat, 5 Dec 2020 16:17:48 +0800 Subject: [PATCH] Update readme --- ORIG-README.md | 84 -------------------------------------------------- README.md | 43 ++++++++++++++++++++++++++ 2 files changed, 43 insertions(+), 84 deletions(-) delete mode 100644 ORIG-README.md create mode 100755 README.md diff --git a/ORIG-README.md b/ORIG-README.md deleted file mode 100644 index b4ff6fc..0000000 --- a/ORIG-README.md +++ /dev/null @@ -1,84 +0,0 @@ -# httprobe - -Take a list of domains and probe for working http and https servers. - -## Install - -``` -▶ go get -u github.com/tomnomnom/httprobe -``` - -## Basic Usage - -httprobe accepts line-delimited domains on `stdin`: - -``` -▶ cat recon/example/domains.txt -example.com -example.edu -example.net -▶ cat recon/example/domains.txt | httprobe -http://example.com -http://example.net -http://example.edu -https://example.com -https://example.edu -https://example.net -``` - -## Extra Probes - -By default httprobe checks for HTTP on port 80 and HTTPS on port 443. You can add additional -probes with the `-p` flag by specifying a protocol and port pair: - -``` -▶ cat domains.txt | httprobe -p http:81 -p https:8443 -``` - -## Concurrency - -You can set the concurrency level with the `-c` flag: - -``` -▶ cat domains.txt | httprobe -c 50 -``` - -## Timeout - -You can change the timeout by using the `-t` flag and specifying a timeout in milliseconds: - -``` -▶ cat domains.txt | httprobe -t 20000 -``` - -## Skipping Default Probes - -If you don't want to probe for HTTP on port 80 or HTTPS on port 443, you can use the -`-s` flag. You'll need to specify the probes you do want using the `-p` flag: - -``` -▶ cat domains.txt | httprobe -s -p https:8443 -``` - -## Prefer HTTPS - -Sometimes you don't care about checking HTTP if HTTPS is working. You can do that with the `--prefer-https` flag: - -``` -▶ cat domains.txt | httprobe --prefer-https -``` - -## Docker - -Build the docker container: - -``` -▶ docker build -t httprobe . -``` - -Run the container, passing the contents of a file into stdin of the process inside the container. `-i` is required to correctly map `stdin` into the container and to the `httprobe` binary. - -``` -▶ cat domains.txt | docker run -i httprobe -``` - diff --git a/README.md b/README.md new file mode 100755 index 0000000..7910a78 --- /dev/null +++ b/README.md @@ -0,0 +1,43 @@ +# httprobe-strengthen + +Take a list of domains and probe for working http and https servers. + +## Introduction +This is a customized version. Based on the original httprobe, several more features are added: +* Supports scan IP segment as input +* SUpports scanning specific ports within the IP / IP segment +* Shows the title of the website (if exists) +* Shows the status code of the respose header +* Shows the content length of the respose data (if exists in reposnse header) +* Shows whether the input ports are open + +## Original Repo: +``` +https://github.com/tomnomnom/hacks +https://github.com/tomnomnom/httprobe +``` + +## Basic Usage + +httprobe accepts line-delimited domains on `stdin`: +``` +echo [IP/IP segment] | ./[httprobe] [variables] +cat [input file] | ./[httprobe] [variables] +./[httprobe] -h +``` + +### Example Usage +``` +echo 8.8.8.8/24 | ./httprobe -p 443,8080 -t 1000 +cat domains.txt | ./httprobe -p 8080 -t 500 -s +``` + +### Output +``` +[ip],[url],[title],[status],[content-length],[port open/not] +``` + +## Others +* If no content-length is found, shows -1 +* **Supports Chinese title**(using gbk for windows env, and utf-8 for mac/linux) +* While using -s, by default the ':80' or ':443' will NOT be scanned \ No newline at end of file