Reqable 使用技术手册以及和Charles的比较Reqable作为现代化的API调试工具，不仅提供了强大的抓包能力

引言：为什么选择Reqable？

在前端开发中，网络调试工具是我们日常工作中不可或缺的伙伴。随着现代前端框架（如Vue 3 + Vite）和API优先开发模式的普及，传统的Charles等工具在某些场景下显得笨重且不够高效。Reqable作为一款现代化的跨平台网络调试代理工具，针对API调试、API测试等常见开发场景进行了深度优化，为开发者带来了全新的体验。

一、快速入门指南

1.1 下载与安装

支持平台

Windows：10/11 (x64 & ARM64)
macOS：10.15+ (Intel & Apple Silicon)
Linux：Ubuntu 18.04+, Debian 10+, Fedora 32+
Android：8.0+ (无需root)

安装步骤

1. 访问官网 https://reqable.com/zh-CN/download
2. 选择对应平台版本下载
3. 安装并启动Reqable
4. 首次启动会自动生成CA证书

1.2 首次配置向导

配置完成后的页面应该如下图：

二、安装证书

不同的桌面端平台（这里主要是Windows/MacOS/Linux），证书安装方式有所不同，为了简化安装过程，Reqable提供了一键安装证书的功能。

证书的安装入口位于顶部操作栏，点击盾牌图标打开弹窗。

点击后系统会弹出确认弹窗或者输入账户密码进行授权，按照提示操作确认即可。不出意外的话，证书会自动安装成功；如果自动安装失败，可以切换到手动安装的Tab按照步骤手动安装。

2.1 移动端安装

如果您有分析移动端应用流量的需求，必须在移动端安装CA根证书，在Reqable中内置了Android和iOS证书安装的指引。

(PS:如果您使用电脑端App进行流量分析，请安装电脑端的CA根证书到移动端设备；如果您使用移动端App直接进行流量分析，请安装移动端的CA根证书到移动端设备。)

小技巧：移动端App初始化选择协同模式并扫码连接电脑后，会自动同步电脑端的CA根证书到当前移动端设备，此时两台设备的CA根证书为同一个。

2.1.1 Android

Android证书分为两种：用户证书和系统证书。用户目录不需要权限即可添加和删除CA证书，系统目录需要Root权限才可以添加和删除CA证书。

Reqable要求用户事先已经在电脑上安装了ADB工具，Reqable会使用ADB工具检查连接到电脑的Android设备的证书安装状态，包括系统证书安装状态和用户证书安装状态。

关于ADB工具

Android Debug Bridge（简称ADB）是Google提供的Android设备连接工具，可以从Android开发者官网下载，下载并安装完成后，配置好ANDROID_HOME和PATH环境变量，重启Reqable即可。

系统证书

无论设备是否Root，Reqable都可以检测系统证书的安装状态。但是，只有Root的设备Reqable才可以一键安装证书（支持Android 5.0 - 15系统）。

如果已经安装了系统证书，可以跳过下一步用户证书的安装。

2.1.1 iOS

在iOS设备上安装证书非常简单，按照下面的操作即可。

首先，下载并安装描述文件（证书）。描述文件可以手动保存，也可以通过浏览器下载。

手动保存：点击右上角导出CA证书，在文件应用的Reqable文档目录下找到导出的CA证书，并手动复制或移动到上一级目录，点击证书后出现提示已下载描述文件。
浏览器下载：点击证书自动打开浏览器下载，下载完成后自动出现提示已下载描述文件。

第二步：打开设置 -> 下载的描述文件 -> 选择文件 -> 安装刚刚下载的描述文件。

第三步：信任证书，设置 -> 通用 -> 关于 -> 证书信任设置 -> 打开开关。

三、核心功能详解

3.1 开启调试

首先，需要启用Reqable的调试功能，点击最右上角的启动按钮进入调试状态。在调试状态下，任何HTTP请求经过Reqable的MITM代理服务器都会显示到界面上。

为了保证流量经过Reqable的MITM代理服务器并信任Reqable的CA根证书，请检查下面两项：

系统代理状态

如果系统代理已经设置，网络图标是绿色；如果系统代理未设置，网络图标是黄色，点击网络图标可以自动设置系统代理。

CA根证书状态

如果CA根证书安装成功，盾牌图标是绿色；如果CA根证书未安装成功，网络图标是黄色，点击盾牌图标可以进入CA根证书安装界面，详细步骤请阅读安装证书。

一切就绪后，我们可以看到如下的界面：

(PS:如果是调试手机等远程设备:

手机与电脑都连接到同一个局域网。
手机Wi-Fi代理已设置Reqable的IP地址和端口号（见Reqable窗口顶部），或者使用SocksDroid进行转发。
手机上已正确安装CA证书。
电脑网络防火墙已开放Reqable的端口地址。 )

3.2 浏览器调试

打开浏览器，输入地址 https://wwww.baidu.com 并回车，这里演示使用的是Chrome浏览器。回到Reqable，调试列表中已经捕获到了该网站的全部请求数据。

3.3 API测试

Reqable支持直接对API进行测试，支持HTTP1、HTTP2和HTTP3（QUIC）协议，下面讲解如何创建一个API并发送请求。

新建API

点击标签栏的 + 按钮，新建一个API会话。

3.4 协同模式（重点）

Reqable是全平台应用程序，包括独立的移动端Android App和iOS App，移动端App支持两种工作模式，分别是独立模式和协同模式。

独立模式：无需电脑客户端，直接在手机上分析应用程序流量以及进行API测试。
协同模式：手机端流量转发到电脑端Reqable进行分析和实施各种调试操作。

协同模式具有下面这些优点：

无需设置手机Wi-Fi代理，即可在电脑上拦截和操作手机流量。
基于VPN机制，支持更加全面的流量拦截。
自动同步电脑根证书到手机，方便后续安装证书。
Android平台还支持获取到流量所属的应用信息。

如何配置

在电脑端Reqable打开二维码页面，如下：

安装Reqable移动端App并启动，初始化选择协作模式，并扫描上一步桌面端的二维码。

连接成功后，Reqable会自动将电脑端的根证书同步到手机端。Reqable移动端会记住远程设备（电脑）的IP地址和端口，下一次启动会自动进行连接。如果远程设备（电脑）的IP地址和端口发生变化，在侧边栏点击扫码图标重新扫描即可。

如果已经初始化了Reqable手机端App，你可以从侧边栏的远程设备中点击右上角的+按钮添加电脑端设备。下一步，我们开始安装根证书，这可能是整个过程最复杂的一步。

由于Reqable桌面端的根证书已经被同步到了移动端，因此不需要打开浏览器输入xxx地址下载根证书了，直接在移动端保存根证书即可。打开侧边栏，点击证书管理页面，进行证书相关的操作。

最后，点击右下角的调试按钮，允许通知和VPN服务，进入调试模式。

当手机端进入调试模式后，Reqable桌面端也会自动进入调试模式。当在手机端发送网络请求时，在电脑端便可以看到访问的请求流量了。

可以看到，手机端的流量已经显示在Reqable桌面端了，后续我们可以在桌面端进行断点、重写、脚本等功能的处理。

四、和Charles核心功能对比

1.1 代理抓包能力

功能点	Charles	Reqable
HTTP/HTTPS抓包	✅ 完善支持	✅ 完善支持
HTTP/2抓包	✅ 支持	✅ 更好支持
HTTP/3(QUIC)抓包	❌ 不支持	✅ 全球首个支持
WebSocket抓包	✅ 支持	✅ 可视化更佳
gRPC抓包	需要插件	✅ 原生支持

1.2 用户界面

Charles：

传统的桌面应用界面
功能菜单层次较深
深色主题需要付费版本

Reqable：

现代化的Material Design 3设计
直观的功能分区
深色/浅色主题免费提供
支持界面布局自定义

1.3 证书安装

# Charles证书安装流程
1. 访问chls.pro/ssl下载证书
2. 手动安装到系统钥匙串
3. 手动信任证书（多个步骤）
4. 可能需要重启应用

# Reqable证书安装流程
1. 一键点击“安装CA证书”
2. 系统级自动安装（支持Android免root）
3. 自动完成信任配置
4. 无需重启立即生效

1.4 自动化能力