从源码构建HypoMux:Go+Wails v3+React全栈开发环境搭建完整指南
从源码构建HypoMuxGoWails v3React全栈开发环境搭建完整指南【免费下载链接】HypoMuxCN Windows 多网卡聚合与网络加速工具。一键融合有线、Wi-Fi、热点等连接实现多路径传输与智能流量调度。 EN Windows multi-NIC network accelerator. Combine Ethernet, Wi-Fi, hotspots and more for multi-path transmission and smart traffic routing.项目地址: https://gitcode.com/gh_mirrors/hy/HypoMuxHypoMux 是一款面向 Windows 的开源多网卡聚合与网络加速工具可将有线、Wi-Fi、手机热点等多条链路合并传输实现智能流量调度。本文将带你从源码构建 HypoMux一步步完成 Go Wails v3 React 全栈开发环境的搭建新手也能照着跑通。 先认识项目三个模块的三层架构在写任何命令之前先弄清楚仓库结构这是避免照着文档抄命令却不知道为什么的关键。HypoMux 的源码分为三块各管一件事目录角色技术栈desktop/桌面客户端你看到的界面Go Wails v3 React Fluent UIengine/网络引擎多网卡调度核心纯 Go 模块protocol/前后端通信契约JSON 消息协议其中desktop/是典型的 Wails v3 工程Go 负责原生能力窗口、托盘、高权限服务React Vite 负责界面渲染两者通过自动生成的 TypeScript 绑定bindings通信。engine/则是独立的 Go module负责聚合调度、TUN 虚拟网卡、路由与 DNS构建时会被编译成hypomux-engine.exe与桌面端配套。两个 Go 模块的依赖清单分别在 desktop/go.mod 和 engine/go.mod可以点进文件确认具体版本。️ 一键安装开发环境5 个必备工具根据 README.md 中的开发与构建章节推荐环境如下Windows 10/11桌面端仅支持 Windows 平台Go 1.26engine 模块的 toolchain 要求见 engine/go.modNode.js 22pnpm 10前端包管理器锁定版本用Wails v3 CLI版本需为v3.0.0-alpha2.119与前端wailsio/runtime版本严格对应见 desktop/frontend/package.jsonCLI 一行命令装好go install github.com/wailsapp/wails/v3/cmd/wails3v3.0.0-alpha2.119 如果你要构建 NSIS 安装包还需要安装NSISmakensis。准备官方运行时文件这一步最容易踩坑构建任务会前置检查仓库根目录bin/下必须存在三个官方运行时文件缺一不可检查逻辑见 desktop/build/windows/Taskfile.ymlbin/sing-box.exebin/wintun.dllbin/libcronet.dll请从官方发布渠道下载对应版本放入仓库根目录的bin/文件夹。 克隆仓库git clone https://gitcode.com/gh_mirrors/hy/HypoMux cd HypoMux 安装前端依赖并生成 bindings前端代码位于desktop/frontend/使用 pnpm 安装依赖带锁文件保证版本可复现pnpm --dir desktop/frontend install --frozen-lockfile然后生成 TypeScript 绑定——这是 Wails 开发流程中不可跳过的一步Go 端暴露的方法会被翻译成前端可调用的 TS 接口缺了它界面就调不到原生能力Push-Location desktop wails3 generate bindings -cleantrue -ts -i Pop-Location绑定会输出到frontend/bindings/目录。之后每次修改 Go 端的对外方法记得重新执行这条命令。 开发模式运行项目一切就绪后进入desktop/目录启动开发模式Set-Location desktop wails3 devwails3 dev会同时做三件事编译 Go 端、以 9245 端口启动 Vite 前端热更新、运行应用窗口配置见 desktop/build/config.yml。修改 React 组件或 CSS 后浏览器层自动热更新修改 Go 代码则自动重编译非常适合日常调试。任务编排入口是 desktop/Taskfile.yml其中dev任务本质上执行的就是wails3 dev -config ./build/config.yml -port 9245。启动成功后你会看到 HypoMux 的 Fluent UI 风格首页可以刷新并勾选活动网卡、运行网络体检、切换系统代理与虚拟网卡两种加速模式界面还支持自定义主题与壁纸开发者可以随意切换明暗模式验证样式✅ 跑测试再构建生产构建与打包安装包构建前建议先保证质量门禁全绿——项目前后端都有完善的测试套件go -C engine test ./... go -C desktop test ./... pnpm --dir desktop/frontend build生产构建与打包由 Windows 平台任务完成最终产出 NSIS 安装程序任务定义见 desktop/build/windows/Taskfile.ymlSet-Location desktop wails3 task windows:packagewindows:package会先交叉编译hypomux.exe与hypomux-engine.exe、拷贝sing-box.exe等运行时文件、生成.syso图标资源最后调用 makensis 生成安装包。 构建成功后验证多网卡聚合效果装好自己构建的版本后接上至少两条网络如宽带 手机热点启动聚合引擎再开一个多连接下载器即可体验连接级调度。例如 IDM 多线程下载场景下多张网卡会同时跑满更多玩法与完整构建流程含 CI 发布细节可以继续阅读 README.md 的开发与构建章节以及 desktop/ 目录下的任务文件。❓ 常见问题速查pnpm报版本错误项目用 pnpm 10 与pnpm-lock.yaml锁定依赖版本不对会直接拒绝构建建议用corepack或npm i -g pnpm10对齐。绑定报方法不存在前端改动的 Go 方法没重新生成 bindings回到第四步重跑一次。打包时提示缺少运行时文件检查bin/下三个文件是否齐全这是最常见的构建失败原因。Vite 端口被占用开发端口固定为 9245见 desktop/Taskfile.yml释放占用或结束残留进程即可。照着以上步骤走一遍你就拥有了 HypoMux 的完整源码级开发能力改界面、加规则、调调度策略都从这份 Go Wails v3 React 工程出发。【免费下载链接】HypoMuxCN Windows 多网卡聚合与网络加速工具。一键融合有线、Wi-Fi、热点等连接实现多路径传输与智能流量调度。 EN Windows multi-NIC network accelerator. Combine Ethernet, Wi-Fi, hotspots and more for multi-path transmission and smart traffic routing.项目地址: https://gitcode.com/gh_mirrors/hy/HypoMux创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考