whistle/docs/zh/webui/https.md

Https

建议使用 Node v6 或以上版本，否则性能及在 Chrome 或 APP 上 抓包 HTTPS 请求 会有问题。

如果出现 HTTPS 的问题 (#44)，升级 Node 到 v6 及以上版本，更新 whistle 到最新版本，通过 w2 restart -A (注意后面加 -A)启动生成新的更证书，再 安装下根证书 即可。

** 在 iOS 上安装根证书时，需要先关闭https 拦截，否则将显示安装失败。**

用来下载根证书、隐藏 connect 类型的请求、开启 Https 拦截功能。

安装根证书

如上图下载完根证书后点击 rootCA.crt 文件，弹出根证书安装对话框。

1. Windows：http://program.most.gov.cn/cert/ca.htm
2. Mac：mac 根证书怎么安装

Mac 安装证书后，需要手动信任证书，步骤如下：

打开证书管理界面，找到带有 whistle 的字样的证书，如果有多个又不确定最新安装的是哪个，可以全部删除后重新安装

双击证书后，点击 Trust 左边展开选项，红色部分选择 Always Trust （总是信任），点击左上角关闭当前界面会要求输入密码；输入密码后可以看到证书上面红色的图标 x 不见了，到这一步说明完成证书安装。

3. **Firefox：菜单 > 首选项 > 高级 > 证书 > 证书机构 > 导入 -> 选中所有 checkbox -> 确定 **
4. Linux Chrome(Chromium): 参照这个教程

• 地址栏输入 chrome://chrome/settings/
• Show advanced Settings > Manage certificates > Authorities > Import
• 选择证书后确认，重启浏览器
• done

5. 手机

iOS

• 手机设置代理后，Safari 地址栏输入 rootca.pro，按提示安装证书（或者通过 whistle 控制台的二维码扫码安装，iOS 安装根证书需要到连接远程服务器进行验证，需要暂时把 **Https 拦截功能关掉 **）
• iOS 10.3 之后需要手动信任自定义根证书，设置路径：Settings > General > About > Certificate Trust Testings

具体可以看这里

Android

• whistle 控制台二维码扫码安装，或者浏览器地址栏 rootca.pro 按提示安装
• 部分浏览器不会自动识别 ca 证书，可以通过 Android Chrome 来完成安装

开启拦截 Https

图中的打开的对话框有两个 checkbox(** 在 iOS 安装根证书的时候，记得不要开启 Intercept HTTPS CONNECTs，否则将无法安装成功 **)：

1. Hide HTTPS CONNECTs：隐藏 connect 类型的请求

2. Intercept HTTPS CONNECTs：开启 Https 拦截功能，只有勾上这个 checkbox 及装好根证书，whistle 才能看到 HTTPS、Websocket 的请求

3. 也可以通过配置来开启对部分请求的 Https 拦截功能

   www.test.com filter://intercept /alibaba-inc/ filter://intercept ​

4. 如果想过滤部分请求不启用 Https 拦截功能

   指定域名

   www.baidu.com disable://intercept

   通过正则

   /baidu/ disable://intercept

   不支持通过路径的方式设置