安装 Whistle

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

启动 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抓包监测

在 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 配置页面

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

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

w2 start -n user -w password