一、Whistle安装、配置及启动

1、安装Node.js

Whistle是基于Node实现的，Node.js官网：Node.js

2、安装Whistle

不同用户安装详情：安装启动 · GitBook

打开cmd.exe，通过npm进行安装，安装命令：npm install -g whistle

3、启动Whistle：w2 start

启动成功界面：

通过访问本地端口访问whistle Web控制台：http://127.0.0.1:8899/

Whistle常用命令：

启动：w2 start

重启：w2 restart

关闭：w2 stop

4、配置浏览器代理（推荐）

whistle 是通过代理服务来进行工作的，因此需要给请求客户端配置 whistle 的代理，代理地址即  whistle 的监听地址（默认为 http://127.0.0.1:8899/ ）

推荐使用SwitchyOmega浏览（适用chrome、firefox）器插件，在浏览器安装扩展程序后，配置代理服务器为whistle地址，并将浏览器请求切换为whistle代理。

 SwitchyOmega - 情景模式

 可以根据需求新增所需的模式，比如上面的whistle模式，使用的时候，可以选择某一个单独的情景模式，也可以选择auto switch

auto switch：可同时支持多个规则，编写完规则后点击【应用选项】，即可使用

 浏览器访问切换为whistle模式或者默认为whistle的auto switch后，此时浏览器发出的请求就会被whistle抓取

5、抓取 HTTPS 请求

1）下载whistle证书 & 开启HTTPS 请求抓取

whistle 控制台 —> 【HTTPS】 —> 【Download RootCA】，进行证书下载，

勾选【Capture TUNNEL CONNECTs】进行HTTPS 请求抓取

 2）信任whistle配置

下载whistle证书  —> 安装证书   —> 证书存储（受信任的根证书颁发机构），确定完成即可

 3）验证抓取 HTTPS 请求

 6、移动端调试

移动端调试时，whistle和移动端需在同一个局域网内，且移动端设置whistle的代理。

IOS：

whistle 控制台 —> 【HTTPS】扫描二维码，下载证书，

Android ：

whistle 控制台 —> 【HTTPS】扫描二维码，下载证书，去设置中进行安装

二、实例演练：

修改请求方法

pattern：域名或者路径

Rules规则：

pattern method://newMethod

newMethod：不区分大小写

 修改请求头Header

1）Rules规则：

pattern reqHeaders://{newHeader}

2）newHeader为引用的values 变量

 3）发起请求后，查看whistle抓包请求对应的Header改变，如图所示：

改变前：

 改变后：

 修改请求体：

1）Rules规则：

pattern reqBody://{req_body}

2）req_body为引用的values 变量

延迟请求（ms）

Rules规则：

pattern reqDelay://time

Example:
baidu.com reqDelay://60000

请求速度（kb/s）

Rules规则：

pattern reqSpeed://kbs

Example:
baidu.com reqSpeed://256

修改响应状态码

两个方法：

1）Rules规则：

pattern replaceStatus://code

说明：使用 replaceStatus 继续进行请求，并对响应的状态码进行替换；

修改状态码后，whistle及浏览器均显示为修改后的状态码

 2）Rules规则：

pattern statusCode://code

说明：使用 statusCode 后不再发送请求，直接返回设置的状态码。

 修改返回参数

1）Rules规则：

/pattern/ rawfile://{response}

2）response为引用的values 变量

如果报文头出现：content-encoding: gzip，则需要去掉

请求替换

Rules规则中配置模式如下：

pattern http://host:port/xxx

Example：
https://jd.com  https://baidu.com/
jd.com  baidu.com

禁用请求的缓存，只要经过代理且匹配到的请求都不会使用缓存

注：跟 cache 协议的区别是，cache 只是用来设置响应的缓存头

pattern disable://cache

绑定host

注：相当于浏览器层的host文件，如果找不到再去查找本机的host文件

ip pattern

Example：
127.0.0.1 baidu.com

 转换http协议

注：转发协议+域名转发，轻松本地模拟 https ，访问线上的 https 域名实际上指向的是本地的 http 调试地址

pattern http://localhost:port

Example：
https://baidu.com  http://localhost:8080

mock数据

whistle 提供了一个强大的 mock 数据的插件，可以结合 js 语句 + mock 语法去生成数据

mock语法详解：https://github.com/nuysoft/Mock/wiki/Syntax-Specification

注：数据模板定义中的属性名|生成规则、属性值都需要使用双引号，"name|rule"

1）安装插件：

npm i -g whistle.vase

2） Plugins 菜单：

打开 【vase】的界面，新建一个mock数据的配置，并选择模板Engine： mock

 结果展示：

鉴于fiddler安装配置后经常出现配置不当，抓不到包等一系列问题，而使用fiddler只是单纯地想抓个包，故此找到了Whistle来代替，使用起来非常方便和快捷！

1、安装Node（点击下一步，默认安装即可）

注：没有安装包的情况下，访问官网https://nodejs.org/，下载LTS格式的安装包即可

（若公司网下载不稳定，强烈推荐下载腾讯电脑管家，在软件管理里面搜索此工具，可以不限速下载！！！！）

 

2、安装whistle

（cmd模式下输入npm install whistle -g --registry=https://registry.npm.taobao.org即可）

注：安装后输入w2 help，验证是否安装成功，如果成功，则会出现 -V, --version 提示：

3、 启动whistle

（cmd模式下输入w2 start -p 8089）8089是自定义的端口，如果被占用，可以手动更改这里

 4、设置手机代理
服务器：电脑IP地址（cmd命令下，ipconfig可以查看）
端口：8089

5、打开手机浏览器输入电脑IP:8089进入页面

 

7、点击HTTPS生成二维码，点击左上角可直接跳转（ios方法）

下载好证书，到手机设置-通用-描述文件与设备管理，安装证书，到关于本机-证书信任设置里面信任证书

 7.1点击HTTPS生成二维码，点击左上角可直接跳转（android方法）

安卓的要勾选两个选项下载

安卓手机安装时，此证书要安装在CA证书和wifi证书两个位置才能正常抓包和访问网络

 8.打开APP发起请求，在电脑浏览器输入电脑IP:8089可以直接抓到请求

Cmd命令w2 stop可关闭代理抓包 

安装启动

whistle安装过程需要以下步骤(缺一不可)：

1、安装Node
2、安装whistle
3、启动whistle
4、配置代理
5、安装根证书

1. 安装Node

推荐安装最新版本的Node。

如果你的系统已经安装了v0.10.0以上版本的Node，可以忽略此步骤，直接进入安装whistle的步骤，否则：

Windows或Mac系统，访问https://nodejs.org/，安装LTS版本的Node，默认安装即可。

Linux下推荐使用源码安装: 从Node官网下载最新版的Source Code(或者用wget命令下载)，解压文件(tar -xzvf node-vx.y.z.tar.gz)后进入解压后的根目录(node-vx.y.z)，依次执行./configure、./make和./make install。

安装完Node后，执行下面命令，查看当前Node版本

node -v
v8.9.4

2. 安装whistle

Node安装成功后，执行如下npm命令安装whistle （Mac或Linux的非root用户需要在命令行前面加sudo，如：sudo npm install -g whistle）

$ npm install -g whistle

npm默认镜像是在国外，有时候安装速度很慢或者出现安装不了的情况，如果无法安装或者安装很慢，可以使用taobao的镜像安装：

$ npm install cnpm -g --registry=https://registry.npm.taobao.org
$ cnpm install -g whistle

或者直接指定镜像安装：

$ npm install whistle -g --registry=https://registry.npm.taobao.org

whistle安装完成后，执行命令 whistle help 或 w2 help，查看whistle的帮助信息

3、启动whistle

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

启动whistle:

$ w2 start

Note: 如果要防止其他人访问配置页面，可以在启动时加上登录用户名和密码 -n yourusername -w yourpassword。

重启whsitle:

$ w2 restart

停止whistle:

$ w2 stop

4、配置代理

配置信息
代理服务器：127.0.0.1 (如果部署在远程服务器或虚拟机上，改成对应服务器或虚拟机的ip即可)

默认端口：8899 (如果端口被占用，可以在启动时通过 -p 来指定新的端口，更多信息可以通过执行命令行 w2 help (v0.7.0及以上版本也可以使用w2 help) 查看)
勾选上 对所有协议均使用相同的代理服务器

浏览器代理：安装浏览器代理插件 (推荐)

安装Chrome代理插件：推荐安装SwitchyOmega

3、移动端需要在设置中配置当前Wi-Fi的代理，以 iOS 为例：

访问配置页面
启动whistle及配置完代理后，用Chrome浏览器(由于css兼容性问题界面只支持Chrome浏览器)访问配置页面，如果能正常打开页面，whistle安装启动完毕，可以开始使用。

可以通过以下两种方式来访问配置页面：

方式1：域名访问 http://local.whistlejs.com/
方式2：通过ip+端口来访问，形式如e.g. http://127.0.0.1:8899
方式2：通过命令行参数 -P xxxx 自定义webui的端口(xxxx表示要设置的端口号)，自定义端口支持上述两种方式访问，也支持 http://127.0.0.1:xxxx

5. 安装根证书

安装证书请参考文档: http://wproxy.org/whistle/webui/https.html

转自 http://wproxy.org/whistle/webui/https.html