adockero/whistle

adockero/whistle 镜像文档

镜像概述

adockero/whistle是基于npm install -g whistle构建的Docker镜像，提供whistle2版本，主要用于网络请求代理与拦截，特别支持拦截nginx代理之间的请求，解决了w2 status提示无运行的bug。镜像latest标签每2个月自动更新，确保功能时效性。

核心功能与特性

• 问题修复：解决w2 status提示无运行的bug
• 代理拦截：支持拦截nginx代理到另一个nginx之间的请求
• 官方whistle基础：基于npm官方whistle包构建，功能与原生whistle一致
• 数据持久化：数据目录位于/root/.WhistleAppData/.whistle/，支持通过卷挂载保存配置
• 自动更新：latest标签每2个月通过GitHub Actions自动更新，更新状态可查看https://github.com/aogg/dockerfiles/actions/workflows/whistle.yml

使用场景

• 抓包分析nginx代理节点间的HTTP请求流量
• 调试多nginx实例组成的代理架构中的网络问题
• 快速部署whistle工具进行本地或服务器端的网络代理调试

使用方法

adockero/whistle:proxy标签使用

该标签用于将所有流量转发至指定PROXY_ADDR，适用于nginx抓包场景，使用需满足：

• 容器需加入nginx-common网络以访问nginx服务
• 被代理的nginx之间必须通过HTTP协议通信

示例1：默认配置（PROXY_ADDR默认为nginx）

bash
docker run -d --name whistle --restart=always \
--network nginx-common docker.xuanyuan.run/adockero/whistle:proxy

示例2：自定义PROXY_ADDR

bash
docker run -d --name whistle --restart=always \
-e PROXY_ADDR=nginx \
--network nginx-common docker.xuanyuan.run/adockero/whistle:proxy

数据持久化配置

为避免容器重启导致配置丢失，可将数据目录挂载至宿主机：

bash
docker run -d --name whistle --restart=always \
-v /宿主机路径:/root/.WhistleAppData/.whistle/ \
--network nginx-common docker.xuanyuan.run/adockero/whistle:proxy

环境变量说明

更新说明

latest标签每2个月通过GitHub Actions自动构建更新，具体更新时间可通过https://github.com/aogg/dockerfiles/actions/workflows/whistle.yml%E6%9F%A5%E7%9C%8B%E3%80%82