82 lines
1.8 KiB
Markdown
82 lines
1.8 KiB
Markdown
# Firefly Go Proxy
|
|
|
|
A lightweight HTTP/HTTPS proxy server with domain redirection and request blocking capabilities. This tool is designed to help with local development and testing by intercepting and modifying HTTP/HTTPS traffic.
|
|
|
|
## Features
|
|
|
|
- HTTP/HTTPS proxy with MITM support
|
|
- Domain-based request redirection
|
|
- URL pattern blocking
|
|
- Automatic certificate management
|
|
- Cross-platform support (Windows, macOS, Linux)
|
|
- System proxy configuration
|
|
|
|
## Installation
|
|
|
|
### Prerequisites
|
|
|
|
- Go 1.22 or higher
|
|
- Git
|
|
|
|
### Building from source
|
|
|
|
```bash
|
|
cd firefly-go-proxy
|
|
go build
|
|
```
|
|
|
|
## Usage
|
|
|
|
### Basic usage
|
|
|
|
```bash
|
|
./firefly-proxy [flags] //linux|macos
|
|
./firefly-proxy.exe [flags] //windows
|
|
```
|
|
|
|
### Available Flags
|
|
|
|
- `-r`: Redirect target host (default: "127.0.0.1:21000")
|
|
- `-b`: Comma-separated list of blocked ports
|
|
- `-e`: Path to an executable to run with admin privileges
|
|
|
|
### Examples
|
|
|
|
1. Start proxy with default settings:
|
|
```bash
|
|
./firefly-proxy //linux|macos
|
|
./firefly-proxy.exe //windows
|
|
```
|
|
|
|
2. Redirect traffic to a different host:
|
|
```bash
|
|
./firefly-proxy -r 192.168.1.100:8080 //linux|macos
|
|
./firefly-proxy.exe -r 192.168.1.100:8080 //windows
|
|
```
|
|
|
|
3. Block specific ports:
|
|
```bash
|
|
./firefly-proxy -b "80,443,8080" //linux|macos
|
|
./firefly-proxy.exe -b "80,443,8080" //windows
|
|
```
|
|
|
|
4. Run an executable with admin privileges:
|
|
```bash
|
|
./firefly-proxy -e "/path/to/your/executable" //linux|macos
|
|
./firefly-proxy.exe -e "/path/to/your/executable" //windows
|
|
```
|
|
|
|
## How it works
|
|
|
|
The proxy intercepts HTTP/HTTPS traffic and can:
|
|
- Redirect requests based on domain names
|
|
- Block specific URLs or patterns
|
|
- Handle SSL/TLS connections with custom CA certificates
|
|
- Automatically configure system proxy settings
|
|
|
|
## License
|
|
|
|
MIT License
|
|
|
|
|