mumujie/easy_proxies repository overview

⁠EasyProxiesV2

EasyProxiesV2 是一个轻量级、高性能的代理池与订阅管理工具，底层基于 sing-box⁠。 项目内置现代化 Web 管理面板，支持节点健康检查、订阅刷新、流量监控与可视化管理。

⁠❤️ 赞助木木

木木是独立开发者 / 开源爱好者，长期投入开源项目维护与迭代。 如果 EasyProxiesV2 对你有帮助，或者你认可我的工作，欢迎请我喝杯咖啡。你的支持是我持续创造的动力源泉 ⚡

• 赞助地址⁠

⁠✨ 核心特性

• 现代化 Web UI（React + Vite + Tailwind + DaisyUI）
• 前后端一体化（前端静态资源已内嵌到 Go 二进制，单文件即可运行）
• 节点订阅与自动刷新
• 代理池智能调度与故障隔离
• GeoIP 分区路由（可选）
• SQLite 持久化存储运行状态与统计数据

⁠🖼️ 项目预览

⁠🚀 最推荐：直接使用 Release 二进制（Linux / Windows）

你不需要本地安装 Go 和 Node，直接下载发布产物即可使用。

⁠1) 下载文件

从 GitHub Releases 下载这两个文件之一：

• Linux: easy-proxies-linux-amd64
• Windows: easy-proxies-windows-amd64.exe

并同时准备配置文件：

• 将仓库里的 config.example.yaml 复制为 config.yaml
• 按需修改端口、账号密码、订阅链接等

⁠🐧 Linux 使用方法

⁠1) 赋予执行权限

chmod +x ./easy-proxies-linux-amd64

⁠2) 准备配置

cp ./config.example.yaml ./config.yaml

⁠3) 启动程序

./easy-proxies-linux-amd64 --config ./config.yaml

⁠4) 访问管理面板

默认访问地址：

• http://127.0.0.1:9888（本机）
• 或 http://<服务器IP>:9888
• 默认密码：123456

⁠💻 Windows EXE 使用方法

⁠1) 准备文件

把下面两个文件放到同一目录：

• easy-proxies-windows-amd64.exe
• config.yaml（由 config.example.yaml 复制并修改）

⁠2) 启动程序（PowerShell 或 CMD）

.\easy-proxies-windows-amd64.exe --config .\config.yaml

⁠3) 访问管理面板

浏览器打开：

• http://127.0.0.1:9888

⁠⚙️ 配置说明（最小必读）

配置模板见 config.example.yaml，重点关注：

• mode: pool / multi-port / hybrid
• listener: 代理入口监听与认证（新增 listener.protocol: http / socks5 / mixed）
• multi_port: 多端口入口参数（新增 multi_port.protocol: http / socks5 / mixed）
• management.listen: Web 管理面板地址（默认 0.0.0.0:9888）
• management.password: 面板登录密码（为空则不需要登录）
• subscriptions / nodes_file / nodes: 节点来源（三选一或混用）

⁠🧪 从源码构建（开发者）

项目由 Go (1.24+) + Node (22+) 构成。

⁠1) 构建前端

cd frontend
npm ci
npm run build

⁠2) 构建后端

go mod download
go build -tags "with_utls with_quic with_grpc with_wireguard with_gvisor" -o easy-proxies ./cmd/easy_proxies

⁠📦 Docker 部署

⁠1) 准备配置和数据目录

mkdir -p easy-proxies/data
cd easy-proxies
curl -L https://raw.githubusercontent.com/xiamuceer-j/EasyProxiesV2/main/config.example.yaml -o config.yaml

编辑 config.yaml，至少确认代理模式、订阅地址、监听端口及管理密码。默认管理面板监听 0.0.0.0:9888。

⁠2) 拉取镜像

docker pull mumujie/easy_proxies:latest

生产环境建议将 latest 替换为明确的版本标签，避免升级时意外引入不兼容变更。

⁠3) 启动容器

Linux 推荐使用主机网络，可完整支持代理池、多端口及端口自动重分配：

docker run -d \
  --name easy-proxies \
  --restart unless-stopped \
  --network host \
  -v "$(pwd)/config.yaml:/etc/easy-proxies/config.yaml" \
  -v "$(pwd)/data:/etc/easy-proxies/data" \
  mumujie/easy_proxies:latest

如果不能使用主机网络，可以显式映射所需端口：

docker run -d \
  --name easy-proxies \
  --restart unless-stopped \
  -p 2323:2323 \
  -p 9888:9888 \
  -p 24000-24200:24000-24200 \
  -v "$(pwd)/config.yaml:/etc/easy-proxies/config.yaml" \
  -v "$(pwd)/data:/etc/easy-proxies/data" \
  mumujie/easy_proxies:latest

只使用 pool 模式时无需映射 24000-24200；多端口范围应与 config.yaml 中的配置保持一致。

⁠4) 查看状态

docker logs -f easy-proxies

浏览器访问 http://<服务器IP>:9888 打开管理面板。代理池默认入口为 http://<服务器IP>:2323。

⁠5) 更新镜像

docker pull mumujie/easy_proxies:latest
docker rm -f easy-proxies

然后重新执行上面的 docker run 命令。配置文件和运行数据保存在宿主机目录中，重建容器不会丢失。

⁠从源码构建镜像

也可以克隆仓库后使用项目内的 Dockerfile 和 docker-compose.yml 本地构建：

docker compose up -d --build

⁠📁 目录结构简述

• cmd/easy_proxies/: Go 程序入口
• frontend/: 前端源码
• internal/: 后端核心模块
• internal/monitor/assets/: 前端构建产物（会被 Go embed）
• .github/workflows/build-and-release.yml: 自动构建与发布流程

⁠🙏 鸣谢

• 原作者 jasonwong1991/easy_proxies⁠
• 核心代理引擎 sing-box⁠