reqable连接失败怎么解决的排查修复教程

当Reqable显示连接失败或无法捕获预期流量时，盲目重装软件往往无济于事。高效的排查应当从观察Reqable顶部的代理状态图标开始，确认系统代理是否真正生效，再逐步检查客户端是否指向正确的代理地址、测试设备是否信任CA证书，以及是否存在端口冲突或上游代理配置错误。这种分层排查法能迅速区分是网络配置问题、证书信任问题还是应用本身的限制，适用于桌面端抓包及手机协同调试场景。

Reqable主界面顶部显示绿色代理状态图标，表示系统代理已正常启用

1. 确认Reqable代理状态

打开Reqable主界面，首先关注工具栏中的系统代理状态图标。正常情况下，该图标应显示为绿色，表示Reqable已成功接管系统代理；若显示为黄色，则意味着系统代理未按预期启用或存在冲突。

点击该状态图标可以切换系统网络代理的开启与关闭。在操作前，建议先记录当前的系统代理设置，以免排查结束后影响其他网络工具的正常使用。如果状态非绿色，尝试点击启用后，重新打开需要测试的客户端浏览器或应用，观察状态是否变绿。注意，Windows、macOS和Linux的系统代理机制不同，Reqable负责写入对应配置，切勿同时在系统设置和其他代理软件中反复修改同一端口，以免产生冲突。

2. 检查客户端是否使用系统代理

并非所有应用都会自动读取系统代理。首先使用一个明确支持系统代理的浏览器（如Chrome或Edge）访问任意HTTP网页，观察Reqable会话列表中是否出现请求记录。

如果浏览器流量能被正常捕获，而目标应用没有任何请求，说明问题很可能出在目标应用未使用系统代理，而非Reqable本身故障。对于支持手动设置代理的应用，需在应用的网络设置中填写运行Reqable的电脑IP地址和代理端口。Reqable桌面代理默认监听9000端口，但若曾在设置中修改过，请以【Proxy】面板中实际显示的端口为准。

在Proxy面板中查看当前监听的代理端口，默认为9000

若是手机协同调试，移动设备的Wi-Fi代理必须指向运行Reqable的电脑局域网IP，而非手机自身地址。部分原生应用会忽略系统代理且不提供手动入口，此类情况下普通系统代理无法生效，不应将其误判为网络故障。

3. 检查网络连通性与IP地址

在使用手机协同或Wi-Fi代理时，必须确保手机和运行Reqable的电脑处于同一局域网内，且网络未启用客户端隔离或访客网络隔离。

在Reqable的【Proxy】设置中查看本机可用的局域网IP地址。手机端的代理工具服务器地址应严格填写此IP。需注意，当电脑切换Wi-Fi、插入网线或连接网络工具时，局域网IP可能会发生变化。若之前连接正常，更换网络后突然失败，应优先检查并更新手机端的代理IP配置。

4. 排查端口占用与冲突

Reqable默认使用9000端口作为桌面代理端口。如果启动时提示端口占用，或代理状态始终无法变绿，需检查是否有其他程序占用了该端口。

常见的冲突来源包括Cla_sh、Charles、Fiddler等其他抓包或代理工具。这些软件可能同时尝试修改系统代理或监听相同端口。不确定冲突源时，可暂时退出其他代理工具，重启Reqable观察状态。若必须更改端口，需在Reqable设置中修改，并同步更新手机端Wi-Fi代理及任何手动配置了代理的应用设置，确保端口号一致。

代理状态显示黄色或提示端口占用，需检查冲突软件

5. 验证HTTPS证书信任

若能捕获HTTP请求但HTTPS请求失败，或显示证书错误、仅见连接建立而无内容，重点检查CA证书。HTTPS抓包依赖于中间人攻击原理，要求测试设备信任Reqable生成的根证书。

在自有或获授权的测试环境中，通过Reqable界面生成或导出CA证书，并按照对应操作系统（Android、iOS、Windows、macOS）的流程安装并设置为“完全信任”。需注意，仅安装证书并不等于信任，部分系统还需在证书管理中手动开启信任开关。此外，某些应用实施了证书固定（Certificate Pinning），会拒绝非官方签名的证书，此类情况无法通过常规安装证书解决，需遵循开发团队的调试方案。

6. 配置Secondary Proxy上游代理

如果当前网络环境访问特定目标需要经过上游代理（如公司内网代理），需配置Secondary Proxy。进入【Proxy】>【Secondary Proxy】>【New Secondary Proxy】创建新配置。

填写上游代理的名称、IP地址和端口，并根据需求选择Include Mode（仅匹配域名走上游）或Exclude Mode（匹配域名绕过上游）。配置完成后，先用一个明确匹配的域名进行测试。若上游代理服务未启动，请求将失败，因此需先确保上游代理可用。注意，Secondary Proxy目前主要支持HTTP代理协议。

在Secondary Proxy中新建上游代理配置，填写IP和端口

7. 调整Windows代理规则格式

在Windows环境下，部分客户端对代理规则格式的兼容性不同。Reqable允许切换代理规则格式，例如直接填写“IP:端口”或分别指定HTTP/HTTPS规则。

若浏览器正常但某特定客户端失败，可在Reqable的代理设置中尝试切换规则格式，然后重启该客户端。修改时建议一次只保留一种格式进行测试，并记录原始值，避免将所有流量导向无效地址导致全网断连。

8. 最小链路验证修复结果

完成上述调整后，按最小链路进行验证：首先确认Reqable代理状态图标变绿；其次用支持系统代理的浏览器发送HTTP请求，确认捕获成功；接着测试HTTPS请求，确认无证书报错；最后测试目标应用或手机协同连接。

成功捕获浏览器发出的HTTP和HTTPS请求，验证连接正常

若仅目标应用失败，保留Reqable日志中的错误信息，重点核对应用的代理设置和证书策略；若所有客户端均失败，则回归检查电脑IP、端口占用及系统代理基础配置。排查结束后，记得关闭不必要的Secondary Proxy配置，并将系统代理恢复至初始状态，以保持网络环境的整洁与安全。