中文 · English

Whistle 是一款功能强大的跨平台网络抓包调试工具，本客户端为官方桌面版本，支持以下操作系统：

1. macOS
2. Windows
3. Linux (Fedora/Ubuntu)

请根据你的操作系统选择对应的安装步骤。

安装完成后，请通过以下方式启动：

1. 点击桌面上的 Whistle 图标
2. 或通过系统应用程序菜单找到 Whistle

启动后，请按以下步骤完成必要的初始设置（首次运行时必做）：

1. 打开客户端顶部 Whistle 菜单项
2. 点击 Install Root CA：安装系统根证书，用于解析 HTTPS 请求
3. 开启 Set As System Proxy：设置系统代理，用于捕获系统的 Web 请求

1. Proxy Settings：见下方 Proxy Settings
2. Install Root CA：安装根证书
3. Check Update：查看是否有新版本
4. Set As System Proxy：设置系统代理
5. Start At Login：是否开机自动启动 Whistle 客户端
6. Restart：重启客户端
7. Quit：退出客户端

1. Proxy Port：必填项，代理端口，默认为 8888
2. Socks Port：新增 Socksv5 代理端口
3. Bound Host：指定监听的网卡
4. Proxy Auth：设置用户名和密码对经过代理的请求进行鉴权
5. Bypass List：不代理的白名单域名，支持以下三种格式：
   • IP：127.0.0.1
   • 域名：www.test.com
   • 通配符：*.test.com（这包含 test.com 的所有子代域名）
6. Use whistle's default storage directory：存储是否切回命令行版本的目录，这样可以保留之前的配置数据（勾选后要停掉命令行版本，否则配置可能相互覆盖）

1. 点击左侧导航栏的 Plugins 标签页
2. 点击顶部的 Install 按钮
3. 在弹出窗口中输入插件名称（支持同时安装多个插件）：
   • 多个插件用空格或换行符分隔
   • 可指定自定义 npm 镜像源：
     • 直接在插件名后添加 --registry=镜像地址
     • 或从下拉列表选择历史使用过的镜像源

示例（安装两个插件并使用国内镜像源）：

w2 install --registry=https://registry.npmmirror.com whistle.script whistle.inspect

Whistle 功能详见：https://github.com/avwo/whistle

查看抓包界面是否有如下的 captureError 异常请求：

将出现此类异常的域名配置到 Proxy Settings 的 Bypass List 规则里面：

• 检查新版本：点击左上角 Whistle 菜单 → Check Update → 按照提示完成更新
• 手动下载更新：访问 GitHub Releases 下载最新版本，按上面的文档重新安装

Whistle 客户端默认使用独立的存储目录，如果要继续用命令行版本的目录，可以通过 Proxy Settings 的 Use whistle's default storage directory 切回命令行的默认目录：

注意：请确保同一时间只有一个 Whistle 实例访问该目录，多实例同时运行会造成配置冲突和数据覆盖！

MIT