From 33dd48d4b494ee166570a3e660a972ff8f03740a Mon Sep 17 00:00:00 2001 From: tianrking Date: Fri, 20 Mar 2026 13:38:52 +0800 Subject: [PATCH] docs: split english/chinese readmes and clarify linux support scope --- README.md | 777 ++++++------------------------------------------ README.zh-CN.md | 144 +++++++++ 2 files changed, 231 insertions(+), 690 deletions(-) create mode 100644 README.zh-CN.md diff --git a/README.md b/README.md index 3e0accd..bf3f3c2 100644 --- a/README.md +++ b/README.md @@ -1,241 +1,115 @@ -# proxychains-rs +# proxychains-rs -[![Rust](https://img.shields.io/badge/rust-1.70%2B-orange.svg)](https://www.rust-lang.org/) -[![License](https://img.shields.io/badge/license-GPL%2.0-blue.svg)](LICENSE) +English | [简体中文](README.zh-CN.md) -A modern Rust implementation of the classic proxychains tool, providing elegant and powerful proxy chaining capabilities with cross-platform support. +A modern Rust implementation of classic `proxychains4`, with cross-platform process-level proxy chaining: +- Linux: `LD_PRELOAD` +- macOS: `DYLD_INSERT_LIBRARIES` +- Windows: DLL injection + Winsock API hooks -## Quick Start +## Current Status + +| Platform | Runtime mechanism | Status | +|---|---|---| +| Linux | `LD_PRELOAD` | Stable | +| macOS | `DYLD_INSERT_LIBRARIES` | Stable | +| Windows | DLL injection + MinHook | Beta (production-usable, still expanding edge-case coverage) | + +## Linux Compatibility (Important) + +`proxychains-rs` works on mainstream Linux distributions, but "all Linux versions perfectly" is not a realistic claim. + +What is supported now: +- Mainstream glibc-based distros on `x86_64` (Ubuntu, Debian, Fedora, RHEL-like) +- Dynamic-linked applications that use libc/Winsock-equivalent socket APIs + +What is not guaranteed: +- Very old distributions / very old glibc +- `musl` environments (for example Alpine) without extra validation +- Statically linked networking stacks that bypass hookable libc entry points + +Recommendation: +- Treat Ubuntu/Debian/Fedora/RHEL-like modern releases as primary supported targets. +- If you need strict enterprise guarantee, run CI in your exact distro matrix. + +## Key Features + +- Proxy protocols: `socks5`, `socks4`/`socks4a`, `http`, `raw` +- Chain modes: `dynamic_chain`, `strict_chain`, `random_chain`, `load_balance`, `failover` +- Proxy groups: `[ProxyList:]` + `--group` +- Discovery/validation: + - `--list-groups` + - `--check` +- DNS: + - `proxy_dns` + - compatibility aliases: `proxy_dns_old`, `proxy_dns_daemon` + - fake-IP mapping with reverse mapping support +- Compatibility aliases: + - `round_robin_chain` -> `load_balance` +- IPv6 progress: + - IPv6 targets supported through SOCKS5/HTTP hops + - SOCKS4/4a does not support IPv6 targets + +## Build + +Prerequisites: +- Rust 1.70+ +- Cargo + +Build and test: ```bash -# 1. Build -cargo build --release - -# 2. Create config file (Linux/macOS) -cp proxychains.conf ~/.proxychains/ - -# 3. Run -./target/release/proxychains4 curl https://ifconfig.me +cargo test --workspace --all-targets +cargo build --release --workspace ``` -## Features +## Binaries -- **Multiple Proxy Protocols**: SOCKS4, SOCKS4a, SOCKS5 (with authentication), HTTP CONNECT -- **Chain Modes**: Strict, Dynamic, Random, Load Balance, Failover -- **DNS Handling**: Local resolution, Remote DNS through proxy, Fake IP mapping -- **Cross-platform**: - - Linux (LD_PRELOAD) - - macOS (DYLD_INSERT_LIBRARIES) - - **Windows (DLL Injection + API Hooking)** -- **Thread Safe**: All operations are thread-safe +After build: -## Platform Support - -| Platform | Mechanism | Status | -|----------|-----------|--------| -| Linux | LD_PRELOAD | Stable | -| macOS | DYLD_INSERT_LIBRARIES | Stable | -| Windows | DLL Injection + MinHook | Beta | - ---- - -## How to Compile - -### Prerequisites - -- **Rust 1.70+**: Install from https://rustup.rs -- **Cargo**: Comes with Rust - -#### Platform-specific Requirements - -**Linux:** -```bash -# Ubuntu/Debian -sudo apt install build-essential pkg-config - -# Fedora/RHEL -sudo dnf install gcc pkg-config -``` - -**macOS:** -```bash -xcode-select --install -``` - -**Windows:** -1. Install Visual Studio Build Tools from https://visualstudio.microsoft.com/downloads/ -2. Select "Desktop development with C++" workload -3. Ensure MSVC toolchain is active: - ```powershell - rustup default stable-x86_64-pc-windows-msvc - ``` - -### Build Commands - -```bash -# Clone repository -git clone https://github.com/your-repo/proxychains-rs.git -cd proxychains-rs - -# Debug build (faster compile, larger binary, slower runtime) -cargo build - -# Release build (slower compile, smaller binary, faster runtime) - RECOMMENDED -cargo build --release - -# Run tests -cargo test -``` - -### Build Outputs - -After successful build, you'll find: - -| Platform | CLI Binary | Library | -|----------|------------|---------| +| Platform | CLI | Library | +|---|---|---| | Linux | `target/release/proxychains4` | `target/release/libproxychains.so` | | macOS | `target/release/proxychains4` | `target/release/libproxychains.dylib` | | Windows | `target/release/proxychains4.exe` | `target/release/proxychains.dll` | ---- - -## Installation - -### System-wide Installation - -#### Linux +## Quick Usage ```bash -sudo cp target/release/proxychains4 /usr/local/bin/ -sudo cp target/release/libproxychains.so /usr/local/lib/ -sudo ldconfig -sudo cp proxychains.conf /usr/local/etc/ -``` - -#### macOS - -```bash -sudo cp target/release/proxychains4 /usr/local/bin/ -sudo cp target/release/libproxychains.dylib /usr/local/lib/ -sudo cp proxychains.conf /usr/local/etc/ -``` - -#### Windows - -Copy files to a directory in your PATH: - -```powershell -# Option 1: Copy to Windows directory (requires admin) -copy target\release\proxychains4.exe C:\Windows\ -copy target\release\proxychains.dll C:\Windows\ - -# Option 2: Add build directory to PATH (current session only) -$env:PATH += ";$PWD\target\release" - -# Option 3: Add to user PATH permanently -[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\path\to\proxychains-rs\target\release", "User") -``` - ---- - -## Usage - -### Basic Usage - -```bash -# Linux / macOS +# Linux/macOS proxychains4 curl https://ifconfig.me # Windows proxychains4.exe curl https://ifconfig.me ``` -### Command Line Options - -``` -Usage: proxychains4 [OPTIONS] [ARGS...] - -Options: - -f, --file Configuration file path - --group Proxy group name (uses [ProxyList:]) - --list-groups List available proxy groups and exit - --check Validate config and print selected proxies, then exit - -q, --quiet Quiet mode (suppress output) - -v, --verbose Verbose mode (debug output) - -h, --help Show help - -Examples: - proxychains4 curl https://example.com - proxychains4 -f /path/to/config.conf wget https://example.com - proxychains4 -q firefox -``` - -### Using with Different Programs +Validate config and groups: ```bash -# Web browsers -proxychains4 firefox -proxychains4 chromium - -# Download tools -proxychains4 wget https://example.com/file.zip -proxychains4 curl https://api.ipify.org - -# SSH -proxychains4 ssh user@remote-host - -# Git -proxychains4 git clone https://github.com/repo.git +proxychains4 -f ./proxychains.conf --list-groups +proxychains4 -f ./proxychains.conf --group jp --check ``` ---- - -## Configuration - -### Configuration File Format +## Example Config ```ini -# Chain types: dynamic_chain, strict_chain, random_chain dynamic_chain -# Compatibility alias: round_robin_chain -> load_balance -# round_robin_chain - -# Proxy DNS through the chain (recommended - prevents DNS leaks) proxy_dns -# Compatibility aliases: -# proxy_dns_old -# proxy_dns_daemon 127.0.0.1:1053 - -# Remote DNS subnet for fake IPs (default: 224) remote_dns_subnet 224 - -# Timeouts (milliseconds) tcp_read_time_out 15000 tcp_connect_time_out 8000 max_chain_retries 8 -# Local networks to bypass (CIDR notation) -localnet 127.0.0.0/255.0.0.0 -localnet 192.168.0.0/255.255.0.0 +# compatibility alias examples: +# round_robin_chain +# proxy_dns_old +# proxy_dns_daemon 127.0.0.1:1053 -# Proxy list [ProxyList] -# Format: type host port [user pass] - -# SOCKS5 proxies socks5 127.0.0.1 1080 +# socks4 127.0.0.1 1081 +# http 127.0.0.1 8080 -# SOCKS5 with authentication -socks5 192.168.1.1 1080 username password - -# SOCKS4 proxies -socks4 192.168.1.2 1080 - -# HTTP proxies -http 192.168.1.3 8080 -http 192.168.1.4 8080 user pass - -# Optional grouped lists [ProxyList:jp] socks5 10.0.0.2 1080 @@ -243,505 +117,28 @@ socks5 10.0.0.2 1080 socks5 10.0.0.3 1080 ``` -Group usage example: -```bash -proxychains4 --group jp curl https://ifconfig.me -``` +## DNS and Leak-Prevention Notes -IPv6 notes: -- IPv6 targets are supported through SOCKS5/HTTP proxy hops. -- With `proxy_dns` enabled, hostname lookups avoid system-DNS fallback paths. -- `getaddrinfo(AF_INET6)` is handled via IPv4-mapped fake addresses for compatibility. -- SOCKS4/4a does not support IPv6 target addresses. +- Enable `proxy_dns` to route hostname resolution through proxychains logic. +- In modern code paths, hooks avoid system-DNS fallback in proxy DNS mode. +- As with any hook-based system, test with your target applications (especially unusual runtime/linking models). -Validation and discovery: -```bash -proxychains4 -f ./proxychains.conf --list-groups -proxychains4 -f ./proxychains.conf --group jp --check -``` +## CI / Release ---- - -## Testing & Quality - -Recommended checks before release: - -```bash -cargo fmt --all -- --check -cargo clippy --workspace --all-targets -cargo test --workspace --all-targets -cargo build --release --workspace -``` - -### Configuration File Locations - -The configuration file is searched in the following order: - -**Linux / macOS:** -1. Path specified by `-f` flag -2. `PROXYCHAINS_CONF_FILE` environment variable -3. `./proxychains.conf` -4. `~/.proxychains/proxychains.conf` -5. `/etc/proxychains.conf` -6. `/usr/local/etc/proxychains.conf` - -**Windows:** -1. Path specified by `-f` flag -2. `PROXYCHAINS_CONF_FILE` environment variable -3. `.\proxychains.conf` -4. `%APPDATA%\proxychains\proxychains.conf` -5. `%PROGRAMDATA%\proxychains\proxychains.conf` -6. Same directory as `proxychains4.exe` - -### Quick Setup - -```bash -# Create config directory -mkdir -p ~/.proxychains - -# Copy example config -cp proxychains.conf ~/.proxychains/ - -# Edit with your proxy settings -nano ~/.proxychains/proxychains.conf -``` - ---- - -## Windows Technical Details - -On Windows, proxychains uses a different mechanism compared to Unix systems: - -### How It Works - -1. **DLL Injection**: `proxychains4.exe` creates a new process in suspended state -2. **API Hooking**: Injects `proxychains.dll` which uses MinHook to intercept Winsock2 calls -3. **Hooked Functions**: - - `connect` - - `getaddrinfo` - - `freeaddrinfo` - - `gethostbyname` - - `getnameinfo` - -### Windows Requirements - -- Windows 10 or later -- Visual Studio Build Tools (MSVC toolchain) -- Rust with MSVC target: `rustup target add x86_64-pc-windows-msvc` - -### Windows Limitations - -- May be detected by antivirus software (DLL injection is a common technique) -- Requires same architecture (32-bit process needs 32-bit DLL) -- Some programs may not work if they statically link Winsock -- Admin privileges may be required for some target processes - ---- - -## Project Structure - -``` -proxychains-rs/ -├── proxychains/ # Core library -│ ├── src/ -│ │ ├── config/ # Configuration parsing -│ │ ├── proxy/ # Proxy protocol implementations -│ │ ├── chain/ # Chain management -│ │ ├── dns/ # DNS handling -│ │ ├── hook/ # Platform-specific hooks -│ │ ├── net/ # Network utilities -│ │ └── platform/ # Platform abstraction -├── proxychains-bin/ # CLI binary -├── libproxychains/ # Dynamic library for injection -├── proxychains-injector/ # Windows DLL injection -└── proxychains.conf # Example configuration -``` - ---- +- CI: multi-platform build/test in GitHub Actions +- Release: tagged builds publish assets (Windows zip, Linux tar/deb, macOS tar) ## Troubleshooting -### Common Issues - -**"library not found" error:** -```bash -# Linux -sudo ldconfig -# Or set LD_LIBRARY_PATH -export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib -``` - -**"DLL not found" error (Windows):** -- Ensure `proxychains.dll` is in the same directory as `proxychains4.exe` -- Or copy both to a PATH directory - -**Proxy not working:** -1. Verify your proxy server is running -2. Check configuration file syntax -3. Use `-v` flag for debug output: `proxychains4 -v curl https://ifconfig.me` - -**DNS leaks:** -- Add `proxy_dns` to your configuration file - ---- +- `No proxies configured`: check `[ProxyList]` and `-f` path +- DNS leak concern: ensure `proxy_dns` is enabled +- Windows DLL error: keep `proxychains4.exe` and `proxychains.dll` in same directory +- Linux preload issue: verify dynamic linking and `LD_PRELOAD` behavior ## License GPL-2.0 -## Acknowledgments +## Acknowledgment -This project is a Rust implementation of the original [proxychains-ng](https://github.com/rofl0r/proxychains-ng) project. - ---- ---- - -# proxychains-rs (中文文档) - -[![Rust](https://img.shields.io/badge/rust-1.70%2B-orange.svg)](https://www.rust-lang.org/) -[![License](https://img.shields.io/badge/license-GPL%2.0-blue.svg)](LICENSE) - -经典 proxychains 工具的现代 Rust 实现，提供优雅且强大的代理链功能，支持跨平台。 - -## 快速开始 - -```bash -# 1. 编译 -cargo build --release - -# 2. 创建配置文件 (Linux/macOS) -cp proxychains.conf ~/.proxychains/ - -# 3. 运行 -./target/release/proxychains4 curl https://ifconfig.me -``` - -## 特性 - -- **多种代理协议**: SOCKS4, SOCKS4a, SOCKS5 (带认证), HTTP CONNECT -- **链式模式**: 严格链, 动态链, 随机链, 负载均衡, 故障转移 -- **DNS 处理**: 本地解析, 通过代理的远程 DNS, Fake IP 映射 -- **跨平台支持**: - - Linux (LD_PRELOAD) - - macOS (DYLD_INSERT_LIBRARIES) - - **Windows (DLL 注入 + API Hooking)** -- **线程安全**: 所有操作都是线程安全的 - -## 平台支持 - -| 平台 | 机制 | 状态 | -|------|------|------| -| Linux | LD_PRELOAD | 稳定 | -| macOS | DYLD_INSERT_LIBRARIES | 稳定 | -| Windows | DLL 注入 + MinHook | 测试版 | - ---- - -## 如何编译 - -### 前置要求 - -- **Rust 1.70+**: 从 https://rustup.rs 安装 -- **Cargo**: 随 Rust 一起安装 - -#### 平台特定要求 - -**Linux:** -```bash -# Ubuntu/Debian -sudo apt install build-essential pkg-config - -# Fedora/RHEL -sudo dnf install gcc pkg-config -``` - -**macOS:** -```bash -xcode-select --install -``` - -**Windows:** -1. 从 https://visualstudio.microsoft.com/downloads/ 安装 Visual Studio Build Tools -2. 选择 "Desktop development with C++" 工作负载 -3. 确保 MSVC 工具链已激活: - ```powershell - rustup default stable-x86_64-pc-windows-msvc - ``` - -### 编译命令 - -```bash -# 克隆仓库 -git clone https://github.com/your-repo/proxychains-rs.git -cd proxychains-rs - -# Debug 构建 (编译快，二进制大，运行慢) -cargo build - -# Release 构建 (编译慢，二进制小，运行快) - 推荐 -cargo build --release - -# 运行测试 -cargo test -``` - -### 编译输出 - -编译成功后，你将获得: - -| 平台 | CLI 二进制 | 库文件 | -|------|-----------|--------| -| Linux | `target/release/proxychains4` | `target/release/libproxychains.so` | -| macOS | `target/release/proxychains4` | `target/release/libproxychains.dylib` | -| Windows | `target/release/proxychains4.exe` | `target/release/proxychains.dll` | - ---- - -## 安装 - -### 系统级安装 - -#### Linux - -```bash -sudo cp target/release/proxychains4 /usr/local/bin/ -sudo cp target/release/libproxychains.so /usr/local/lib/ -sudo ldconfig -sudo cp proxychains.conf /usr/local/etc/ -``` - -#### macOS - -```bash -sudo cp target/release/proxychains4 /usr/local/bin/ -sudo cp target/release/libproxychains.dylib /usr/local/lib/ -sudo cp proxychains.conf /usr/local/etc/ -``` - -#### Windows - -将文件复制到 PATH 目录: - -```powershell -# 方法 1: 复制到 Windows 目录 (需要管理员权限) -copy target\release\proxychains4.exe C:\Windows\ -copy target\release\proxychains.dll C:\Windows\ - -# 方法 2: 添加构建目录到 PATH (仅当前会话) -$env:PATH += ";$PWD\target\release" - -# 方法 3: 永久添加到用户 PATH -[Environment]::SetEnvironmentVariable("PATH", $env:PATH + ";C:\path\to\proxychains-rs\target\release", "User") -``` - ---- - -## 使用方法 - -### 基本用法 - -```bash -# Linux / macOS -proxychains4 curl https://ifconfig.me - -# Windows -proxychains4.exe curl https://ifconfig.me -``` - -### 命令行选项 - -``` -用法: proxychains4 [选项] <命令> [参数...] - -选项: - -f, --file <路径> 配置文件路径 - -q, --quiet 静默模式 (抑制输出) - -v, --verbose 详细模式 (调试输出) - -h, --help 显示帮助 - -示例: - proxychains4 curl https://example.com - proxychains4 -f /path/to/config.conf wget https://example.com - proxychains4 -q firefox -``` - -### 与不同程序配合使用 - -```bash -# 网页浏览器 -proxychains4 firefox -proxychains4 chromium - -# 下载工具 -proxychains4 wget https://example.com/file.zip -proxychains4 curl https://api.ipify.org - -# SSH -proxychains4 ssh user@remote-host - -# Git -proxychains4 git clone https://github.com/repo.git -``` - ---- - -## 配置 - -### 配置文件格式 - -```ini -# 链类型: dynamic_chain, strict_chain, random_chain -dynamic_chain - -# 通过代理链代理 DNS (推荐 - 防止 DNS 泄露) -proxy_dns - -# 远程 DNS 子网用于 Fake IP (默认: 224) -remote_dns_subnet 224 - -# 超时设置 (毫秒) -tcp_read_time_out 15000 -tcp_connect_time_out 8000 -max_chain_retries 8 - -# 绕过的本地网络 (CIDR 表示法) -localnet 127.0.0.0/255.0.0.0 -localnet 192.168.0.0/255.255.0.0 - -# 代理列表 -[ProxyList] -# 格式: 类型 主机 端口 [用户名 密码] - -# SOCKS5 代理 -socks5 127.0.0.1 1080 - -# SOCKS5 带认证 -socks5 192.168.1.1 1080 username password - -# SOCKS4 代理 -socks4 192.168.1.2 1080 - -# HTTP 代理 -http 192.168.1.3 8080 -http 192.168.1.4 8080 user pass -``` - -### 配置文件位置 - -配置文件按以下顺序搜索: - -**Linux / macOS:** -1. `-f` 标志指定的路径 -2. `PROXYCHAINS_CONF_FILE` 环境变量 -3. `./proxychains.conf` -4. `~/.proxychains/proxychains.conf` -5. `/etc/proxychains.conf` -6. `/usr/local/etc/proxychains.conf` - -**Windows:** -1. `-f` 标志指定的路径 -2. `PROXYCHAINS_CONF_FILE` 环境变量 -3. `.\proxychains.conf` -4. `%APPDATA%\proxychains\proxychains.conf` -5. `%PROGRAMDATA%\proxychains\proxychains.conf` -6. 与 `proxychains4.exe` 同目录 - -### 快速设置 - -```bash -# 创建配置目录 -mkdir -p ~/.proxychains - -# 复制示例配置 -cp proxychains.conf ~/.proxychains/ - -# 编辑你的代理设置 -nano ~/.proxychains/proxychains.conf -``` - ---- - -## Windows 技术细节 - -在 Windows 上，proxychains 使用与 Unix 系统不同的机制: - -### 工作原理 - -1. **DLL 注入**: `proxychains4.exe` 创建暂停状态的新进程 -2. **API Hooking**: 注入 `proxychains.dll`，使用 MinHook 拦截 Winsock2 调用 -3. **Hook 的函数**: - - `connect` - - `getaddrinfo` - - `freeaddrinfo` - - `gethostbyname` - - `getnameinfo` - -### Windows 要求 - -- Windows 10 或更高版本 -- Visual Studio Build Tools (MSVC 工具链) -- Rust MSVC 目标: `rustup target add x86_64-pc-windows-msvc` - -### Windows 限制 - -- 可能被杀毒软件检测 (DLL 注入是常用技术) -- 需要相同架构 (32 位进程需要 32 位 DLL) -- 静态链接 Winsock 的程序可能无法工作 -- 某些目标进程可能需要管理员权限 - ---- - -## 项目结构 - -``` -proxychains-rs/ -├── proxychains/ # 核心库 -│ ├── src/ -│ │ ├── config/ # 配置解析 -│ │ ├── proxy/ # 代理协议实现 -│ │ ├── chain/ # 链管理 -│ │ ├── dns/ # DNS 处理 -│ │ ├── hook/ # 平台特定钩子 -│ │ ├── net/ # 网络工具 -│ │ └── platform/ # 平台抽象 -├── proxychains-bin/ # CLI 二进制 -├── libproxychains/ # 注入用动态库 -├── proxychains-injector/ # Windows DLL 注入器 -└── proxychains.conf # 示例配置 -``` - ---- - -## 故障排除 - -### 常见问题 - -**"library not found" 错误:** -```bash -# Linux -sudo ldconfig -# 或设置 LD_LIBRARY_PATH -export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/local/lib -``` - -**"DLL not found" 错误 (Windows):** -- 确保 `proxychains.dll` 与 `proxychains4.exe` 在同一目录 -- 或将两者复制到 PATH 目录 - -**代理不工作:** -1. 验证代理服务器正在运行 -2. 检查配置文件语法 -3. 使用 `-v` 标志查看调试输出: `proxychains4 -v curl https://ifconfig.me` - -**DNS 泄露:** -- 在配置文件中添加 `proxy_dns` - ---- - -## 许可证 - -GPL-2.0 - -## 致谢 - -本项目是原始 [proxychains-ng](https://github.com/rofl0r/proxychains-ng) 项目的 Rust 实现。 +Inspired by [proxychains-ng](https://github.com/rofl0r/proxychains-ng). diff --git a/README.zh-CN.md b/README.zh-CN.md new file mode 100644 index 0000000..bc69ce2 --- /dev/null +++ b/README.zh-CN.md @@ -0,0 +1,144 @@ +# proxychains-rs + +[English](README.md) | 简体中文 + +`proxychains-rs` 是经典 `proxychains4` 的现代 Rust 实现，支持跨平台“指定进程走代理链”： +- Linux: `LD_PRELOAD` +- macOS: `DYLD_INSERT_LIBRARIES` +- Windows: DLL 注入 + Winsock API Hook + +## 当前状态 + +| 平台 | 运行机制 | 状态 | +|---|---|---| +| Linux | `LD_PRELOAD` | 稳定 | +| macOS | `DYLD_INSERT_LIBRARIES` | 稳定 | +| Windows | DLL 注入 + MinHook | Beta（已可实用，持续补齐边缘场景） | + +## Linux 支持范围（重要） + +“所有 Linux 版本都完美支持”不现实，当前建议按下面理解： + +已支持： +- 主流 `glibc` 发行版 `x86_64`（Ubuntu / Debian / Fedora / RHEL 系） +- 使用动态链接 libc 套接字接口的应用 + +暂不保证： +- 过旧发行版或过旧 glibc +- `musl` 环境（例如 Alpine）未做完整矩阵验证 +- 静态链接网络栈、绕过可 hook libc 入口的程序 + +建议： +- 把现代 Ubuntu/Debian/Fedora/RHEL-like 作为主支持范围。 +- 若要企业级保证，请在你的目标发行版矩阵上跑 CI 验证。 + +## 核心功能 + +- 代理协议：`socks5`、`socks4`/`socks4a`、`http`、`raw` +- 链路模式：`dynamic_chain`、`strict_chain`、`random_chain`、`load_balance`、`failover` +- 代理分组：`[ProxyList:]` + `--group` +- 配置发现/校验： + - `--list-groups` + - `--check` +- DNS： + - `proxy_dns` + - 兼容别名：`proxy_dns_old`、`proxy_dns_daemon` + - Fake-IP 映射与反查 +- 兼容别名： + - `round_robin_chain` -> `load_balance` +- IPv6 进展： + - IPv6 目标可通过 SOCKS5/HTTP 跳转 + - SOCKS4/4a 不支持 IPv6 目标 + +## 编译 + +前置条件： +- Rust 1.70+ +- Cargo + +构建与测试： + +```bash +cargo test --workspace --all-targets +cargo build --release --workspace +``` + +## 产物 + +构建完成后： + +| 平台 | CLI | 动态库 | +|---|---|---| +| Linux | `target/release/proxychains4` | `target/release/libproxychains.so` | +| macOS | `target/release/proxychains4` | `target/release/libproxychains.dylib` | +| Windows | `target/release/proxychains4.exe` | `target/release/proxychains.dll` | + +## 快速使用 + +```bash +# Linux/macOS +proxychains4 curl https://ifconfig.me + +# Windows +proxychains4.exe curl https://ifconfig.me +``` + +查看分组/校验配置： + +```bash +proxychains4 -f ./proxychains.conf --list-groups +proxychains4 -f ./proxychains.conf --group jp --check +``` + +## 示例配置 + +```ini +dynamic_chain +proxy_dns +remote_dns_subnet 224 +tcp_read_time_out 15000 +tcp_connect_time_out 8000 +max_chain_retries 8 + +# 兼容别名示例： +# round_robin_chain +# proxy_dns_old +# proxy_dns_daemon 127.0.0.1:1053 + +[ProxyList] +socks5 127.0.0.1 1080 +# socks4 127.0.0.1 1081 +# http 127.0.0.1 8080 + +[ProxyList:jp] +socks5 10.0.0.2 1080 + +[ProxyList:us] +socks5 10.0.0.3 1080 +``` + +## DNS 与泄漏防护说明 + +- 建议开启 `proxy_dns`。 +- 在当前主路径实现中，`proxy_dns` 模式会尽量避免回退系统 DNS。 +- Hook 方案天然受目标程序运行时/链接模型影响，需对关键目标程序做实测。 + +## CI / Release + +- CI：GitHub Actions 多平台编译测试 +- Release：tag 触发构建并发布资产（Windows zip、Linux tar/deb、macOS tar） + +## 常见问题 + +- `No proxies configured`：检查 `[ProxyList]` 和 `-f` 路径 +- 担心 DNS 泄漏：确认 `proxy_dns` 已开启 +- Windows DLL 报错：保证 `proxychains4.exe` 与 `proxychains.dll` 同目录 +- Linux preload 异常：确认目标程序是动态链接并且支持 `LD_PRELOAD` + +## License + +GPL-2.0 + +## 致谢 + +灵感来源于 [proxychains-ng](https://github.com/rofl0r/proxychains-ng)。