常见问题

优质

小牛编辑

133浏览

2023-12-01

有问题可以提issue

为什么http://local.whistlejs.com无法访问？没有启动whistle或者配置代理，具体操作请参考安装启动
为什么Network上看不到请求？没有用Chrome浏览器访问http://local.whistlejs.com，或者是请求没有代理到指定的whistle，如何配置代理请参考安装启动
手机或平板如何抓包请求？需要配置代理，且可能要关闭防火墙或者设置运行远程访问本地指定端口，具体参考安装启动
为什么设置的规则对https请求不生效？需要安装根证书及开启https拦截，具体参考https PS: Firefox自带根证书列表，系统根证书对Firefox不生效，需要对Firefox单独安装根证书。
如何查看错误信息？如果是请求出错，可以在Network里面的Request或Response的Text里面看到，有些请求会把异常作为响应内容直接输出到界面；如果是内部运行出现的非致命性异常，可以在Network -> Log -> Server里面看到；如果是导致程序crash的异常，日志信息会写在命令行启动的目录的whistle.log文件。
如何在一台机器同时启多个whistle？可以通过设置不同端口号及不同存储目录来启动不同whistle实例，具体参考命令行操作。
如何实现反向代理的功能？ whistle作为反向代理只支持http访问，启动whistle时设置监听的端口为80:
```
w2 start -p 80
```
如果提示whistle还在运行中，可以执行 w2 restart -p 80 非root用户需要加sudo w2 start -p 80。
这样就可以在whistle配置转发，如果没有配置whistle会自动重定向到抓包界面，如果想直接用机器的IP访问直接访问本机的服务，需要在路径里面加 _ ，这样才能穿透whistle，如果 http://10.1.1.1/_/xxx，whistle会自动转成 http://127.0.0.1/xxx，并在whistle中配如下规则：
```
http://10.1.1.1/xxx 10.1.1.1:5566
```
如何让Rules支持多选？在Rules界面中打开Settings对话框，选中 Use multiple rules 即可。
如何动态设置Rules？ whistle支持以下两种方式动态设置：
- 通过dispatch根据请求信息修改请求url的参数改变url，达到动态修改匹配规则的能力
- 通过插件方式的方式动态设置规则，这种方式更加直接，且功能更强大，基本上可以操作whistle的任何功能，且可以自定义协议功能
如何过滤调部分规则？ whistle支持过滤指定协议的规则，也支持过滤 pattern，具体参见：ignore、filter
安装根证书时无法下载，检查下是否设置好代理。
iOS安装根证书时提示无法连接后台服务器，检查下是否开启了Https拦截功能，如果已开启，请暂时关闭，根证书安装成功再开启。
如何过滤Network上的请求？有三种方式：
- 界面过滤：Networ > Settings
- 搜索过滤：Networ > 下方搜索过滤框
- 后台过滤，参见：enable
安装iOS根证书后，还是提示证书错误？ iOS SSLHandshake: Received fatal alert: unknown_ca，出现这个错误是因为 iOS 10.3 之后需要手动信任自定义根证书，设置路径：Settings > General > About > Certificate Trust Testings
具体可以看这里
更新whistle时出现失败或更新后 w2 -V 指向老的版本，可以参考：更新文档
android 6.0 之后的一些app在成功安装证书后仍然无法对https连接进行手抓包，有可能是该app没有添加信任用户自定义证书的权限。请确认该app是否有如下配置：
```
<base-config cleartextTrafficPermitted="true">
<trust-anchors>
    <certificates src="system" />
    <certificates src="user" />
</trust-anchors>
</base-config>
```
这主要是因为android 6.0之后的版本默认配置发生了变化，更多请看Android开发文档。
如何修改whistle本地存储目录
- 启动命令行指定 -D baseDir
- 配置环境变量 WHISTLE_PATH=baseDir
如何加载自定义证书

新建一个目录(/xxx/ssl)，把自定义证书放到此目录，证书必须后缀为.crt格式，每个证书的key和crt文件名称必须一致(如：test.key、test.crt，支持多域名证书，如果是根证书名字必须为 root.key、root.crt)，启动是时加启动参数 w2 start -z /xxx/ssl 即可