WorkBuddy 网络排查
WorkBuddy 连不上:
Clash 系统代理和 TUN 怎么设。
本文适用于 WorkBuddy 报 3002(网络连接失败)、3003(网络连接超时)或 3007(多与网络环境有关)的场景,假设你使用 Clash Verge Rev / Mihomo(Clash Meta)的系统代理或 TUN。只做网络路径排查,不承诺绕过任何平台规则。
先看官方设置和错误码
WorkBuddy 5.3.0 起内置网络代理切换,入口是“头像 > 设置 > 系统设置 > 网络 > 网络代理”,可选“直接连接”“跟随系统”“手动配置”(例如 http://proxy.corp.com:8080)。修改后立即生效,无需重启,并可点击“测试连接”。官方错误码说明建议确认公司或家庭网络:公司网络联系 IT,家庭网络按排查流程处理,也可以关闭网络代理;3003 在上传或下载时可暂停任务或更换网络/模型。3002/3003 有自动重连,网络恢复后会自动继续。腾讯云 WorkBuddy 常见问题可作补充参考。
| 错误码 | 含义 | 先查什么 |
|---|---|---|
| 3002 | 网络连接失败 | WorkBuddy 代理模式、Clash 是否运行、系统代理是否残留、公司/家庭网络 |
| 3003 | 网络连接超时 | 节点与规则、网络是否稳定;上传下载时按官方建议暂停或换网络/模型 |
| 3007 | 多与网络环境有关 | 当前网络、公司策略、家庭网络排查流程;不需要代理时先关闭网络代理 |
第一步:确认 Clash 端口
打开 Clash Verge Rev 的“设置”,找到“端口设置”或“混合端口”。Clash Verge Rev 常见默认混合端口是 7897,Clash 老版本常见 7890,但不要照抄:以你当前客户端显示的端口为准。混合端口同时支持 HTTP/SOCKS。
第二步:选一种代理方案
方案 A:系统代理 + 跟随系统
- 在 Clash Verge Rev / Mihomo 开启系统代理,并确认 Clash 正在运行、节点已选择。
- WorkBuddy 进入“头像 > 设置 > 系统设置 > 网络 > 网络代理”,选择“跟随系统”。
- 点击“测试连接”,再实际发起一次对话。
方案 B:WorkBuddy 手动配置
- 在 WorkBuddy 网络代理中选择“手动配置”。
- 按 Clash 显示的混合端口填写,例如
http://127.0.0.1:7897。 - 优先使用
http://写法;是否接受socks5://写法未实测,不把它作为默认方案。 - 点击“测试连接”。
不要同时开启系统代理、WorkBuddy 手动代理和 TUN 来叠加测试;先选一种路径,便于从日志判断问题。
第三步:什么时候用 TUN
如果应用不读取系统代理,或 WorkBuddy 选择“跟随系统”仍报 3002/3003,可以考虑在 Clash Verge Rev / Mihomo 中开启 TUN。TUN 通常需要管理员权限或服务模式,具体开关和权限以客户端显示为准。TUN 接管后,WorkBuddy 可选择“直接连接”,避免再次套一层系统代理或手动代理;这是排查时的配置思路,未实测你当前版本的具体行为。
如果你本来不需要代理却报错,按官方建议关闭网络代理,并在 WorkBuddy 选择“直接连接”,再点“测试连接”。
成功标志
WorkBuddy 的“测试连接”通过;Clash 连接或日志页面出现 WorkBuddy 进程或相关域名连接;实际对话能正常返回。仅看到 Clash 开着、或只改了端口,并不能证明请求已经走通。
常见坑
- 端口填错:7897、7890 都只是常见示例,必须以客户端当前显示值为准。
- Clash 没运行或节点为空:本机端口存在不代表已有可用节点。
- 系统代理 + TUN + 手动同时开:多层代理会让路径和日志难以判断,先保留一种方案。
- 公司网络 PAC:公司自动代理配置可能覆盖或限制本地代理,请联系 IT,不要擅自绕过公司策略。
- 规则把相关域名打到 DIRECT:查看 Clash 连接/日志命中的规则;不要只看配置文本。
- 关闭 Clash 后系统代理残留:系统仍指向已停止的本地端口时,可能继续报 3002;不需要代理时关闭系统代理并选直接连接。
常见问答
WorkBuddy 应该选跟随系统还是手动配置?
如果 Clash 已开启系统代理,优先选跟随系统;也可按当前混合端口手动填写 http://127.0.0.1:端口。
什么时候需要打开 TUN?
应用不读系统代理,或跟随系统仍报 3002/3003 时再考虑。开启后 WorkBuddy 可选直接连接,避免双重代理。
Clash Verge Rev 的端口一定是 7897 吗?
不是。7897 和 7890 都只是常见值,以客户端显示的混合端口为准。
关闭 Clash 后仍报 3002 怎么办?
检查系统代理是否残留;不需要代理时关闭网络代理,在 WorkBuddy 选择直接连接。
这个配置能保证一定连通吗?
不能。公司或家庭网络、节点、规则和服务状态都可能影响结果,也不承诺绕过任何平台规则。
打开订阅转换器,生成 Clash 配置 →如果你还要检查订阅生成的规则,可看Clash 规则检查指南;本文仅讨论 WorkBuddy 与本机代理的连接路径。