故障排查

如果应用顶部通知显示 HM-E****，请先在错误代码中按编号定位原因和处理建议。

先按这个顺序检查

1. 记录通知详情和发生时间，正常停止聚合。先确认不运行 HypoMux 时，每条网络能否独立联网。
2. 在没有其他代理、VPN 或加速器接管网络的情况下，用原来的应用重试，区分基础联网问题与接管冲突。
3. 运行“网络检测”，只选择可用链路，重新启动 HypoMux 并新建应用连接。每次只更改一项设置。
4. 根据下列现象继续排查；仍能复现时，整理反馈信息。不要先删除配置、清空规则或关闭整个防火墙。

聚合后速度没有提升

确认下载任务本身包含多个并发连接。若下载源只使用单条 TCP 连接，速度仍会受到该连接所在链路限制。

同时确认已选择至少两张可用网卡，并在“连接”页面观察新连接是否分布到多张已选链路。下载源限速、磁盘写入、Wi-Fi 信号和热点套餐也可能成为瓶颈。

• 连接列表没有对应应用：确认应用遵循系统代理或已配置本地代理；必要时参考运行模式选择适合的接管方式。
• 只有一张网卡有连接：检查其他网卡是否在线，以及分流规则是否将流量固定到某个出口。已建立的连接需重新建立才会重新调度。
• 多张网卡都有连接但速度不高：分别测试每条线路，确认是否共享同一宽带出口，再用同一下载源和并发数对比。调整权重不等于提高链路本身的速度。

网卡无法加入聚合池

先运行网络检测，检查 IPv4、网关、DNS 与源地址绑定。没有有效互联网连接的网卡不应加入聚合池。

与其他代理或加速器冲突

关闭另一个程序的系统代理接管；如果它已创建 TUN / VPN 并接管默认路由，先退出该程序。随后重启 HypoMux 并重新选择模式。

虚拟网卡模式下部分应用异常

如果问题只在虚拟网卡模式下出现，可在“设置 → 高级网络 → TUN 协议栈”中切换 system / mixed / gvisor 做对比。选择会自动保存，需停止后重新启动虚拟网卡模式才生效。详见 TUN 栈选择。记录出问题的应用、流量类型和所用栈，避免同时修改多项设置。

如果虚拟网卡根本无法建立，或启动后整机断网，多半与本机的网络组件有关，而不是协议栈选择。在“设置 → 高级网络”中运行网络组件与 TUN 兼容性检查，按结果处理后再重试。开启了严格路由与 DNS 防泄漏时，可先临时关闭它做一次对比，以判断问题是否来自 WFP 规则。

NAT 检测无法判定或联机困难

先停止聚合，在“网络检测 → NAT 类型检测”中选择要排查的物理网卡。各类结果的含义见 NAT 类型检测。

• 提示“待校准”或本机防火墙影响过滤测试：使用结果卡片中的“允许并重测”，按系统提示完成防火墙授权后重试。这个操作会为检测放行 HypoMux 的 UDP 回包，与普通只读检测不同；无需关闭整个防火墙。重测后仍应以实际结果为准。
• 超时、解析失败或服务器不支持：检查该网卡能否联网，查看服务器尝试记录，尝试“自动选择”或另一台支持 RFC 5780 的服务器。能返回公网地址的普通 STUN 服务器不一定支持完整行为检测；超时也可能来自 UDP 阻断或丢包，不能单凭超时判定 NAT 类型。
• 端口受限、对称型或混合型行为，且应用确实联机失败：分别测试其他可用网络并对比应用表现。检查是否存在光猫与路由器双重 NAT，或向运营商确认是否使用共享公网 IPv4；需要入站连接时，再按应用要求评估公网地址、端口映射或应用自带中继。单纯切换 TUN 栈或增加聚合网卡不会消除上游 NAT 限制。

分享检测结果时，请隐去公网端点和本机地址，保留 NAT 类型、映射 / 过滤行为、服务器尝试记录及检测时间。

覆盖安装或升级失败

升级时提示文件被占用、安装程序卡住或安装后仍是旧版本，通常是旧进程、Core 服务或只读文件没有释放。先按顺序处理：

1. 正常停止聚合并退出 HypoMux（包括托盘图标），关闭所有未完成的安装程序窗口。
2. 重新运行已验证签名的官方安装包，见版本升级。
3. 仍然失败时，使用仓库 tools/support/ 中的升级检查与修复工具：双击 Start-HypoMux-Repair.cmd，输入 1 只做检查并生成诊断日志，确认问题后再输入 2 执行修复。

关于这个工具，有几点需要先了解：

• 必须使用平时运行 HypoMux 的同一个 Windows 账户提升管理员权限，不要输入其他管理员的凭据。
• 修复前需要手动输入“确认”。它会结束已核实路径的 HypoMux 进程、停止 Core、用官方签名程序自带命令恢复网络设置，并清除 Core 文件的只读属性，正在进行的下载会断开。
• 它不会删除配置、分流规则、缓存或安装文件，不修改目录权限，不重置 DNS/Winsock，也不会关闭安全软件。自动恢复只接受签名有效且发布者为 SignPath Foundation 的程序。
• 修复完成后需要重新运行官方安装包。Core 可能保持停止状态，只重启电脑不会重新启用它，请完成覆盖安装，不要自行删除服务或系统文件。
• 生成的日志可能包含 Windows 用户名和安装路径，发送前请检查并遮盖，再按反馈信息提交。

停止后仍无法联网

如果程序仍在运行，先点击停止并等待完成。若此前异常退出，可重新打开 HypoMux，让它尝试恢复原有设置，再正常退出并测试联网。

系统代理模式下，可查看 Windows“设置 → 网络和 Internet → 代理”，核对是否仍指向已经停止的 HypoMux 本地端口。修改前记录原值；仅在确认该值由 HypoMux 留下、且不是组织或其他软件要求的代理时恢复原设置。不要盲目清空公司代理、DNS 或路由。

虚拟网卡模式下，或无法判断设置归属时，保留日志与当前状态并提交问题，不要手动删除网卡或批量重置网络来掩盖原因。

2.7 新功能问题

现象	先检查
AI 能聊天但不能操作	工具调用测试、协议与确认状态
热点开关不可用或连上不能上网	TUN 前置条件与共享出口状态
订阅更新后出口不变	TUN、重启要求、优先级与新连接
MTU 超时或无法应用	ICMP 目标、结果有效期和配置变化
切换策略后速度没有马上改变	已有连接不迁移，查看持续学习与新连接分配

提示“网络服务未运行”时不要为了收集信息盲目启动服务；截图、版本号和页面错误通常可先在停止状态下收集。

提交问题前，请准备这些信息

• HypoMux 版本和 Windows 版本；
• 使用的运行模式、已选择的网卡类型；
• 能稳定复现问题的操作步骤与发生时间；
• 脱敏后的日志、网络检测结果，以及是否同时运行 VPN、TUN、代理或加速器。

可以复制下面的模板，填写后提交到 GitHub Issues，或先在用户社区交流：

HypoMux / Windows 版本：
运行模式 / 调度策略（TUN 问题请附协议栈）：
网卡类型及是否共享同一宽带出口：
同时运行的 VPN、代理或加速器：
复现步骤：
预期结果 / 实际结果：
错误码 / 发生时间：
停止 HypoMux 后是否恢复正常：
已尝试的排查步骤：

发送前隐藏公网 IP、本机用户名、设备名、私人域名、令牌和账号信息。保留错误码与相邻日志，不要只提供“无法使用”的截图。

到哪里找支持日志

2.7.0 没有单独的公开“日志”导航页。可在“系统设置 → 配置与启动 → 配置文件位置”打开所在目录，查找其中的 logs/app.log。默认数据目录为当前 Windows 用户目录下的 .hypomux，请以设置页实际位置为准。

日志只保留最近最多 3 次会话，总大小上限为 5 MiB；遇到问题后及时保留相关时间段的副本，不要为找日志连续重启。没有历史会话时可能没有可用日志，此时先提供错误提示、版本和复现步骤，不必专门启动网络服务。发送前自行检查并遮盖敏感内容，不要上传整个配置目录或 AI/热点凭据文件。