Skip to content

sjwayrhz/ech-client

Repository files navigation

ECH Workers Manager 构建说明

项目结构

创建以下文件结构:

EchWorkersManager/ ├── EchWorkersManager.csproj ├── Program.cs ├── Form1.cs ├── ech-workers.exe ← 放在项目根目录! ├── app.ico ← 图标文件(可选) └── README.md 

重要:

  • ech-workers.exe 放在项目根目录(与 .csproj 文件同级),编译时会自动嵌入到最终的 exe 文件中
  • app.ico 图标文件放在项目根目录,编译后会显示在:
    • Windows 任务栏
    • 系统托盘
    • exe 文件图标
    • 窗口标题栏

构建步骤

方法1: 使用 Visual Studio 2022

  1. 打开 Visual Studio 2022
  2. 选择 "创建新项目"
  3. 选择 "Windows 窗体应用(.NET)"
  4. 项目名称输入: EchWorkersManager
  5. 框架选择: .NET 10.0
  6. 创建项目后,将提供的三个文件内容替换到对应文件中:
    • Form1.cs (替换整个文件)
    • Program.cs (替换整个文件)
    • EchWorkersManager.csproj (替换整个文件)
  7. Ctrl+Shift+B 或点击 "生成" -> "生成解决方案"
  8. 编译后的 exe 在 bin\Debug\net10.0-windows\bin\Release\net10.0-windows\ 目录

方法2: 使用命令行编译 (需要安装 .NET 10 SDK)

  1. 下载并安装 .NET 10 SDK

  2. 创建项目文件夹并保存文件:

mkdir EchWorkersManager cd EchWorkersManager
  1. 将三个代码文件保存到该文件夹

  2. 编译项目:

dotnet build -c Release
  1. 编译后的 exe 在: bin\Release\net10.0-windows\EchWorkersManager.exe

  2. 或者直接运行:

dotnet run

方法3: 发布独立应用 (不需要安装 .NET 运行时) ⭐推荐⭐

这是推荐的打包方法,生成的 exe 文件可以在没有安装 .NET 10 的电脑上直接运行!

Windows x64 (64位系统)

dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true

Windows x86 (32位系统)

dotnet publish -c Release -r win-x86 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true

Windows ARM64 (Windows 11 ARM 设备)

dotnet publish -c Release -r win-arm64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true

发布后的单文件 exe 在: bin\Release\net10.0-windows\win-x64\publish\EchWorkersManager.exe

特点:

  • ✅ 单个 exe 文件,包含所有依赖
  • ✅ 不需要目标电脑安装 .NET 10
  • ✅ ech-workers.exe 已嵌入,无需额外文件
  • ✅ 直接分发给用户即可使用
  • ✅ 支持 Windows 10/11 (x64/x86/ARM64)
  • ⚠️ 文件体积较大(约 50-70MB)

减小文件体积(可选)

如果想减小 exe 文件大小,可以添加以下参数:

dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true -p:EnableCompressionInSingleFile=true -p:PublishTrimmed=true

这样可以将文件大小压缩到 25-35MB 左右。

使用说明

快速开始(2步即可!)

  1. 选择路由模式:
    • 全局代理: 所有网站走代理
    • 绕过大陆: 国外网站走代理,国内直连(推荐)
    • GFWList: 仅被墙网站走代理
  2. 启动服务: 点击"启动服务" → 自动启动代理并启用系统代理
  3. 开始上网: 打开任何浏览器即可使用代理 ✅

路由模式说明

🌍 全局代理

  • 所有流量都走代理
  • 适合: 需要隐藏真实 IP,全程加密
  • 缺点: 访问国内网站会变慢

🇨🇳 绕过大陆

  • 国外网站走代理,国内网站直连
  • 适合: 日常使用,兼顾速度和访问
  • 推荐: ⭐⭐⭐⭐⭐ 最佳选择
  • 判断规则:
    • .cn 和 .中国 域名直连
    • 中国 IP 段直连
    • 其他走代理

📋 GFWList

  • 被墙网站走代理,其他直连
  • 适合: 节省流量,精准分流
  • 包含: Google, YouTube, Facebook, Twitter, GitHub 等
  • 缺点: 列表可能不完整

停止使用

  • 停止服务: 点击"停止服务" → 自动停止代理并禁用系统代理
  • 关闭程序: 直接关闭窗口 → 自动清理所有代理设置

详细说明

  1. 配置参数: 填写域名、IP、Token、本地SOCKS5地址
  2. HTTP代理端口: 默认10809(可修改)
  3. 路由模式: 根据需求选择分流方式
  4. 保存配置: 点击"保存配置"保存设置(下次自动加载,包括路由模式)
  5. 一键操作: 启动/停止按钮自动处理所有代理设置,无需手动操作

🎯 核心功能说明

智能路由分流

程序内置了智能路由系统,支持三种分流模式:

1. 全局代理 所有请求 → HTTP代理 → SOCKS5代理 → 目标网站 2. 绕过大陆 (推荐) 国外请求 → HTTP代理 → SOCKS5代理 → 目标网站 国内请求 → 直接连接 → 目标网站 3. GFWList 被墙网站 → HTTP代理 → SOCKS5代理 → 目标网站 其他网站 → 直接连接 → 目标网站 

自动 SOCKS5 → HTTP 代理转换

程序内置了代理转换器,工作流程如下:

浏览器 → HTTP代理(127.0.0.1:10809) → 路由判断 → SOCKS5代理(127.0.0.1:30000) → ech-workers → 目标网站 ↓ 直接连接(国内网站) 

一键启动,自动配置

  1. 选择路由模式(全局代理/绕过大陆/GFWList)
  2. 点击"启动服务"按钮
  3. 自动启动代理 + 自动启用系统代理 + 智能分流
  4. 所有浏览器(Chrome/Firefox/Edge)立即生效!
  5. 点击"停止服务"或关闭程序时,自动清理所有代理设置

无需安装任何插件! 就像使用 v2rayN 一样简单!

注意事项

  1. ech-workers.exe 位置:

    • 开发时:将 ech-workers.exe 放在项目根目录(与 .csproj 同级)
    • 编译后会自动嵌入到 EchWorkersManager.exe 中
    • 运行时会自动提取到临时目录
  2. 图标文件 app.ico:

    • 放在项目根目录(与 .csproj 同级)
    • 必须是 .ico 格式(不是 .png 或 .jpg)
    • 推荐包含多个尺寸: 16x16, 32x32, 48x48, 256x256
    • 在线转换工具: https://convertio.co/zh/png-ico/
    • 如果没有图标文件,会使用系统默认图标
  3. 系统托盘:

    • 点击最小化按钮,程序会隐藏到系统托盘
    • 双击托盘图标或右键菜单"显示主窗口"恢复
    • 右键托盘图标可快速启动/停止服务
  4. 独立发布:

    • 使用 --self-contained 参数发布后,用户无需安装 .NET 6
    • 单个 exe 文件包含所有依赖,直接分发即可
  5. 配置保存: 配置保存在注册表 HKEY_CURRENT_USER\Software\EchWorkersManager

功能特性

  • ✅ 可视化配置界面
  • 一键启动:自动启动服务 + 启用系统代理
  • 一键停止:自动停止服务 + 禁用系统代理
  • 智能路由分流:
    • 全局代理: 所有流量走代理
    • 绕过大陆: 国外网站走代理,国内直连
    • GFWList: 仅被墙网站走代理
  • 最小化到系统托盘,双击恢复
  • 托盘右键菜单快速操作
  • 关闭自动清理:关闭程序时自动禁用系统代理
  • ech-workers.exe 自动嵌入,无需额外文件
  • 内置 SOCKS5 → HTTP 代理转换器
  • 无需安装浏览器插件
  • 支持独立发布,无需安装 .NET 6
  • ✅ 配置自动保存/加载(包括路由模式)
  • ✅ 状态实时显示
  • ✅ 完全模拟 v2rayN 的使用体验
  • ✅ 操作简化,无需确认对话框

系统要求

  • Windows 10 或更高版本
  • 如果使用独立发布版本,无需安装 .NET 10

快速打包指南 (3步完成)

步骤1: 准备项目文件

# 创建项目文件夹 mkdir EchWorkersManager cd EchWorkersManager # 复制以下文件到项目文件夹: # - EchWorkersManager.csproj # - Program.cs # - Form1.cs # - ech-workers.exe (重要!放在项目根目录) # - app.ico (可选,自定义图标文件)

关于图标文件 app.ico:

  • 图标文件必须是 .ico 格式
  • 推荐尺寸: 16x16, 32x32, 48x48, 256x256 多尺寸
  • 如果没有 app.ico,程序会使用系统默认图标
  • 图标会显示在:任务栏、系统托盘、exe文件、窗口标题栏

步骤2: 发布独立应用

# 64位系统(推荐) dotnet publish -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true # 32位系统 dotnet publish -c Release -r win-x86 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true # ARM64 系统 (Windows 11 ARM) dotnet publish -c Release -r win-arm64 --self-contained true -p:PublishSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=true

步骤3: 获取最终文件

生成的单个 exe 文件位于:

bin\Release\net10.0-windows\win-x64\publish\EchWorkersManager.exe 

直接分发这个 exe 文件给用户即可! 用户无需安装任何运行时环境。

故障排除

问题: 点击启动服务提示找不到 ech-workers.exe 解决: 将 ech-workers.exe 复制到管理器程序所在目录

问题: 设置代理失败 解决: 尝试以管理员身份运行程序

问题: 程序无法启动 解决: 确保已安装 .NET 6.0 运行时或使用独立发布版本

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors