# 使用 Homebrew, Nix 安装 whistle

查看 whistle 的安装路径、可执行文件、元数据以及面向 AI 代理工作流的安全说明。

## 安装

```sh
sudo av install brew:whistle
```

其他安装命令:

### macOS

- Homebrew (100%):

```sh
brew install whistle
```

  证据: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#whistle
```

  证据: nixpkgs package indexes: pkgs/by-name/wh/whistle/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## 软件包事实

- **软件包键:** brew:whistle
- **软件包管理器:** Homebrew
- **软件包管理器页面:** <https://formulae.brew.sh/formula/whistle>
- **版本:** 2.10.8
- **来源摘要:** HTTP, HTTP2, HTTPS, Websocket debugging proxy
- **主页:** <https://wproxy.org/>
- **上游文档:** <https://wproxy.org/>
- **许可证:** MIT
- **源码归档:** <https://registry.npmjs.org/whistle/-/whistle-2.10.8.tgz>
- **最后更新:** 2026-08-03T15:31:37Z
- **已生成:** 2026-08-04T22:13:35+00:00

## 可执行文件

- w2 (cli)
- whistle (cli)
- wproxy (cli)
- w2 (别名)
- whistle (别名)
- wproxy (别名)

## 依赖

- node

## 安装行为

- post-install 钩子: 未定义
- Bottle: 可用 于 all

## 版本和新鲜度

- 页面生成时间: 2026-08-04
- 管理器版本: 2.10.8
- 管理器更新时间: 2026-08-03
- 本地数据: OK
- 上游仓库: https://wproxy.org/
- 信息: Release/tag comparison is only available for GitHub repositories.
## 项目历史与用法

whistle is a Node.js-based cross-platform web debugging proxy for HTTP, HTTPS, HTTP/2, WebSocket, and TCP traffic. It sits in the same practical niche as Charles Proxy and Fiddler, but exposes a rule-driven, scriptable, plugin-friendly workflow.

### 项目历史

The avwo/whistle repository was created on March 13, 2015. Its README describes whistle as a cross-platform packet-capture and debugging tool built on Node.js, with request and response inspection, modification, proxy modes, a web interface, and plugin extensibility.

The official documentation centers the project around concise rules. A request URL pattern is matched to an operation, allowing users to rewrite, proxy, mock, inspect, or otherwise modify traffic without writing a full proxy server.

### 采用历史

whistle built a durable audience among web, mobile, and frontend developers who need to debug traffic outside the browser's built-in developer tools. GitHub API metadata showed more than 15,000 stars and more than 1,100 forks on July 2, 2026.

Its adoption is reinforced by the surrounding ecosystem: an official desktop client, plugin development documentation, and common command aliases such as `w2` make it useful both on developer laptops and headless servers.

### 使用方式

Typical usage is to start the local proxy, configure the system or browser proxy, install a root certificate for HTTPS inspection when appropriate, and manage rules through the web UI. Users commonly map production URLs to local files, replay requests, inspect WebSocket traffic, inject headers, mock APIs, or route matching requests through another proxy.

The rule engine is the core package-nerd appeal: a small text rule can replace a temporary local service, a hosts-file edit, a browser extension, or a custom proxy script.

### 为什么软件包爱好者会关心

whistle matters as a package because it brings a GUI-grade debugging proxy into the Node/npm/Homebrew command-line world. It is installable, automatable, extensible with npm-style plugins, and friendly to repeatable debugging setups.

For developers who live in terminal package managers, whistle is the open, scriptable alternative to heavier proprietary proxy applications.

### 时间线

- 2015-03-13: The avwo/whistle GitHub repository was created.
- 2026-07-02: GitHub API metadata showed the repository above 15,000 stars.
- Ongoing: Official docs describe rule syntax, proxy modes, command-line operation, and plugin development as core parts of the project.

### Related projects

- whistle-client is the official desktop client for users who prefer a packaged GUI wrapper.
- Charles Proxy and Fiddler are comparable web debugging proxy tools named in whistle's GitHub topics and package culture.
- Whistle plugins extend the rule engine and web interface for custom debugging workflows.

### 来源

- Official getting started docs: https://wproxy.org/en/docs/getting-started.html
- Official plugin development docs: https://wproxy.org/en/docs/extensions/dev.html
- Official rule syntax docs: https://wproxy.org/en/docs/rules/rule.html
- whistle GitHub API metadata: https://api.github.com/repos/avwo/whistle
- whistle repository and README: https://github.com/avwo/whistle
- whistle-client repository: https://github.com/avwo/whistle-client


## 安全说明

broad file, network, media, or database tool signal.

- **Geiger 风险:** blue / 中
- broad file, network, media, or database tool signal


## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.whistlerc, ~/.WhistleAppData/.whistle/rules, ~/.WhistleAppData/.whistle/values
## 源数据库详情

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** whistle
- **Version Scheme:** 0
- **Revision:** 0
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## 其他软件包管理器记录

- Nix - whistle: normalized package name match | nixpkgs package indexes: pkgs/by-name/wh/whistle/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## 相关链接

- [Secret-risk packages](https://pkg.so/zh-hans/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [Terminal utility packages](https://pkg.so/zh-hans/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Language runtime packages](https://pkg.so/zh-hans/language-runtime-packages/) - Matched language runtime, compiler, or interpreter metadata.
- [Networking and protocol packages](https://pkg.so/zh-hans/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [node](https://pkg.so/zh-hans/brew/node/) - Runtime dependency declared by Homebrew.
- [proxyfor](https://pkg.so/zh-hans/brew/proxyfor/) - Shares pkgdb curated category or tags: cli, http, https, networking, proxy.
- [squid](https://pkg.so/zh-hans/brew/squid/) - Shares pkgdb curated category or tags: cli, http, https, networking, proxy.
- [privoxy](https://pkg.so/zh-hans/brew/privoxy/) - Shares pkgdb curated category or tags: cli, http, networking, proxy.
- [wstunnel](https://pkg.so/zh-hans/brew/wstunnel/) - Shares pkgdb curated category or tags: cli, networking, proxy, websocket.
- [zurl](https://pkg.so/zh-hans/brew/zurl/) - Shares pkgdb curated category or tags: cli, http, networking, websocket.
- [getparty](https://pkg.so/zh-hans/brew/getparty/) - Shares pkgdb curated category or tags: cli, http, networking, proxy.
- [haproxy@2.8](https://pkg.so/zh-hans/brew/haproxy-2-8/) - Shares pkgdb curated category or tags: cli, http, networking, proxy.
- [wwwoffle](https://pkg.so/zh-hans/brew/wwwoffle/) - Shares pkgdb curated category or tags: cli, http, networking, proxy.
- [mitmproxy](https://pkg.so/zh-hans/cask/mitmproxy/) - Local package facts share a topical domain. Shared terms: cli, debugging, http, https, networking.

## Combined YAML source

View the package source record on GitHub. [combined/whistle.yml](https://github.com/mxcl/pkgdb/blob/main/combined/whistle.yml)


## 来源

- pkg.so package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- pkgdb category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph