Dynamic Proxy Server

English | 中文

---

English

A high-performance SOCKS5/HTTP dynamic proxy server that automatically fetches, health-checks, and rotates through proxy lists.

Features

• 🚀 Multi-source Support: Fetch proxies from multiple URLs simultaneously
• 🔄 Auto Rotation: Round-robin algorithm for automatic proxy switching
• 💪 High Concurrency: Configurable concurrent health checks (default: 200)
• ⚡ Fast Health Check: TLS handshake verification with performance filtering
• 🔧 Flexible Configuration: YAML-based configuration file
• 🌐 Dual Protocol: SOCKS5 and HTTP proxy servers
• 🔒 HTTPS Support: Full CONNECT tunnel support
• 📊 Real-time Progress: Live progress bar during health checks
• 🎯 Smart Filtering: Automatically removes slow and unreliable proxies
• 🔁 Auto Update: Periodic proxy pool refresh (configurable interval)

Quick Start

Download Pre-built Binaries

Download the latest release for your platform:

• Linux (amd64): dynamic-proxy-linux-amd64
• macOS (Intel): dynamic-proxy-darwin-amd64
• macOS (Apple Silicon): dynamic-proxy-darwin-arm64
• Windows: dynamic-proxy.exe

# Linux / macOS
chmod +x dynamic-proxy-linux-amd64
./dynamic-proxy-linux-amd64

# Windows
dynamic-proxy.exe

Build from Source

# Clone the repository
git clone https://github.com/kbykb/dynamic-proxy.git
cd dynamic-proxy

# Download dependencies
go mod download

# Build
go build -o dynamic-proxy

# Run
./dynamic-proxy

Docker Deployment

Using Docker:

# Build the image
docker build -t dynamic-proxy .

# Run the container
docker run -d \
  --name dynamic-proxy \
  -p 1080:1080 \
  -p 8080:8080 \
  -v $(pwd)/config.yaml:/app/config.yaml:ro \
  --restart unless-stopped \
  dynamic-proxy

Using Docker Compose:

# Start the service
docker-compose up -d

# View logs
docker-compose logs -f

# Stop the service
docker-compose down

Docker Configuration:

The Docker image is built using multi-stage builds for minimal size:

• Base image: Alpine Linux
• Includes CA certificates for HTTPS
• Exposes ports 1080 (SOCKS5) and 8080 (HTTP)
• Config file can be mounted as a volume for easy updates

Configuration

Edit config.yaml to customize settings:

# Proxy list URLs (supports multiple sources)
proxy_list_urls:
  - "https://raw.githubusercontent.com/r00tee/Proxy-List/main/Socks5.txt"
  # Add more sources
  # - "https://example.com/proxy-list.txt"

# Health check concurrency (simultaneous tests)
health_check_concurrency: 200

# Update interval (minutes)
update_interval_minutes: 5

# Health check timeout settings
health_check:
  total_timeout_seconds: 8              # Total timeout
  tls_handshake_threshold_seconds: 5    # TLS handshake threshold

# Server ports
ports:
  socks5: ":1080"
  http: ":8080"

Configuration Options

Option	Description	Default
proxy_list_urls	List of proxy source URLs	1 source
health_check_concurrency	Concurrent health checks	200
update_interval_minutes	Proxy pool refresh interval	5 minutes
total_timeout_seconds	Health check total timeout	8 seconds
tls_handshake_threshold_seconds	Max TLS handshake time	5 seconds
ports.socks5	SOCKS5 server port	:1080
ports.http	HTTP proxy server port	:8080

Usage

Command Line

# Test with curl (SOCKS5)
curl --socks5 127.0.0.1:1080 https://api.ipify.org

# Test with curl (HTTP)
curl -x http://127.0.0.1:8080 https://api.ipify.org

Browser Configuration

SOCKS5 Proxy:

• Host: 127.0.0.1
• Port: 1080

HTTP Proxy:

• Host: 127.0.0.1
• Port: 8080

Programming Examples

Python:

import requests

# HTTP Proxy
proxies = {
    'http': 'http://127.0.0.1:8080',
    'https': 'http://127.0.0.1:8080'
}
response = requests.get('https://api.ipify.org', proxies=proxies)
print(response.text)

# SOCKS5 Proxy
proxies = {
    'http': 'socks5://127.0.0.1:1080',
    'https': 'socks5://127.0.0.1:1080'
}
response = requests.get('https://api.ipify.org', proxies=proxies)
print(response.text)

Node.js:

const axios = require('axios');
const { SocksProxyAgent } = require('socks-proxy-agent');

// SOCKS5 Proxy
const agent = new SocksProxyAgent('socks5://127.0.0.1:1080');
axios.get('https://api.ipify.org', { httpAgent: agent, httpsAgent: agent })
  .then(response => console.log(response.data));

// HTTP Proxy
axios.get('https://api.ipify.org', {
  proxy: {
    host: '127.0.0.1',
    port: 8080
  }
}).then(response => console.log(response.data));

How It Works

1. Proxy Fetching: Fetches proxy lists from configured URLs at startup
2. Health Check: Concurrent health checks with TLS handshake verification
3. Proxy Pool: Maintains a pool of healthy, fast proxies
4. Auto Update: Refreshes proxy pool at configured intervals
5. Round-Robin: Distributes requests across proxies using round-robin algorithm
6. Dual Protocol: Serves both SOCKS5 and HTTP proxy protocols

Architecture

┌─────────────────┐
│  Proxy Sources  │
│  (Multiple URLs)│
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Fetch & Merge  │
│  (Deduplication)│
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│ Health Check    │
│ (200 concurrent)│
│ - TCP Connect   │
│ - TLS Handshake │
│ - Speed Filter  │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   Proxy Pool    │
│ (Healthy Only)  │
└────────┬────────┘
         │
    ┌────┴────┐
    ▼         ▼
┌────────┐ ┌────────┐
│SOCKS5  │ │  HTTP  │
│:1080   │ │ :8080  │
└────────┘ └────────┘

Performance

• Concurrent Health Checks: Configurable worker pool (default: 200)
• Lock-free Rotation: Atomic operations for proxy selection
• Minimal Lock Contention: RWMutex for proxy pool updates
• Connection Reuse: HTTP transport connection pooling
• Fast Filtering: Rejects proxies with TLS handshake > 5s

Troubleshooting

Issue: "No available proxies"

• Check network connectivity
• Verify proxy source URLs are accessible
• Wait for health check to complete
• Check firewall settings

Issue: Connection failures

• Proxies may be temporarily unavailable
• Target website may block proxy IPs
• Try multiple requests to use different proxies
• Adjust health_check_concurrency if network is limited

Issue: Slow performance

• Decrease tls_handshake_threshold_seconds to filter slower proxies
• Increase health_check_concurrency for faster updates
• Add more reliable proxy sources

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License

---

中文

高性能的 SOCKS5/HTTP 动态代理服务器，自动从代理列表获取、测活并轮询使用代理。

功能特性

• 🚀 多源支持: 同时从多个URL获取代理
• 🔄 自动轮换: 轮询算法自动切换代理
• 💪 高并发: 可配置的并发健康检查（默认200）
• ⚡ 快速测活: TLS握手验证和性能过滤
• 🔧 灵活配置: 基于YAML的配置文件
• 🌐 双协议: SOCKS5和HTTP代理服务器
• 🔒 HTTPS支持: 完整的CONNECT隧道支持
• 📊 实时进度: 健康检查时的实时进度条
• 🎯 智能过滤: 自动移除慢速和不可靠的代理
• 🔁 自动更新: 定期刷新代理池（可配置间隔）

快速开始

下载预编译版本

下载适合您平台的最新版本：

• Linux (amd64): dynamic-proxy-linux-amd64
• macOS (Intel): dynamic-proxy-darwin-amd64
• macOS (Apple Silicon): dynamic-proxy-darwin-arm64
• Windows: dynamic-proxy.exe

# Linux / macOS
chmod +x dynamic-proxy-linux-amd64
./dynamic-proxy-linux-amd64

# Windows
dynamic-proxy.exe

从源码编译

# 克隆仓库
git clone https://github.com/kbykb/dynamic-proxy.git
cd dynamic-proxy

# 下载依赖
go mod download

# 编译
go build -o dynamic-proxy

# 运行
./dynamic-proxy

Docker 部署

使用 Docker:

# 构建镜像
docker build -t dynamic-proxy .

# 运行容器
docker run -d \
  --name dynamic-proxy \
  -p 1080:1080 \
  -p 8080:8080 \
  -v $(pwd)/config.yaml:/app/config.yaml:ro \
  --restart unless-stopped \
  dynamic-proxy

使用 Docker Compose:

# 启动服务
docker-compose up -d

# 查看日志
docker-compose logs -f

# 停止服务
docker-compose down

Docker 配置说明:

Docker 镜像使用多阶段构建，体积最小化：

• 基础镜像: Alpine Linux
• 包含 CA 证书支持 HTTPS
• 暴露端口 1080 (SOCKS5) 和 8080 (HTTP)
• 配置文件可通过卷挂载，方便更新

配置说明

编辑 config.yaml 自定义设置：

# 代理列表URL（支持多个源）
proxy_list_urls:
  - "https://raw.githubusercontent.com/r00tee/Proxy-List/main/Socks5.txt"
  # 添加更多源
  # - "https://example.com/proxy-list.txt"

# 健康检查并发数（同时测试数量）
health_check_concurrency: 200

# 更新间隔（分钟）
update_interval_minutes: 5

# 健康检查超时设置
health_check:
  total_timeout_seconds: 8              # 总超时时间
  tls_handshake_threshold_seconds: 5    # TLS握手阈值

# 服务器端口
ports:
  socks5: ":1080"
  http: ":8080"

配置选项

选项	说明	默认值
proxy_list_urls	代理源URL列表	1个源
health_check_concurrency	并发健康检查数	200
update_interval_minutes	代理池刷新间隔	5分钟
total_timeout_seconds	健康检查总超时	8秒
tls_handshake_threshold_seconds	最大TLS握手时间	5秒
ports.socks5	SOCKS5服务器端口	:1080
ports.http	HTTP代理服务器端口	:8080

使用方法

命令行

# 使用curl测试（SOCKS5）
curl --socks5 127.0.0.1:1080 https://api.ipify.org

# 使用curl测试（HTTP）
curl -x http://127.0.0.1:8080 https://api.ipify.org

浏览器配置

SOCKS5代理：

• 主机: 127.0.0.1
• 端口: 1080

HTTP代理：

• 主机: 127.0.0.1
• 端口: 8080

编程示例

Python:

import requests

# HTTP代理
proxies = {
    'http': 'http://127.0.0.1:8080',
    'https': 'http://127.0.0.1:8080'
}
response = requests.get('https://api.ipify.org', proxies=proxies)
print(response.text)

# SOCKS5代理
proxies = {
    'http': 'socks5://127.0.0.1:1080',
    'https': 'socks5://127.0.0.1:1080'
}
response = requests.get('https://api.ipify.org', proxies=proxies)
print(response.text)

Node.js:

const axios = require('axios');
const { SocksProxyAgent } = require('socks-proxy-agent');

// SOCKS5代理
const agent = new SocksProxyAgent('socks5://127.0.0.1:1080');
axios.get('https://api.ipify.org', { httpAgent: agent, httpsAgent: agent })
  .then(response => console.log(response.data));

// HTTP代理
axios.get('https://api.ipify.org', {
  proxy: {
    host: '127.0.0.1',
    port: 8080
  }
}).then(response => console.log(response.data));

工作原理

1. 代理获取: 启动时从配置的URL获取代理列表
2. 健康检查: 并发健康检查，包含TLS握手验证
3. 代理池: 维护健康、快速的代理池
4. 自动更新: 按配置间隔刷新代理池
5. 轮询分配: 使用轮询算法分配请求到代理
6. 双协议: 同时提供SOCKS5和HTTP代理协议

架构图

┌─────────────────┐
│   代理源列表    │
│  (支持多个URL)  │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  获取并合并     │
│   (自动去重)    │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│   健康检查      │
│  (200并发)      │
│ - TCP连接       │
│ - TLS握手       │
│ - 速度过滤      │
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│    代理池       │
│  (仅健康代理)   │
└────────┬────────┘
         │
    ┌────┴────┐
    ▼         ▼
┌────────┐ ┌────────┐
│SOCKS5  │ │  HTTP  │
│:1080   │ │ :8080  │
└────────┘ └────────┘

性能特性

• 并发健康检查: 可配置的工作池（默认200）
• 无锁轮换: 原子操作实现代理选择
• 最小锁竞争: 读写锁保护代理池更新
• 连接复用: HTTP传输连接池
• 快速过滤: 拒绝TLS握手>5秒的代理

故障排除

问题："No available proxies"

• 检查网络连接
• 验证代理源URL可访问
• 等待健康检查完成
• 检查防火墙设置

问题：连接失败

• 代理可能暂时不可用
• 目标网站可能屏蔽代理IP
• 尝试多次请求使用不同代理
• 如果网络受限，调整 health_check_concurrency

问题：性能慢

• 降低 tls_handshake_threshold_seconds 过滤慢速代理
• 增加 health_check_concurrency 加快更新
• 添加更可靠的代理源

贡献

欢迎贡献！请随时提交Pull Request。

许可证

MIT License