BerryHub Windows客户端无法连接怎么办？按现象快速排查
简答：BerryHub Windows客户端无法连接，先不要同时修改DNS、MTU和TUN：依次确认客户端能否启动、订阅是否成功导入、配置是否被选中、系统代理是否开启，以及本地端口是否被占用。BerryHub当前Windows页面写明适用于Windows 10/11，但客户端名称在不同页面显示不一致，因此下载入口和文件名应以当前技术支持页为准。本文为BerryHub使用整理，不是品牌官网或官方下载站。
定义：BerryHub Windows客户端连接故障，是指Windows客户端无法启动、订阅无法导入、节点连接超时，或客户端显示已连接但浏览器和应用无法正常访问网络。
先看故障分流表：你属于哪一种无法连接
先只选择与你现象最接近的一行处理，避免一次修改多个设置后无法判断问题来源。
| 现象 | 优先检查 | 下一步 |
|---|---|---|
| 客户端打不开或安装后无法运行 | Windows版本、设备架构、安全拦截、程序依赖 | 核对Windows 10/11和x64或ARM架构，查看Windows安全中心的拦截记录。 |
| 订阅导入失败、没有节点 | 复制内容是否为订阅链接，链接是否完整 | 重新从BerryHub仪表盘复制订阅链接，再导入并选中新配置。 |
| 只有一个节点超时 | 单个节点或线路状态 | 切换其他节点；如果其他节点正常，先不要改本机网络设置。 |
| 所有节点都超时 | 订阅更新、本地网络、系统时间、防火墙、其他代理软件 | 切换手机热点等另一网络复测，并记录错误时间和日志。 |
| 客户端显示已连接但网页打不开 | 系统代理、浏览器旧代理、本地端口冲突 | 关闭其他代理软件，检查Windows代理设置，再使用netstat -ano确认端口。 |
| 开启TUN后断网 | 虚拟网卡、路由或防火墙冲突 | 先关闭TUN恢复系统代理模式，再检查虚拟网卡和防火墙规则。 |
BerryHub支持页说明Windows客户端适用于Windows 10/11，并显示当前客户端名称；Windows使用指南中的名称存在差异，所以具体入口、文件名和版本不要根据旧搜索结果判断，应以当前技术支持页和Windows使用指南实际显示为准。
从订阅到系统代理：统一按5步检查
- 确认客户端可以正常启动。先查看Windows版本和系统类型。常见Intel或AMD电脑通常使用x64，ARM设备才考虑arm64；如果安装程序提示无法在电脑上运行，优先重新核对架构，不要反复运行同一个安装包。
- 确认拿到的是订阅链接。登录仪表盘后使用页面提供的订阅复制入口，不要复制浏览器地址栏中的登录网址。订阅链接通常包含访问凭证，不能公开发到评论区、群聊或工单截图中。
- 重新导入并激活配置。打开客户端的订阅或Profiles页面，粘贴完整链接并执行导入。导入完成后，要选中刚出现的配置；仅看到订阅条目，不代表配置已经被使用。
- 只开启一个系统代理来源。先关闭其他代理、VPN或网络接管工具，再在客户端中开启系统代理。随后检查Windows“设置”→“网络和Internet”→“代理”是否残留手动代理。菜单名称可能因Windows版本不同而变化，以当前界面为准。
- 最后再考虑TUN。浏览器等遵循Windows系统代理的应用，通常先用系统代理验证。只有目标应用不读取系统代理或确实需要更广泛流量接管时，才考虑TUN；如果开启TUN后断网，先关闭TUN恢复到系统代理模式。
BerryHub的Windows页面也建议按“复制订阅—导入订阅—选中配置—开启系统代理”的顺序操作。每次只改一个设置，能够更快判断问题是在订阅、客户端、Windows代理还是线路环节。
按错误提示继续排查：端口、远端连接与浏览器代理
1. 检查本地端口是否被占用
如果出现端口冲突、代理无法启动，打开命令提示符运行：
netstat -ano
重点看目标端口所在的Local Address列，以及状态是否为LISTENING；不要把Foreign Address中的远端端口误判为本地冲突。Microsoft文档说明，netstat可以显示监听端口，并可通过-o显示对应进程ID，便于在任务管理器中继续定位。可参考Microsoft netstat文档。
2. 检查目标主机和端口能否建立TCP连接
如果你已经知道要测试的主机名和端口，可在PowerShell运行：
Test-NetConnection example.com -Port 443
把示例域名和端口替换为客户端日志或服务页面中明确显示的目标。重点查看TcpTestSucceeded。该命令只能说明TCP连接测试结果，不能单独证明订阅有效、节点规则正确或网页一定可以打开。详细参数可参考Microsoft Test-NetConnection文档。
3. 检查浏览器是否保留旧代理
如果客户端显示已连接，但浏览器打不开，先关闭其他代理软件，检查Windows代理设置中的手动代理，再完全退出并重新打开浏览器。若只有某个应用失败，可能是该应用不读取Windows系统代理，应单独查看应用自身的代理选项，不要直接判断为所有节点故障。
如何判断是本机配置还是服务端、节点问题
| 验证动作 | 结果 | 判断方向 |
|---|---|---|
| 重新复制订阅并导入 | 配置重新出现并可选中 | 原问题更可能是链接不完整、复制错误或配置未激活。 |
| 关闭其他代理，只保留一个系统代理 | 网页恢复访问 | 原问题更可能是代理来源冲突或旧代理残留。 |
| 切换到另一网络测试 | 另一网络正常 | 原网络、路由、防火墙或DNS环境需要进一步检查。 |
| 多个节点、多个网络都失败 | 仍然全部超时 | 保存错误时间、节点名称和脱敏日志，联系服务方核验订阅或节点状态。 |
| 只有一个应用打不开 | 浏览器或其他应用正常 | 优先检查该应用是否使用系统代理，以及应用自身的网络权限。 |
不要为了“测试”而长期关闭Windows安全防护、开放不必要端口或同时运行多个网络接管工具。若必须提交截图，先遮盖订阅链接、Token、账号、密码和个人信息。
提交问题前准备哪些信息
如果完成上述步骤仍无法连接，可以整理以下信息再提交工单，避免只写“连不上”：
- Windows版本和设备架构，例如x64或ARM；
- 客户端页面实际显示的名称和安装包文件名；
- 故障发生在启动、导入订阅、更新订阅、选择节点、开启系统代理还是开启TUN之后；
- 错误提示原文、发生时间，以及是否更换过网络；
- 关闭其他代理软件后的结果；
- 必要的脱敏日志或截图。
BerryHub当前Windows页面提示，遇到更多问题时可通过仪表盘的问题入口新建工单。由于页面内容、客户端名称和菜单可能变化，提交时应原样记录当前页面显示内容，不要自行改写名称。
常见问题
BerryHub Windows客户端无法连接，第一步应该做什么？
先确认客户端能否启动，再重新从当前支持页面进入仪表盘复制订阅链接，导入后选中配置并只开启一个系统代理来源。不要一开始就修改DNS、MTU和TUN。
导入订阅后看不到节点怎么办？
确认复制的是订阅链接而不是登录网址，检查链接是否完整，再重新导入。导入成功后还要选中新配置；如果仍失败，记录错误文字和时间，但不要公开完整订阅链接。
所有节点都超时，是不是Windows客户端坏了？
不能仅凭全部超时下结论。先检查订阅是否更新、系统时间是否正确、是否有其他代理软件或防火墙冲突，再切换另一网络复测。多个网络仍失败时，提交脱敏日志让服务方核验。
客户端显示已连接，但浏览器打不开怎么办？
关闭其他代理软件，检查Windows代理设置中的手动代理和浏览器旧代理，再用netstat -ano检查本地端口。若只有某个应用失败，还要检查该应用是否读取Windows系统代理。
TUN模式开启后断网如何恢复？
先关闭TUN，恢复到系统代理模式并重新测试。若恢复后正常，再检查虚拟网卡、路由和防火墙；不要在问题未定位前同时修改多个网络参数。
Windows客户端名称在不同BerryHub页面不一样，应该以哪个为准？
当前公开页面存在名称显示差异。本文不对未核实的文件名或版本下结论，建议以BerryHub当前技术支持页实际显示的客户端名称、入口和文件名为准。