{ "componentChunkName": "component---src-templates-issues-tsx", "path": "/issues/607", "result": {"data":{"issuesJson":{"id":"e39f422c-709c-5434-b840-3a87a583f78b","title":"avwo/whistle: 基于 Node 实现的跨平台本地抓包调试工具","number":607,"bodyHTML":"
\n



\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Reposavwo/whistle
Views\"views\"
Stars\"stars\"
Forks\"forks\"
License\"license\"
UpdatedAt\"last-commit\"
CreatedAt\"create-at\"
\n\n

\"\"

\n\n
\n

\n \n \"whistle\n \n

\n

whistle

\n

\"NPM
\n\"node
\n\"Test
\n\"npm
\n\"NPM
\n\"License\"

\n

中文 · English

\n

Whistle 是一个基于 Node.js 开发的功能强大、操作简单的跨平台抓包调试工具。它支持多种代理模式（如 HTTP、HTTPS、Socks、反向代理等），可用于抓包分析或通过配置规则修改 HTTP、HTTPS、HTTP/2、WebSocket、TCP 请求。Whistle 还内置了 Weinre、Log、Composer 等工具，支持查看远程页面的 DOM 结构、调试 console 输出、重放或编辑请求等。此外，Whistle 支持插件扩展，也可作为 NPM 包被其他项目引用。

\n

安装

\n

Windows PC 或 Mac PC 推荐使用客户端：https://github.com/avwo/whistle-client。

\n
\n

如果采用 Whistle 客户端可以跳过该安装步骤

\n
\n

Linux PC、服务器等其它系统可以用命令行版本，需严格按如下 4 个步骤安装：

\n
    \n
  1. 安装 Whistle
    2. \n
  2. 启动 Whistle
    3. \n
  3. 安装根证书
    4. \n
  4. 设置代理
    5. \n
\n

安装 Whistle

\n

根据实际情况选择以下一种安装方式即可：

\n
    \n
  1. \n

    通过 npm 安装（需要先安装 Node.JS：https://nodejs.org/ ）：

    \n
    npm i -g whistle
    \n
    2. \n
  2. \n

    通过 brew 安装（需要先安装 brew：https://brew.sh/ ）：

    \n
    brew install whistle
    \n
    3. \n
\n

启动 Whistle

\n
w2 start
\n
\n

Whistle 默认启动 HTTP 代理（IP：127.0.0.1，端口： 8899），可以通过 w2 start -p 8888 修改端口，如果已启动需要通过 w2 restart -p 8888 重启修改端口

\n
\n

完整命令行功能参见完整文档：https://wproxy.org/whistle/options.html

\n

安装根证书

\n

启动 Whistle 后可以通过下面的命令安装根证书：

\n
w2 ca --enable-https
\n
\n Windows 需要最后点击 “是(Y)” 确认\n \"点击\n
\n
\n Mac 需要输入开机密码或指纹验证\n \"输入开机密码\"\n \"输入指纹\"\n
\n

手机等其它端如何安装根证书参见完整文档：https://wproxy.org/whistle/webui/https.html

\n

设置代理

\n

Windows PC 或 Mac PC 有以下四种方式，根据实际情况选择其中一种即可：

\n
    \n
  1. \n

    【推荐】 通过安装 Chrome 插件 SwitchyOmega 设置代理：https://chromewebstore.google.com/detail/proxy-switchyomega/padekgcemlokbadohgkifijomclgjgif

    \n
    \n

    Chrome 应用商店需要翻墙，如果无法访问请手动安装：https://proxy-switchyomega.com/download/

    \n
    \n
    \n SwitchyOmega 设置方法示例图\n\t\"image\"\"image\"\n
    \n
    2. \n
  2. \n

    通过命令行设置系统代理：

    \n
    w2 proxy\n
    \n
    \n

    也可以指定IP（默认127.0.0.1）和端口： w2 proxy \"10.x.x.x:8888\" ，关闭系统设置代理用 w2 proxy 0

    \n
    \n
    3. \n
  3. \n

    直接在客户端上设置代理，如 FireFox、微信开发者工具等内置了设置代理功能

    \n
    \n FireFox 设置代理示例图\n \"image\" \n
    \n
    4. \n
  4. \n

    通过 Proxifier 设置代理（针对无法设置代理且不使用系统代理的客户端）：https://www.proxifier.com/docs/win-v4/http-proxy.html

    \n
    5. \n
\n

Linux 设置路径: Settings > Network > VPN > Network Proxy > Manual

\n
\n Linux 设置代理示例图\n \"image\"\n
\n

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

\n
\n iOS 设置代理示例图\n \"image\"\n
\n

使用

\n

按上面步骤安装好 Whistle，在 Chrome 浏览器上打开链接 http://local.whistlejs.com ，即可看到如下操作界面：

\n\"network\"\n\"rules\"\n

其中，Network 为查看抓包界面，Rules 为配置规则，Values 为配置数据界面（配合 Rules 使用），Plugins 为已安装的插件列表。

\n

界面功能

\n
\n 重放请求\n \"image\"\n
\n
\n 编辑或构造请求\n \"image\"\n
\n

其它界面功能参见完整文档：https://wproxy.org/whistle/webui/

\n

规则功能

\n

Whistle 规则可看成是如下系统 hosts 规则的扩展：

\n
# 一个域名对应一个 IP\n127.0.0.1 localhost\n::1 localhost\n# 多个域名对应一个 IP\n10.2.55.3 www.test.com www.example.com
\n

系统 hosts 规则的功能单一，只支持修改 DNS及匹配域名，且有 DNS 缓存问题，无法满足日常工作需求，Whistle 规则扩展了系统 hosts 规则的功能，匹配方式上不仅支持域名匹配、路径匹配、通配符匹配、正则匹配等，还支持通过请求方法，响应状态码、请求（响应）头、请求内容等进一步过滤；功能上不仅支持修改 DNS，还支持修改端口，CNAME，设置代理，修改请求 URL、请求方法、响应状态码、请求头、响应头、请求内容、响应内容等，理论上可以修改 HTTP 请求的所有东西，Whistle 规则格式为：

\n
    \n
  1. \n

    默认格式

    \n
    pattern operation
    \n
    2. \n
  2. \n

    支持匹配多个操作

    \n
    pattern operation1 operation2 ...
    \n
    3. \n
  3. \n

    支持过滤器

    \n
    pattern operation1 operation2 ... includeFilter://filterPattern1 ... excludeFilter://filterPatternN ...
    \n
    \n

    多个 filter 之间是 或 的关系，即满足其中一个条件即可

    \n
    \n
    4. \n
  4. \n

    支持位置调换（前提：operation 与 pattern 不同时为 URL 或域名）

    \n
    operation pattern [filters ...]\noperation pattern1 pattern2 ... [filters ...]
    \n
    5. \n
  5. \n

    支持换行

    \n
    line`\noperation\npattern1\npattern2 ...\n[filters ...]\n`
    \n
    6. \n
\n

具体例子如下：

\n
修改 DNS（设置 Hosts）
\n
    \n
  1. \n

    域名匹配

    \n
    www.test.com 127.0.0.1\n# 支持带端口\nwww.test.com 127.0.0.1:8080\n# CNAME 功能（端口可选）\nwww.test.com host://www.example.com:8181
    \n
    \n

    与系统 hosts 规则不同的是 Whistle 规则默认采用从左到右的映射方式，从上到下的优先级，但在 operation 与 pattern 不同时为 URL 或域名情况下可调换位置，所以也兼容系统 hosts 规则，即：127.0.0.1:8080 www.test.com

    \n
    \n
    2. \n
  2. \n

    路径匹配

    \n
    www.test.com/path/to 127.0.0.1:8080\n# 支持带协议\nhttps://www.test.com/path/to 127.0.0.1:8080
    \n
    3. \n
  3. \n

    通配符匹配

    \n
    # 域名通配符，匹配 test.com 的所有子代域名\n**.test.com 127.0.0.1:8080\n# 支持带协议域名通配符\nhttps://**.test.com 127.0.0.1:8080\n# 路径通配符（* 是路径的合法字符，所以前面要加 ^ 告诉 Whistle 是通配符）\n^**.test.com/*/path/to 127.0.0.1:8080\n# 支持带协议路径通配符\n^https://**.test.com/*/path/to 127.0.0.1:8080
    \n
    \n

    *、**、*** 匹配的范围不同，详情参见完整文档：https://wproxy.org/whistle/pattern.html

    \n
    \n
    4. \n
  4. \n

    正则匹配

    \n
    # 内部的 `/` 可以不转义，等价于 `new RegExp('^https?://\\w+\\.test\\.com')`\n/^https?://\\w+\\.test\\.com/ 127.0.0.1:8080
    \n
    5. \n
  5. \n

    过滤匹配

    \n
    # `pattern` 同上面的域名、路径、正则，表示除了匹配 `pattern` 还要满足请求头 `cookie` 包含 `env=test`\npattern 127.0.0.1:8080 includeFilter://reqH.cookie=/env=test/
    \n
    6. \n
\n
修改表单数据
\n
# 修改表单里面的 `test` 字段的值\npattern reqMerge://test=123\n\n# 删除表单里面的 `abc` 字段\npattern delete://reqBody.abc
\n
设置跨域响应头
\n
# 以路径匹配为例，设置跨域响应头 Access-Control-Allow-Origin: *，且排除 OPTION 请求\npattern resCors://* excludeFilter://m:option
\n

所有规则参见完整文档：https://wproxy.org/whistle/rules/

\n

安装插件

\n

插件需通过命令行安装：

\n
w2 i whistle.inspect whistle.vase
\n
\n

上述插功能介绍及源码：https://github.com/whistle-plugins，客户端可通过界面安装 ：https://github.com/avwo/whistle-client

\n
\n

安装后即可在管理界面的 Plugins 看到这两个插件：

\n
\n 插件列表示例图\n \"image\"\n
\n

每个插件默认可以新增两个规则协议：

\n
whistle.inspect://xxx\ninspect://xxx
\n
\n

通过配置插件的自定义规则，可将匹配的请求转发到插件指定 hook 实现自定义功能，如果不需要也可通过插件的 package.json 的 whistleConfig 设置 \"hideLongProtocol\": true 或 \"hideShortProtocol\": true 隐藏对应规则协议

\n
\n

除了扩展规则，插件还支持扩展 Whistle 界面，以及提供操作界面、自带规则等功能，关于插件的安装、使用、开发参见完整文档：https://wproxy.org/whistle/plugins.html

\n

License

\n

MIT

","updatedAt":"2025-05-22T01:53:13Z","upvoteCount":null,"author":{"login":"eryajf","avatarUrl":"https://avatars.githubusercontent.com/u/33259379?u=e4a4090a38ac2473aaed4ef9945233636776c6c3&v=4","url":"https://github.com/eryajf"},"category":null,"labels":{"edges":[{"node":{"name":"更多","color":"25B472"}},{"node":{"name":"抓包工具","color":"9fb26a"}},{"node":{"name":"avwo","color":"6ea428"}}]},"comments":{"edges":[]}}},"pageContext":{"number":607,"previous":{"title":"P3GLEG/Whaler: 能够查看在运行容器的 Dockerfile 的工具","number":606},"next":{"title":"traefik/whoami: 一个提供根据请求返回内容的调试工具。","number":608}}}, "staticQueryHashes": ["151096407","2861350382"]}