Skip to content

Latest commit

 

History

History
213 lines (157 loc) · 7.57 KB

README.md

File metadata and controls

213 lines (157 loc) · 7.57 KB
Raw

LivePool

Fiddler Like cross platform debugging proxy for web developers base on NodeJS

LivePool 是一个基于 NodeJS，类似 Fiddler 支持抓包和本地替换的 Web 开发调试工具，是 Tencent AlloyTeam 在开发实践过程总结出的一套的便捷的 WorkFlow 以及调试方案。

版本

version: 0.7.5

特性

  • 基于 NodeJS, 跨平台
  • 支持 http 抓包和本地替换调试，Https/WebSockets 直接代理转发（暂不支持本地替换）
  • 便捷的 UI 管理界面，跟 Fiddler 类似，降低学习成本
  • 可以脱离 UI 后台运行，适应于某些不需要抓包，只需要使用替换和简单路由的场景
  • 基于项目的替换规则管理，方便高效，规则支持拖曳排序
  • 支持基于请求路径的本地文件替换，支持基于请求路径的路由转发（host 配置）
  • 替换类型支持：文件/文件夹替换，combo合并替换，qzmin替换（批量combo)，delay延时等
  • 支持自动设置系统代理
  • 支持规则过滤，只显示关注的请求
  • 提供构建 http get/post 请求界面，方便接口调试
  • 特色功能：模拟gprs/3g等低网速（mac only）
  • 特色功能：支持离线站点到本地，并自动代码格式化

安装

从 git 下载安装

  • 下载， 运行 livepool
git clone https://github.com/rehorn/livepool
  • 安装依赖
cd ~/livepool
npm install
  • 运行 livepool
node livepool.js

使用 npm 进行全局安装

npm install livepool -g
  • 运行 livepool
livepool

使用

局域网调试（如 wifi局域网）

调试移动 web 页面

  • 将手机的 wifi 连接代理设置为：服务器 192.168.1.*(对应的局域网 ip)，端口 8090
  • 打开浏览器测试

效果图

界面说明

界面说明

  1. 菜单区
  2. Session（显示所有http请求信息）
  3. TreeView（使用树状结构显示Session信息）
  4. 功能Tab: Pool（按照项目管理本地替换规则）
  5. 功能Tab: Inspector (session查看器，查看请求header，body等信息)
  6. 功能Tab: Composer（http请求模拟器，可以模拟http get/post请求）
  7. 功能Tab: Filter（session过滤器，根据规则过滤session，只保留关注的）
  8. 功能Tab: Log（日志显示）
  9. 功能Tab: Timeline（session时间轴，comming soon）
  10. 功能Tab: Statics（统计，对站点性能进行评估，comming soon）

使用 LivePool 进行抓包

拦截所有的 http 请求，查看分析请求内容

设置代理

浏览器代理

手动将浏览器代理设置为 127.0.0.1:8090, Chrome 可使用 SwitchSharp 等插件进行代理切换，这样浏览器发出的所有的请求就能通过 livepool 中抓取

系统全局代理

livepool 可以设置系统全局代理，实现系统所有 http 请求的抓取

效果图

在 Session 中浏览请求

效果图

  • 灰色背景：命中本地替换规则，并返回了本地内容的请求
  • 绿色：js 请求
  • 玫红：css 请求
  • 蓝色：json 请求
  • 黑色：其他类型请求

使用 inspector 查看请求内容

效果图

http request

可以查看http request的header，cookie等信息

http response

可以查看http response的header，cookie，视图等信息

视图切换

可以查看图片、JSON、文本代码，并且对代码进行格式化，快速添加替换规则

tips: 便捷操作

  • 双击 sesssion 区域请求，快速查看请求内容
  • 在 TreeView 中节点，快速滚动到该请求，并查看对应请求内容
  • 右键复制请求 url
  • 右键在浏览器打开该 url
  • 右键 replay，再次发起该请求

本地替换开发

将浏览器请求替换为本地文件，进行线上调试或本地开发，修改立刻生效

效果图

新建项目

填写项目名称和根目录

效果图

新建替换规则

填写handler替换规则或router路由规则

效果图

文件替换规则

效果图

延时规则

将请求阻塞指定的时间，再返回给浏览器，可以用来测试极端网络下资源阻塞的页面表现

combo规则

将本地的多个文件合并为一个之后，返回给浏览器，多个文件路径之间使用“|”作为间隔符，一般用来开发调试站点js/css资源分模块进行文件存储的情况

qzmin规则（批量combo规则）

combo规则批量版本，使用一个json文件指定合并规则，便于替换和管理，文件格式请参考范例，find.all.qzmin

文件替换

将某个请求拦截，并使用本地文件替换，返回浏览器，可以用于本地开发调试

文件夹替换

将指定路径的请求，使用本地文件夹下同名文件进行替换（未找到对应文件则直接代理），返回浏览器，可以用于本地开发调试

tips: 便捷操作

  • 拖曳规则可以将规则进行快速排序
  • 从 session（界面区域1）拖曳请求到 Pool（界面区域4），可以快速创建本地替换规则
  • 快捷键：shift+c 复制当前选中项目或规则
  • 通过工具栏 export/import 进行规则的导入导出

路由规则

效果图

  • 使用 ‘-’ 表示直接代理：将请求直接代理转发到目标机器
  • ip 路由：将命中的请求路由到指定机器（相当于配置 host）

请求构建器

模拟 http 请求，可以修改get/post请求参数

效果图

过滤器

使用规则过滤不重要的请求

效果图

日志

显示系统信息、错误日志等

模拟低网速[mac]

模拟网络质量较差网络，查看站点表现

效果图

  • GPRS: 48kbit/s
  • Edge: 64kbit/s
  • 3g: 348kbit/s
  • ADSL: 768kbit/s
  • WIFI: 2048kbit/s

离线站点到本地

  • 将站点内容离线到本地，并自动代码格式化，便于查看
  • 站点保存到当前文件夹 Sites 下

效果图

快捷键

效果图

TODO

  • 完善 Timeline时间轴、Stat统计界面
  • LiveReload、AlloyDesinger集成，
  • 支持构建工具 task 管理与运行，如 Grunt, Gulp, Mod
  • More....

Thanks

  • extjs(sencha)
  • http-proxy
  • express
  • socket.io
  • underscore