KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agents #developer-tools #codex #claude-code #mcp #rust #deepseek-harness #typescript #ai-agent #cli

tprox

★ 30 Open GitHub ↗

TProx is a fast reverse proxy path traversal detector and directory bruteforcer.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<h4 align="center">TProx is a fast reverse proxy path traversal detector and directory bruteforcer</h4>

<p align="center">
  <a href="#install">Install</a> •
  <a href="#usage">Usage</a> •
  <a href="#examples">Examples</a> •
  <a href="https://discord.gg/MQWCem5b">Join Discord</a> 
</p>

---

### Install Options

#### From Source

```sh
▶  GO111MODULE=on go get -v  github.com/ethicalhackingplayground/tprox/tprox
```

#### Docker

```sh
▶  git clone https://github.com/ethicalhackingplayground/tprox && cd tprox && docker build -t tprox .
```

---

### Usage

```sh
▶ tprox -h
```

```sh
▶  docker run tprox -h
```

This will display help for the tool. Here are all the switches it supports.

<details>
<summary> 👉 tprox help menu 👈</summary>

```
Usage of ./tprox:
  -c int
        The number of concurrent requests (default 10)
  -check
        Check if a path/folder/file is internal
  -crawl
        crawl the resolved domain while testing for proxy misconfigs
  -depth int
        The crawl depth (default 5)
  -discover
        Discover path/folder/file with already found traversal
  -o string
        Output the results to a file
  -progress
        This flag will allow you to turn on the progress bar
  -regex string
        Filter crawl with regex pattern
  -scope string
        Specify a scope to crawl with in using regexs
  -silent
        Show Silent output
  -test
        Enable/Disable test mode only
  -traverse
        This flag will allow you to turn on traversing
  -w string
        The wordlist to use against a valid endpoint to traverse
```

</details>

### Examples

#### Traversal with Brute

```sh
▶ echo "https://example.com/api/v1" | tprox -w wordlist -traverse
```

#### Traversal with Crawling & Brute

```sh
▶ echo "https://example.com" | tprox -w wordlist -crawl -traverse
```

#### Traversal with Crawling, Regex Match & Brute

```sh
▶ echo "https://example.com" | tprox -w wordlist -crawl -traverse -regex "/api/"
```

#### Traversal With Crawling InScope & Brute

```sh
▶ echo "https://example.com" | tprox -w wordlist -crawl -traverse -regex "/api/" -scope ".*.\.example.com"
```

#### Traversal with Test Only

```sh
▶ echo "https://example.com/api" | tprox -test -traverse
```

#### Check if File is Internal

```sh
▶ echo "https://example.com/api/internalfile.html" | tprox -check
```

#### Discover Content

```sh
▶ echo "https://example.com/api/..%2f" | tprox -discover -progress -w wordlist
```

---

### Changes

- Added some additional flags to help aid finding traversal misconfigurations
- Optimised the crawler
- Added a flag to disable/enable the progress bar
- Fixed the silent flag
- Added check,test & discover flags

### Fixes

- Fixed a crawling bug.
- Fixed a traversal bug, it now only prints internal files & endpoints very low % of false positives.
- Made some optimization fixes.
- Discover content fix, it was not finding content.
- Optimisation fixes.

### Known Fixes

if for some reason the program fails to install or update run:

```sh
sudo rm -r /home/<user-name>/go/pkg/mod/github.com/ethicalhackingplayground/tprox
go clean --modcache
go clean
```

Then try and install it again.

### License

Tprox is distributed under [MIT License](https://github.com/ethicalhackingplayground/tprox/blob/main/LICENSE)

tprox

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README