ProxyFlow

Go Platform Telegram

Language: 中文 | English

🚀 功能特性

📦 快速开始

1️⃣ 克隆项目

git clone https://github.com/Rfym21/ProxyFlow.git
cd ProxyFlow

2️⃣ 配置代理列表

# 代理列表文件
# 支持格式:
# HTTP/HTTPS: http://username:password@ip:port
# SOCKS5: socks5://username:password@ip:port
# 空行和以#开头的行将被忽略
# HTTP 代理
http://user1:pass1@192.168.1.100:8080
http://user2:pass2@192.168.1.101:8080
# SOCKS5 代理
socks5://user3:pass3@192.168.1.102:1080
socks5://192.168.1.103:1080

3️⃣ 配置环境变量

# HTTP 代理服务监听端口
PROXY_PORT=8282
# SOCKS5 代理服务监听端口
SOCKS5_PORT=8281
# 代理文件路径
PROXY_FILE=proxy.txt
# 总的最大空闲连接数
MAX_IDLE_CONNS=1000
# 每个主机的最大空闲连接数
MAX_IDLE_CONNS_PER_HOST=100
# 请求超时时间(秒)
REQUEST_TIMEOUT=30
# 代理服务器认证(留空则不需要认证,HTTP和SOCKS5共用)
AUTH_USERNAME=admin
AUTH_PASSWORD=123456

4️⃣ 编译运行

# 安装依赖
go mod tidy
# 编译
go build -o proxyflow ./cmd/proxyflow
# 运行
./proxyflow

5️⃣ 使用代理

📋 配置说明

🐳 Docker 部署

方式一:使用 docker-compose(推荐)

mkdir proxy-flow && cd proxy-flow

cat > proxy.txt << EOF
# 代理列表文件
# 支持 HTTP 和 SOCKS5 代理
http://user1:pass1@proxy1.example.com:8080
socks5://user2:pass2@proxy2.example.com:1080
EOF

version: '3.8'
services:
 proxy-flow:
 image: ghcr.io/rfym21/proxy-flow:latest
 container_name: proxy-flow
 ports:
 - "8282:8282" # HTTP 代理端口
 - "8281:8281" # SOCKS5 代理端口
 volumes:
 - ./proxy.txt:/app/proxy.txt
 environment:
 - PROXY_PORT=8282
 - SOCKS5_PORT=8281
 - PROXY_FILE=proxy.txt
 - MAX_IDLE_CONNS=1000
 - MAX_IDLE_CONNS_PER_HOST=100
 - REQUEST_TIMEOUT=30
 # 认证配置(可选,HTTP和SOCKS5共用)
 - AUTH_USERNAME=
 - AUTH_PASSWORD=
 restart: unless-stopped

# 启动服务
docker compose up -d
# 查看日志
docker compose logs -f proxy-flow
# 停止服务
docker compose down

方式二:直接运行

# 创建代理列表文件
echo "http://user:pass@proxy.example.com:8080" > proxy.txt
# 运行容器
docker run -d \
 --name proxyflow \
 -p 8282:8282 \
 -p 8281:8281 \
 -v $(pwd)/proxy.txt:/app/proxy.txt \
 -e PROXY_PORT=8282 \
 -e SOCKS5_PORT=8281 \
 -e PROXY_FILE=/app/proxy.txt \
 -e MAX_IDLE_CONNS=1000 \
 -e MAX_IDLE_CONNS_PER_HOST=100 \
 -e REQUEST_TIMEOUT=30 \
 -e AUTH_USERNAME= \
 -e AUTH_PASSWORD= \
 --restart unless-stopped \
 ghcr.io/rfym21/proxy-flow:latest

💡 使用示例

cURL 示例

# HTTP 代理 - HTTP 请求
curl -v -x http://127.0.0.1:8282 http://httpbin.org/ip
# HTTP 代理 - HTTPS 请求
curl -v -x http://127.0.0.1:8282 https://httpbin.org/ip
# SOCKS5 代理 - HTTP 请求
curl -v -x socks5://127.0.0.1:8281 http://httpbin.org/ip
# SOCKS5 代理 - HTTPS 请求
curl -v -x socks5://127.0.0.1:8281 https://httpbin.org/ip

🧪 连通性测试

使用方法

# 直接运行
go run scripts/test-proxy.go
# 或编译后运行
go build -o test-proxy scripts/test-proxy.go
./test-proxy
# Windows
go build -o test-proxy.exe scripts/test-proxy.go
test-proxy.exe

🏗️ 项目结构

ProxyFlow/
├── cmd/
│ └── proxyflow/
│ └── main.go # 程序入口点,负责初始化和启动服务
├── internal/ # 内部包,不对外暴露
│ ├── auth/
│ │ └── auth.go # HTTP Basic认证处理
│ ├── client/
│ │ └── client.go # HTTP客户端连接池管理
│ ├── config/
│ │ └── config.go # 环境变量配置加载
│ ├── models/
│ │ └── proxy.go # 代理信息数据结构
│ ├── pool/
│ │ └── pool.go # 代理池轮询管理
│ └── server/
│ └── server.go # TCP代理服务器核心实现
├── scripts/ # 测试工具
│ └── test-proxy.go # Go语言测试工具 (跨平台)
├── docs/
│ └── README.en.md # 英文文档
├── .github/
│ └── workflows/
│ ├── docker-build-push.yml # Docker镜像构建发布
│ └── release.yml # 版本发布流程
├── proxy.txt # 代理列表配置文件
├── .env # 环境变量配置文件
├── docker-compose.yml # Docker Compose部署配置
├── go.mod # Go模块依赖管理
└── README.md # 项目文档