# HypoMuxPlus

**Repository Path**: xuanding/hypo-mux-plus

## Basic Information

- **Project Name**: HypoMuxPlus
- **Description**: HypoMuxPlus用于将电脑上多条独立网络线路的带宽聚合到同一批高并发下载任务，让 Steam、IDM、浏览器大文件下载跑满每一张网卡。基于 Tauri + Rust 重构，单文件、零依赖、原生般流畅。
- **Primary Language**: Unknown
- **License**: AGPL-3.0
- **Default Branch**: main
- **Homepage**: https://hmp.pmhs.top
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-28
- **Last Updated**: 2026-08-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

<img src="./appicon.svg" width="120" height="120" alt="HypoMuxPlus" />

# HypoMuxPlus

**多网卡带宽聚合工具**

[![Tauri](https://img.shields.io/badge/Tauri-2.x-FFC131?style=flat-square&logo=tauri&logoColor=white)](https://tauri.app)
[![Rust](https://img.shields.io/badge/Rust-1.90%2B-000000?style=flat-square&logo=rust)](https://www.rust-lang.org)
[![React](https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=white)](https://react.dev)
[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178C6?style=flat-square&logo=typescript&logoColor=white)](https://www.typescriptlang.org)
[![TailwindCSS](https://img.shields.io/badge/TailwindCSS-4-06B6D4?style=flat-square&logo=tailwindcss&logoColor=white)](https://tailwindcss.com)
[![Platform](https://img.shields.io/badge/Platform-Windows%2010%20%2F%2011-0078D4?style=flat-square&logo=windows)](#)
[![License](https://img.shields.io/badge/License-AGPL--3.0-D22128?style=flat-square)](./LICENSE)

[![Download](https://img.shields.io/badge/⬇%20下载%20Download-v1.2.8-3b82f6?style=for-the-badge)](https://gitee.com/peng-minghang/hypo-mux-plus/releases/download/v1.2.8/HypoMuxPlus.exe)
[![GitHub](https://img.shields.io/badge/GitHub-pmh1314520%2FHypoMuxPlus-181717?style=for-the-badge&logo=github)](https://github.com/pmh1314520/HypoMuxPlus)
[![Gitee](https://img.shields.io/badge/Gitee-peng--minghang%2Fhypo--mux--plus-C71D23?style=for-the-badge&logo=gitee)](https://gitee.com/peng-minghang/hypo-mux-plus)

**🌐 语言 / Language：简体中文 · [English](./README_EN.md)**

</div>

---

HypoMuxPlus 是一款面向 Windows 平台的**多网卡带宽聚合工具**。它在 [Hypostasis-Cat 的开源项目 HypoMux](https://github.com/Hypostasis-Cat/HypoMux) 的核心思想之上，使用 **Tauri + Rust + React + TailwindCSS** 完整重构，提供更美观、更流畅、更专业的桌面体验，并将分流引擎用 Rust（tokio）原生重写，产物为零运行时依赖的独立可执行文件。

> 本项目是基于原 HypoMux 的衍生作品，遵循其 **AGPL-3.0** 协议开源。原作者：Hypostasis-Cat；衍生开发者：**青云制作_彭明航**。

## 下载安装

- **仅支持 Windows 10 / 11**，下载后双击运行即可（建议以管理员身份运行以启用全部稳定性增强功能）。
- 直接下载：**[HypoMuxPlus.exe (v1.2.8)](https://gitee.com/peng-minghang/hypo-mux-plus/releases/download/v1.2.8/HypoMuxPlus.exe)**（Gitee 国内高速下载；海外用户可使用 [GitHub Releases](https://github.com/pmh1314520/HypoMuxPlus/releases/download/v1.2.8/HypoMuxPlus.exe)）
- 项目仓库：[GitHub](https://github.com/pmh1314520/HypoMuxPlus) · [Gitee](https://gitee.com/peng-minghang/hypo-mux-plus)
- 项目官网：**[hmp.pmhs.top](https://hmp.pmhs.top)**

## 界面预览

<div align="center">

**🚀 加速控制台**

<img src="./docs/console-dark.png" width="780" alt="加速控制台" />

**📊 实时统计 · 🩺 链路体检诊断**

<img src="./docs/stats-dark.png" width="780" alt="实时统计" />

<img src="./docs/diagnostics-dark.png" width="780" alt="链路体检诊断" />

**⚙️ 偏好设置 · 📖 使用教学 · ℹ️ 关于**

<img src="./docs/settings-dark.png" width="780" alt="偏好设置" />

<img src="./docs/tutorial-dark.png" width="780" alt="使用教学" />

<img src="./docs/about-dark.png" width="780" alt="关于" />

**🌗 深 / 浅双主题（以加速控制台为例）**

| 暗色主题 | 亮色主题 |
| :---: | :---: |
| <img src="./docs/console-dark.png" width="390" alt="暗色主题" /> | <img src="./docs/console-light.png" width="390" alt="亮色主题" /> |

<sub>软件内置深 / 浅双主题与完整中英双语，更多界面预览可访问项目官网。</sub>

</div>

## 核心特性

### 分流与调度
- **双协议无感接管**：后台同时运行 SOCKS5 与 HTTP/HTTPS 转发服务，启动后自动写入 Windows WinINet 系统代理，兼容 Steam、IDM、浏览器等遵循系统代理规范的客户端。
- **按连接的多网卡出口绑定**：对每条出站 TCP 连接用 `setsockopt(IP_UNICAST_IF)` 指定出口接口索引 + `bind` 源地址，引导该连接从指定网卡出网，根治同网段多网卡的 `WinError 10049` 错网卡问题。这是**连接级的出口选择**，而非数据包级链路捆绑 / MPTCP。
- **智能调度引擎**：内置三种连接调度策略——经典轮询、最少连接优先、按实时下行速度动态加权（平滑加权轮询 SWRR），让更快的网卡承担更多连接，弱链路不再拖累整体聚合。
- **每网卡权重与限速 · 全局下行限速**：可为每张网卡单独设定调度权重与单卡下行限速，也可设置全局下行总限速，精细控制各线路负载与总带宽占用。
- **应用分流规则**：按域名 / 端口 / 进程名自定义规则——直连（不走代理）、走聚合、或钉死到指定网卡；「按进程名」匹配（如 `steam.exe`）优先级高于域名规则；支持直连白名单，以及从 URL 订阅规则列表。
- **SOCKS5 UDP 转发**：支持 SOCKS5 UDP ASSOCIATE，为代理模式下的应用经所选网卡出口转发 UDP 数据报，兼容依赖 UDP 的客户端。
- **上游代理链（多节点聚合）**：可为每张参与聚合的网卡各绑定一个上游代理节点（SOCKS5 / HTTP，支持用户名密码认证），实现「网卡 A → 节点 1」「网卡 B → 节点 2」并行叠加，同时突破本地上行带宽与单一节点两个瓶颈；支持一张网卡绑定多个上游轮转，以及全部上游不可用时的回退策略（回退直连 / 返回失败）。默认关闭，未启用时行为与既有完全一致。
- **上游健康探测与故障熔断**：周期性探测被引用上游节点的可用性与延迟，连续失败达阈值即自动熔断（暂时排除出候选），经冷却期后半开探测、成功即自动恢复；一张网卡绑定多个上游时按健康状态与延迟加权，优选更快更稳的节点。探测间隔 / 超时 / 熔断阈值 / 冷却时间均可配置。
- **订阅导入**：粘贴 Clash 订阅 / base64 订阅正文 / 节点分享链接，即可解析出受支持（socks5 / http）的上游候选，一键测速排序后确认并入上游节点列表（遵守 128 条上限）。
- **IPv6 / 双栈分流**：支持 IPv6 字面目标与域名双栈（A/AAAA）解析，并按 IP 版本偏好做 Happy-Eyeballs 式拨号与回退。
- **每网卡独立 DNS / DoH**：可为每张参与聚合的网卡单独指定明文 DNS 服务器或 DoH 端点，解析请求经该网卡出口发出，避免解析走错出口；未配置时沿用既有全局解析路径。
- **全局接管（TUN）模式 · 免逐个配置代理**：内置基于 wintun 虚拟网卡 + 用户态 TCP/IP 栈的全局接管模式，一键把全系统流量导入多网卡分流引擎，无需再逐个应用配置代理；DNS 采用 fake-ip 绕过劫持。支持**服务模式**：一次性安装（弹一次 UAC）后，此后普通权限即可开启 TUN，无需每次以管理员运行。

### 体检与监控
- **链路体检与测速**：一键探测各网卡出口延迟（RTT），并统计抖动（Jitter）与丢包率、展示历史趋势曲线，同时支持逐张网卡下载测速跑分，帮你挑选最健康、最快的线路；体检结果可一键导出为图片或文本报告。
- **一键聚合测速**：对已勾选网卡并发跑分，直观展示「单卡速度 → 合并总速度」与提升幅度。
- **实时连接监控**：实时连接列表展示每条连接的目标地址与所分配的出口网卡，分流过程透明可见，支持按协议 / 网卡 / 目标过滤与导出。
- **实时遥测大屏**：基于内核计数器（`GetIfEntry2`）的逐秒采样，展示合并下行总速度、实时波形、各网卡速度与活跃连接数。
- **悬浮窗 HUD**：可选的置顶迷你悬浮窗，实时显示合并速度、上/下行、连接数与分网卡波形；支持锁定位置、点击穿透、透明度与配色跟随主界面。
- **网卡掉线守护**：加速期间实时巡检参与分流的网卡，失联自动移出调度轮换并提示，恢复后自动重新纳入。
- **累计与每日统计**：跨会话持久化累计加速流量、峰值与时长，并展示最近每日流量趋势；每次加速结束弹出「本次战报」，可导出 PNG 分享。

### 稳定性与自动化
- **全生命周期代理保护**：手动停止、启动失败、窗口关闭、进程退出等所有路径都强制还原系统代理，降低代理残留导致断网的风险；启动时仅清理本程序残留、不触碰 Clash 等第三方代理。
- **稳定性增强**：加速期间自动关闭死网关检测（Dead Gateway Detection），防止慢速链路被系统判定失效而中途罢工。
- **系统代理防泄漏看门狗**：持续监视系统代理设置，一旦被外部程序篡改或清除即自动纠正；接管前会快照原始设置，异常退出后于下次启动补偿还原，降低流量绕过分流引擎泄漏与代理残留断网的风险。
- **稳定性加固（连接级隔离 + 上限保护）**：单条连接的异常被捕获并隔离，仅释放该连接、不波及引擎与其他连接；可配置并发连接数与后台任务并发上限，防止极端负载下资源耗尽；未处理异常写入结构化崩溃日志（含敏感信息脱敏）。
- **进程感知自动加速**：检测到 Steam / IDM / 迅雷 / qBittorrent 等下载类应用运行时自动开始加速，全部退出后自动停止（仅停自动启动的会话）。
- **应用兼容性**：为 Steam / IDM 一键写入或还原 SOCKS5 代理配置。
- **全局热键与系统通知**：可分别绑定「加速」「停止」两组全局热键（默认 `Ctrl+Alt+H`，可自定义录制），任意界面一键切换；加速启停弹出系统通知提醒。
- **命令行控制 · 单实例**：支持 `--start` / `--stop` / `--toggle` / `--show` / `--quit` 命令行控制；单实例运行，重复启动会把命令转发到已有实例。
- **应用内自动更新**：启动静默检查新版本，一键下载并在退出后静默替换、自动重启（下载进度可见）。
- **自动化**：开机自启、启动即最小化到托盘、开机后自动用上次选择的网卡开始加速。

### 界面与体验
- **现代化界面**：深色 / 浅色双主题（可跟随系统）、可自定义强调色、高对比模式、玻璃拟态、流畅动效、完整中英双语，矢量图标全程无 Emoji，并针对键盘与读屏做了无障碍适配。
- **分流决策模拟器**：输入目标域名 / 进程名（可选端口），即可以纯计算方式模拟其将命中的分流路径（命中 bypass / 规则 / 承载网卡 / 直连或经上游 / 选中的上游节点），仅做展示，不发起任何真实连接、不改变加速状态，便于排查规则配置。
- **系统托盘**：支持最小化到托盘 / 直接退出两种关闭行为，托盘图标实时渲染当前聚合速率数字、悬停显示速度与连接数。

## 技术栈

| 层 | 技术 |
| --- | --- |
| 桌面框架 | Tauri 2（原生 WebView2，单文件、低占用） |
| 后端引擎 | Rust + tokio 异步运行时 + socket2 + windows-sys（IPHLPAPI / WinSock / WinINet） |
| 前端 | React 19 + TypeScript + Vite |
| 样式与动效 | TailwindCSS 4 + Framer Motion + Lucide 矢量图标 |

## 工作原理

```text
[多线程下载流量 (Steam / IDM / 浏览器)]
               │
               ▼  WinINet 系统全局代理自动接管
   http/https -> 127.0.0.1:10801 | socks -> 127.0.0.1:10800
               │
               ▼
   HypoMuxPlus 分流引擎 (Rust + tokio)
               │
               ▼  按策略进行连接调度
   连接级套接字出口绑定 (IP_UNICAST_IF + bind)
   ├── 网卡 1 (IfIndex) ──┐
   ├── 网卡 2 (IfIndex) ──┼─► 多连接聚合吞吐
   └── 网卡 N (IfIndex) ──┘
```

加速时程序向 `HKCU\Software\Microsoft\Windows\CurrentVersion\Internet Settings` 写入全覆盖代理链条；分流引擎收到客户端 TCP 连接后，先经所选物理网卡解析目标真实 IP（DoH/UDP，绕过 fake-ip 劫持），再用 `setsockopt(IPPROTO_IP, IP_UNICAST_IF, htonl(if_index))` 指定该连接的出口接口、`bind(local_ip, 0)` 固定源地址，使连接从目标网卡出网。多线程下载的大量并发连接被分发到不同网卡，从而在**多连接负载均衡**的意义上叠加各线路带宽。启用上游代理链时，连接会先经所选网卡的物理出口连上对应的上游节点，再由上游转发到目标。

> **技术定位与边界**：HypoMuxPlus 是运行在用户态的**按连接多网卡代理调度器（L4）**，不是 L3/L4 链路捆绑、MPTCP 或 SD-WAN 系统。提速来自「多条并行 TCP 连接 + 按连接分发到不同网卡 + 服务器端多连接支持（CDN / HTTP Range）」，**无法加速单条 TCP 流**。`IP_UNICAST_IF` 是出口接口选择（路由提示）而非硬隔离。若系统中运行 **Clash/Mihomo 的 TUN 模式**，其在网络层（L3）以虚拟网卡接管全部 IP 流量，会覆盖本程序在 L4 的网卡绑定，导致多网卡塌缩为单一上游——此时建议关闭 TUN（改用 Clash 的系统代理/规则模式）以获得真正的多网卡分流。

## 使用场景举例

只要是**相互独立、各自拥有出口带宽**的网络线路，都能并入带宽池一起叠加：

- **宿舍 · 合并室友的宽带**：你的电脑插着网线，自己的宽带最高约 10 MB/s；舍友也有一条独立宽带，同样能跑 10 MB/s。让电脑再通过 Wi-Fi 连上舍友的网络，两条线路同时进入带宽池，HypoMuxPlus 将它们叠加，下载峰值可逼近 20 MB/s。
- **再加一张网 · 手机流量入池**：两条还嫌不够？用数据线把手机以「USB 网络共享」接入电脑，手机的 4G/5G 流量就成了第三条独立线路一并纳入聚合，带宽继续往上叠。线路越多、越独立，叠加越可观。
- **家庭 / 工作室 · 多线并发**：家里有电信 + 联通双宽带，或工作室拉了多条独立专线时，可以全部勾选参与聚合，让 Steam 更新与大文件下载跑满每一条线路的上限。

> ⚠️ **关键前提**：参与聚合的线路必须各自拥有独立的出口带宽。如果你的「有线」和「无线」其实接的是同一台路由器、同一条宽带（共用同一个运营商上联），那叠加是**无效**的——它们本就在抢同一份带宽，合并后总量并不会增加。

## 使用方法

1. **环境就绪**：确保电脑同时接入多条独立网络线路（例如有线宽带 + Wi-Fi + 手机 USB 网络共享）。
2. **勾选网卡**：启动程序，等待网卡扫描完成，在「网卡分流矩阵」中勾选参与聚合的活动网卡。
3. **一键加速**：点击「一键加速」，状态切换为运行中，系统全局代理被接管。
4. **配置下载工具代理（关键）**：让下载工具走本程序代理才会生效——
   - 遵循系统代理的客户端（多数浏览器、Steam）通常自动生效；
   - **不读取系统代理的工具（如 IDM、迅雷、qBittorrent）需手动设置**：在其代理设置中填入 **SOCKS5 代理 `127.0.0.1:10800`**（或 HTTP 代理 `127.0.0.1:10801`，端口以设置页为准）；Steam / IDM 也可在「设置 → 应用兼容性」一键写入。
5. **开始下载**：发起多线程下载任务，控制台会显示连接调度日志，大屏实时展示各线路吞吐。
6. **干净停止**：点击「停止加速」或关闭软件，系统代理自动安全还原。

> **加速后只有一张网卡在跑 / 速度没变化？** 九成是上面第 4 步没做——下载工具没指向本程序代理，流量没进分流引擎。请在下载工具里填好 SOCKS5 `127.0.0.1:10800`。其次确认参与聚合的多张网卡**各自有独立的公网出口**（程序启动加速时会做「网卡自检」并在调度日志给出结果），且下载任务为多线程。

> **懒得逐个配置代理？** 可在「设置」中开启**全局接管（TUN）模式**，一键接管全系统流量走多网卡分流，无需再给每个下载工具单独填代理。建议先在设置里安装「TUN 服务模式」，之后普通权限即可开启（否则需以管理员身份运行本程序）。注意：TUN 模式会与 Clash/Mihomo 的 TUN 冲突，二者只能启用其一。

## 开发与构建

需要预先安装 [Node.js](https://nodejs.org)、[Rust](https://www.rust-lang.org/tools/install) 与 [Tauri 前置依赖](https://tauri.app/start/prerequisites/)（Windows 需 WebView2 与 MSVC 构建工具）。

```bash
# 安装前端依赖
npm install

# 开发模式（热重载）
npm run tauri dev

# 构建发行版（生成独立 exe 与安装包）
npm run tauri build
```

## 安全与边界说明

- 本工具工作在标准应用层代理与网络套接字绑定层，**不触碰游戏内存、不修改游戏封包、不注入任何 DLL**。
- 多网卡聚合本质是**多连接负载均衡**，对单线程 TCP 死速下载无法加速。
- 多网卡分流面向下载吞吐量；游玩对延迟敏感的网游前，请先「停止加速」，让网络回归单一默认网关。
- 部分稳定性增强功能（死网关检测）需要管理员权限，未提权时核心分流仍可正常使用。

## 赞助支持

HypoMuxPlus 完全免费开源！如果它帮到了您，希望您能请作者喝杯咖啡，赞助时记得备注 “HypoMuxPlus” 哦~ 赞助纯属自愿，无论是否赞助都可永久免费使用全部功能。

<div align="center">

| 微信赞赏 | 支付宝 |
| :---: | :---: |
| <img src="./docs/sponsor-wechat.png" width="220" alt="微信赞赏" /> | <img src="./docs/sponsor-alipay.jpg" width="220" alt="支付宝" /> |

**开发者联系方式：微信 `QyPmh20061026` · QQ `2124691573`**

</div>

## 致谢与衍生声明

本项目衍生自 [Hypostasis-Cat / HypoMux](https://github.com/Hypostasis-Cat/HypoMux)，核心的多网卡物理绑定思想与协议设计均源自原项目，特此致谢。HypoMuxPlus 在其基础上重写了桌面客户端的全部界面与后端引擎实现。

## 开源协议

本项目基于 **AGPL-3.0** 协议开源，与原项目保持一致。详见 [LICENSE](./LICENSE)。

- 原作者 / Original Author：**Hypostasis-Cat**
- 衍生开发者 / Derivative Developer：**青云制作_彭明航**