安装 Whistle

1. 如果没有安装 Node.js 先安装， 访问官网下载安装包： https://nodejs.org/
   1. 不确定是否安装，可用终端或cmd检查： node -v
2. 使用 npm 安装 Whistle
   1. npm install -g whistle
3. 确认安装结果
   1. 输入命令，如果有返回结果意味着安装成功 `w2 help’

官方文档：http://wproxy.org/whistle/

启动 whistle

w2 start

最新版本支持三种等价命令 w2、whistle、wproxy

whistle重启、停止、调试模式命令

重启whistle

w2 restart

停止whistle

w2 stop

whistle调试模式

w2 run

MacOS、Windows、iOS、Android使用whistle抓包监测

• 手动配置代理，IP 和 端口在启动 whistle 命令后可以看到（第二个，不是 127.0.0.1 那个）
• 如果手机遇到访问无网络，确认电脑是否可以正常操作，如果正常多试试（访问页面、开关wifi、重启whistle）或等一会。

HTTPS 加密协议使用whistle抓包监测

HTTPS、Websocket需要开启HTTPS拦截才可以正常抓包及使用所有匹配模式

在 whistle 控制台点击顶部“HTTPS”菜单

设备配置好代理

电脑：点击直接下载和安装证书

手机：扫描二维码或直接访问 http://rootca.pro （如果没有配置代理无法访问）

iOS 需要使用 Safari 访问，不然无法安装证书。下载好证书需要手动去设置安装，操作位置：设置——通用——VPN与设备管理——描述文件：whistle.**

解决iOS安装证书后whistle依旧提示证书错误未受信任

在 iOS 10.3 之后需要手动信任自定义根证书，设置位置：设置——关于本机——证书信任设置——whistle.**

whistle 升级更新

⚠️ 执行升级安装更新前请先停止 whistle 不然更新会报错。（停止命令 w2 stop）

npm i -g whistle

如果更新失败，使用超级管理员再次尝试

sudo npm i -g whistle

访问配置页面

可通过多种方式访问

1. 域名： http://local.whistlejs.com/
2. IP+端口，如：http://127.0.0.1:8899 （如果修改了端口，访问时修改为对应端口）
3. 通过命令 -P 6789 自定义端口： http://127.0.0.1:6789 （6789 为自定义，可自行配置）

whistle 配置 socks 代理抓取检测指定域名数据

配置入口

• 启用 whistle 后，在界面左边点开规则配置按钮【Rules】，打开规则配置界面
• 输入所需规则并保存，可通过 Ctrl（Command） + S 快捷键保存

配置方式和规则

• pattern socks://ip:port
  • pattern 要处理的域名，可以用通配符或者正则
  • socks://ip:port，你的 socks 代理的IP和端口，具体以你 socks 软件提供的为准
    • socks://username:password@ip:port 加账号和密码的配置方式，username 替换你的用户名，password 替换你的密码
• 注释方式：在一行以开头#可输入注释信息

全部域名都走 socks 代理

* socks://127.0.0.1:1080

指定域名走 socks 代理

play.google.com socks://127.0.0.1:1080

问题

• socks IP 使用局域网IP（同 whistle 配置）会无效，建议如果socks在本机配置，直接使用 127.0.0.1

相关文档

• socks
• 匹配模式
• 配置方式

更多使用指南

• 常用功能讲解Whistle 开发调试最佳实践 - 知乎

其他骚操作

防止他人访问 whistle 配置页面

在启动命令上加登录用户名和密码。

user为用户名，password为密码，请自行替换

w2 start -n user -w password

设置延迟响应 resDelay

• 使用 resDelay 参数可以模拟弱网环境
• 需要确保whistle是最新版本，配置方式：
  • timeMS: 参数单位为毫秒
  • 1000 毫秒（ms） = 1 秒（s）

pattern resDelay://timeMS

示例：

# baidu.com 全部子域包括www
*.baidu.com resDelay://3000

# 全部网站或请求
* resDelay://3000

设置响应速度 resSpeed

• 使用 resSpeed 参数可以模拟弱网环境
• 需要确保whistle是最新版本，配置方式：
  • kbs: 参数单位为每秒的响应速度为多少kb，比如每秒500k

pattern resSpeed://kbs

示例

# baidu.com 全部子域包括www，每秒3k
*.baidu.com resSpeed://3
# 全部网站或请求，每秒160k
* resSpeed://160

使用 resDelay 和 resSpeed 配置 App 弱网环境 Tunnel 报 captureError 错误如何处理？

1. 配置 resDelay 和 resSpeed 后部分app无法访问网络，但是网页版可以正常访问
2. 首先确认 https 是否正常，是否可以抓取 ssl 请求。（是否按照 whistle证书，安装后是否授权确认）
3. 如果确认 https 正常还是有 captureError 报错，可以将对应域名设置 disable://capture ，设置解析次域名 https 请求
4. 设置 disable://capture 后，使用 resDelay 和 resSpeed 后，部分域名请求没有起作用
5. 在 disable://capture 后增加 enable://inspect 参数，然后在对应请求：「点击右键」——「选择 Action」——「再选择 Abort」

示例，解决 Google Play 网页版可以访问 App 无法访问的问题

* socks://127.0.0.1:1080
* resSpeed://160
* resDelay://3500
disable://capture enable://inspect *.googleapis.com *.googleusercontent.com *.google.com *.gstatic.com *.gvt2.com *.apis.google.com *.googlevideo.com

运行过程中，也会报 captureError 的域名

*.appsflyersdk.com *.facebook.com *.isnssdk.com *.tiktokv.com *.jianguoyun.com *.volceapplog.com *.samsung.com.cn *.ytimg.com *.fbcdn.net *.rayjump.com *metrozone.newsroomlabs.com *.gos-gsp.io *.pddpic.com *.pinduoduo.com

whistle 相关 Github Issues： #961 #981 #865