init

README.md

@@ -0,0 +1,81 @@
+# 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
+
+