https://github.com/pyproxytools/pyproxy
Lightweight and fast python web proxy
https://github.com/pyproxytools/pyproxy
http-proxy https-proxy proxy proxy-server python3
Last synced: 6 months ago
JSON representation
Lightweight and fast python web proxy
- Host: GitHub
- URL: https://github.com/pyproxytools/pyproxy
- Owner: pyproxytools
- License: mit
- Created: 2025-03-06T12:49:27.000Z (10 months ago)
- Default Branch: main
- Last Pushed: 2025-06-08T20:41:49.000Z (7 months ago)
- Last Synced: 2025-06-08T21:29:35.757Z (7 months ago)
- Topics: http-proxy, https-proxy, proxy, proxy-server, python3
- Language: Python
- Homepage:
- Size: 1.52 MB
- Stars: 3
- Watchers: 1
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
README
pyproxy
**pyproxy** is a lightweight, fast, and customizable Python-based web proxy server designed to handle both HTTP and HTTPS traffic efficiently. It can be used for various purposes, including web scraping, traffic monitoring, and content filtering.
---
## ⚡ **Features**
| Feature | Supported |
|----------------------------------------------|-----------|
| HTTP & HTTPS | ✅ |
| Web request logging | ✅ |
| Domain & URL blacklist | ✅ |
| SSL inspection | ✅ |
| Custom 403 Forbidden page | ✅ |
| Remote (HTTP) blacklist support | ✅ |
| Shortcut support | ✅ |
| Disable inspection for banking websites | ✅ |
| Custom headers | ✅ |
| Web interface monitoring | ✅ |
| Lightweight Docker image | ✅ |
| Proxy chaining (multi-proxy forwarding) | ✅ |
| IP whitelist with subnet support | ✅ |
## 📦 **Installation**
### Install from package
```bash
pip install pyproxytools
```
### Install from source
```bash
git clone https://github.com/pyproxytools/pyproxy.git
cd pyproxy
pip install -r requirements.txt
```
### Install with Docker
```bash
docker pull ghcr.io/pyproxytools/pyproxy:latest
docker run -d ghcr.io/pyproxytools/pyproxy:latest
```
You can use slim images by adding `-slim` to the end of the tags
### Install with Compose
```bash
wget https://raw.githubusercontent.com/pyproxytools/pyproxy/main/docker-compose.yml
docker-compose up -d
```
## 🚀 **Usage**
### Start the proxy
```bash
python3 -m pyproxy
```
The proxy will be available at: `0.0.0.0:8080`.
The access log will be available at `./logs/access.log`.
## 📚 **Documentation**
If you encounter any problems, or if you want to use the program in a particular way, I advise you to read the [documentation](https://github.com/pyproxytools/pyproxy/wiki).
## 🔧 **To do**
- Support content analysis
- Caching of latest and most searched pages
## 🏎️ **Benchmark**
If you're interested in benchmarking the performance of the proxy or comparing request times with and without a proxy, please refer to the [Benchmark README](benchmark/README.md) for detailed instructions on how to run the benchmarking tests and generate reports.
## 📄 **License**
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
## 🤝 **Contributing**
Contributions are welcome and appreciated! If you'd like to improve this project, feel free to fork the repository and submit a pull request. Whether it's fixing bugs, adding new features, improving documentation, or suggesting enhancements, every bit helps. Please make sure to follow the coding standards and test your changes before submitting. Let's build something great together!
## 📦 Deployment with Ansible
If you want to deploy **pyproxy** automatically to remote servers (via source or Docker), an official [Ansible role](https://github.com/pyproxytools/pyproxy-ansible) is available:
* 🔧 Install from source or run as a Docker container
* 📁 Supports customization of ports, versions, and paths
* 🚀 Easily integrable into your infrastructure or CI/CD pipelines
👉 Check out the [pyproxy-ansible](https://github.com/pyproxytools/pyproxy-ansible) repository for more details and usage instructions.
---