Whistle Rules 配置指南

本文档提供了HKbitEX项目中whistle代理工具的规则配置，包括用户端和管理端在不同环境下的代理规则配置。

概述

Whistle是一个基于Node.js的跨平台抓包调试代理工具，通过配置rules规则可以实现请求的重定向、修改、拦截等功能。

💡 使用场景
🔄 API接口切换（测试/UAT/预生产环境）
🐛 前端调试和接口模拟
🌐 跨域问题解决
📡 请求拦截和修改

🎯 环境配置

Test 环境

bash

# 代理页面
/https?\:\/\/www\.hkbitex-test\.com\/(.*)/  http://127.0.0.1:3000/$1
# 代理开发服务器websocket连接
/wss?\:\/\/www\.hkbitex-test\.com\/_next\/(.*)/  ws://127.0.0.1:3000/_next/$1

UAT 环境

bash

# 代理页面
/https?\:\/\/www\.hkbitex-uat\.com\/(.*)/  http://127.0.0.1:3000/$1
# 代理开发服务器websocket连接
/wss?\:\/\/www\.hkbitex-uat\.com\/_next\/(.*)/  ws://127.0.0.1:3000/_next/$1

Pre 环境

bash

# 代理页面
/https?\:\/\/www\.q2tx\.net\/(.*)/  http://127.0.0.1:3000/$1
# 代理开发服务器websocket连接
/wss?\:\/\/www\.q2tx\.net\/_next\/(.*)/  ws://127.0.0.1:3000/_next/$1

📋 常用规则说明

域名代理

bash

# 将请求从源域名代理到目标域名
source.domain.com target.domain.com

本地代理

bash

# 将域名代理到本地服务器
domain.com 127.0.0.1:3000
domain.com localhost:3000

CORS处理

bash

# 添加CORS响应头
domain.com resCors://*

请求头修改

bash

# 添加请求头
domain.com reqHeaders://header-name=header-value

SSL证书忽略

bash

# 忽略SSL证书错误
domain.com reqIgnoreCert://

WebSocket代理

bash

# WebSocket连接代理
ws://source.com ws://target.com
wss://source.com wss://target.com

⚠️ 注意事项

🚨 重要提醒
💡 使用前确保whistle服务正常运行
🔒 HTTPS代理需要安装并信任根证书
🌐 确保目标环境域名可正常访问
🔄 切换环境时记得更新对应的规则配置
🎯 本地开发时注意端口号配置
📱 移动端调试需要配置手机代理

Whistle Rules 配置指南 ​

概述 ​

🎯 环境配置 ​

Test 环境 ​

UAT 环境 ​

Pre 环境 ​

Test 环境 ​

UAT 环境 ​

Pre 环境 ​

📋 常用规则说明 ​

域名代理 ​

本地代理 ​

CORS处理 ​

请求头修改 ​

SSL证书忽略 ​

WebSocket代理 ​

⚠️ 注意事项 ​

📚 相关链接 ​

Whistle Rules 配置指南

概述

🎯 环境配置

Test 环境

UAT 环境

Pre 环境

Test 环境

UAT 环境

Pre 环境

📋 常用规则说明

域名代理

本地代理

CORS处理

请求头修改

SSL证书忽略

WebSocket代理

⚠️ 注意事项

📚 相关链接