mirror of
https://github.com/gnh1201/caterpillar.git
synced 2025-02-07 15:34:59 +00:00
58 lines
1.9 KiB
Markdown
58 lines
1.9 KiB
Markdown
# gnh1201/caterpillar
|
|
Caterpillar - The simple and parasitic web debugging proxy
|
|
|
|
## How to works
|
|
```
|
|
You <-> Proxy client (Python) <-> Server-side scripting file (Optional, e.g. PHP) <-> On the Web
|
|
```
|
|
|
|
Build a simple web debugging proxy on the shared servers!
|
|
|
|
## Before to use
|
|
If you have an ***will be parasitize*** server that you want to proxy, you can install the `index.php` file.
|
|
|
|
## How to use
|
|
1. Write a file `.env`(Linux) or `settings.ini`(Windows). Like this:
|
|
|
|
```
|
|
[settings]
|
|
PORT=5555
|
|
SERVER_URL=http://example.org
|
|
CA_KEY=ca.key
|
|
CA_CERT=ca.crt
|
|
CERT_KEY=cert.key
|
|
CERT_DIR=certs/
|
|
OPENSSL_BINPATH=openssl
|
|
CLIENT_ENCODING=utf-8
|
|
LOCAL_DOMAIN=example.org
|
|
PROXY_PASS=http://127.0.0.1:3000
|
|
USER_TOKEN=
|
|
```
|
|
|
|
1.1. (Optional) Install RootCA
|
|
```bash
|
|
sudo apt-get install -y ca-certificates
|
|
sudo cp ca.crt /usr/local/share/ca-certificates/caterpillar-ca.crt
|
|
sudo update-ca-certificates
|
|
```
|
|
|
|
2. Run `python3 server.py` and set HTTP(S) proxy in your web browser (e.g. Firefox)
|
|
|
|
3. Test [100MB](http://speed.hetzner.de/100MB.bin)/[SSL](https://speed.hetzner.de/100MB.bin), [1GB](http://speed.hetzner.de/1GB.bin)/[SSL](https://speed.hetzner.de/1GB.bin), [10GB](http://speed.hetzner.de/10GB.bin)/[SSL](http://speed.hetzner.de/10GB.bin) download and check the speed (e.g. https://speed.hetzner.de/1GB.bin)
|
|
|
|
3. Enjoy it
|
|
|
|
4. (Optional) With [Cloudflare](https://cloudflare.com), we can expect to accelerate the 4x speed and reduce the network stuck.
|
|
|
|
## (Optional) For Mastodon users
|
|
1. In `[php-httpproxy installed directory]/settings.ini` or `.env`, set `SERVER_URL` variable to `localhost` in `.env` (e.g. `SERVER_URL=localhost`)
|
|
2. In `[mastodon installed directory]/env.production`, set `http_proxy` variable to `http://localhost:5555` (e.g. `http_proxy=http://localhost:5555`)
|
|
|
|
## References
|
|
* https://github.com/anapeksha/python-proxy-server
|
|
* https://github.com/inaz2/proxy2
|
|
|
|
## Contact
|
|
* ActivityPub [@gnh1201@catswords.social](https://catswords.social/@gnh1201)
|
|
* abuse@catswords.net
|