基于 Puppeteer 和 Fastify 的视频资源嗅探器 Node.js 版本。
- 🎯 视频资源嗅探（支持 m3u8、mp4 等格式）
- 🌐 页面源码获取
- 📱 支持 PC 和移动设备模拟
- 🔧 自定义正则表达式匹配
- 🚀 高性能 Fastify 服务器
- 🎨 现代化 Web 演示界面
- 📦 支持打包成二进制文件，无需安装 Node.js
- Chrome 浏览器: 系统需要安装 Chrome 浏览器（Puppeteer 依赖）
- Node.js: 从源码运行需要 Node.js >= 18.0.0
- 操作系统: 支持 Windows、Linux、macOS
-
下载对应平台的二进制文件：
- Windows:
pup-sniffer-win.exe - Linux:
pup-sniffer-linux - macOS (Intel):
pup-sniffer-macos - macOS (Apple Silicon):
pup-sniffer-macos-arm64
- Windows:
-
将
demo.html文件放在二进制文件同一目录下 -
直接运行二进制文件：
# Windows - 默认端口启动 ./pup-sniffer-win.exe # Windows - 指定端口启动 ./pup-sniffer-win.exe -port 8080 # Linux/macOS - 默认端口启动 ./pup-sniffer-linux ./pup-sniffer-macos # Linux/macOS - 指定端口启动 ./pup-sniffer-linux -port 8080 ./pup-sniffer-macos -port 8080 # 查看帮助信息 ./pup-sniffer-win.exe --help
-
安装依赖：
npm install
-
启动服务：
# 默认端口启动（自动查找可用端口，从57573开始） npm start # 或直接使用 node 命令 node server.cjs # 指定端口启动 node server.cjs -port 8080 # 查看帮助信息 node server.cjs --help
服务默认在 http://localhost:57573 启动（如果端口被占用会自动查找下一个可用端口）
npm run build# Windows x64
npm run build:win
# Linux x64
npm run build:linux
# macOS x64
npm run build:macos
# macOS ARM64
npm run build:macos-arm构建完成后，二进制文件将输出到 dist/ 目录。
GET /sniffer
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
| url | string | ✅ | 要嗅探的页面 URL |
| mode | string | ❌ | 嗅探模式：0=单个链接，1=多个链接（默认：0） |
| is_pc | string | ❌ | 是否模拟 PC：0=移动设备，1=PC（默认：0） |
| timeout | string | ❌ | 超时时间（毫秒，默认：10000） |
| css | string | ❌ | 等待的 CSS 选择器 |
| script | string | ❌ | 页面执行脚本（Base64 编码） |
| init_script | string | ❌ | 页面初始化脚本（Base64 编码） |
| headers | string | ❌ | 自定义请求头（换行分隔） |
| custom_regex | string | ❌ | 自定义匹配正则表达式 |
| sniffer_exclude | string | ❌ | 排除匹配的正则表达式 |
{
"code": 200,
"msg": "success",
"data": {
"url": "https://example.com/video.m3u8",
"headers": {
"referer": "https://example.com",
"user-agent": "Mozilla/5.0..."
},
"from": "https://example.com/play",
"cost": "2345 ms",
"code": 200,
"msg": "超级嗅探解析成功"
},
"timestamp": 1703123456789
}GET /fetCodeByWebView
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
| url | string | ✅ | 要获取源码的页面 URL |
| is_pc | string | ❌ | 是否模拟 PC：0=移动设备，1=PC（默认：0） |
| timeout | string | ❌ | 超时时间（毫秒，默认：10000） |
| css | string | ❌ | 等待的 CSS 选择器 |
| script | string | ❌ | 页面执行脚本（Base64 编码） |
| init_script | string | ❌ | 页面初始化脚本（Base64 编码） |
| headers | string | ❌ | 自定义请求头（换行分隔） |
{
"code": 200,
"msg": "success",
"data": {
"content": "<!DOCTYPE html><html>...</html>",
"headers": {
"location": "https://example.com"
},
"cost": "1234 ms"
},
"timestamp": 1703123456789
}GET /health
{
"code": 200,
"msg": "success",
"data": {
"status": "ok",
"service": "pup-sniffer"
},
"timestamp": 1703123456789
}GET /active
{
"code": 200,
"msg": "success",
"data": {
"active": true,
"browser": "initialized",
"timestamp": "2023-12-21T10:30:56.789Z"
},
"timestamp": 1703123456789
}注意：以下示例使用默认端口 57573，如果您使用了 -port 参数指定了其他端口，请相应调整 URL 中的端口号。
# 默认端口
curl "http://localhost:57573/sniffer?url=https://example.com/play"
# 自定义端口（如果使用 -port 8080 启动）
curl "http://localhost:8080/sniffer?url=https://example.com/play"curl "http://localhost:57573/sniffer?url=https://example.com/play&mode=1&timeout=15000"curl "http://localhost:57573/sniffer?url=https://example.com/play&is_pc=1"# script 需要 Base64 编码
script_b64=$(echo "console.log('test')" | base64)
curl "http://localhost:57573/sniffer?url=https://example.com/play&script=$script_b64"curl "http://localhost:57573/fetCodeByWebView?url=https://example.com"# 运行测试脚本
npm test注意: 测试前请确保服务器已启动 (npm start)。
| 参数 | 说明 | 示例 |
|---|---|---|
-port <端口号> |
指定服务器端口号 (1-65535) | -port 8080 |
-h, --help |
显示帮助信息 | --help |
端口说明：
- 如果不指定端口号，程序将从 57573 开始自动查找可用端口
- 如果指定的端口被占用，程序会报错并退出
- 端口号必须在 1-65535 范围内
| 变量 | 说明 | 默认值 |
|---|---|---|
| HOST | 服务主机地址 | 0.0.0.0 |
注意: 端口配置请使用 -port 命令行参数，不支持通过环境变量设置端口。
- Chrome 依赖: 需要系统安装 Chrome 浏览器
- 内存使用: Puppeteer 会消耗较多内存，建议在生产环境中监控资源使用
- 超时设置: 建议根据目标网站的加载速度合理设置超时时间
- 并发限制: 当前版本使用单个浏览器实例，高并发场景下可能需要优化
如果遇到 Chrome 启动失败，可以尝试：
- 确保系统已安装 Chrome 浏览器
- 检查系统权限和沙箱设置
- 查看服务器日志获取详细错误信息
如果嗅探失败，可以：
- 增加超时时间
- 检查目标网站是否有反爬虫机制
- 尝试使用自定义正则表达式
- 启用调试模式查看详细日志
项目采用 CommonJS 模块化开发，主要文件：
sniffer.cjs: 核心嗅探类server.cjs: Fastify 服务器test.js: 测试脚本package.json: 项目配置
MIT License