Skip to content

Latest commit

 

History

History
73 lines (55 loc) · 2.78 KB

readme.md

File metadata and controls

73 lines (55 loc) · 2.78 KB
Raw

Rythem

fiddler like cross-platforms(MacOS/win/linux) tool using Qt

By AlloyTeam

License

MIT

使用介绍：rythem介绍-alloyteam

代码阅读建议：https://github.com/AlloyTeam/Rythem/wiki

MacOS 10.9 不支持 Qt5 . 重新回到4.8 怀抱.. 向Qt5迁移中... 代码在Qt4.7.4 & Qt4.8上运行通过，低于4.7的版本有可能会出问题

MAC下开发需增加Build Steps

command deploy.txt
working directory: %{buildDir}
Command arguments: %{sourceDir} %{buildDir}

功能

  • http代理服务

  • https tunnel透传(https抓包需求似乎不是很大，暂不实现)

  • 规则替换

      匹配模式包括`wildcard`类型及全匹配两种
  以替换后内容区分有本地及远程两种。
  本地替换有三种：目录式，单个文件式，多文件合并成一文件
  远程替换暂时只支持一个文件对应一个远程路径

  • host设置

  • 替换规则远程及本地导入。

  • 替换规则增删改。

  • 颜色标记已被替换的请求

  • 导入/导出 每条请求（兼容fiddler *.saz文件)

  • 批量导出response body（可用于保存整站）

  • 过滤显示请求

TODOs

  • 规则管理(远程规则的更新机制）
  • 各OS/浏览器版本下稳定性测试

主要代码结构

  • RyProxyServer: 代理server
  • RyConnection: 每个socket对应一个实例，掌管每个请求的client socket及remote socket并处理相应的请求
  • RyPipeData: 保存各个http请求的信息（包括request及response）
  • rule::RyRuleManager: 做规则替换相关

以上几个类的关系：

  1. ，当 RyProxyServer 检测到有新的client socket时，生成一个RyConnection实例，并将相应socket id传入。
  2. RyConnection 对此 client socket传入数据分析，解包成若干http请求 
     2.1. 每解析到一个http包生成一个`RyPipeData`实例，并压入缓冲队列pipeList 
 2.2. 生成pipeData后，如果当前有未完成的pipeData，结束，否则跳到2.3
 2.3 通过`RyRuleManger`检测是否有当前相应的替换规则
     如有匹配规则，跳到2.3
     如无匹配规则，跳到2.4
 2.3 如获取规则则照获修改`RyPipeData`，如修改后的pipeData已有内容（内容替换类规则）
      跳到2.5，否则跳到2.4
 2.4 向远程socket写入当前pipeData的http request 数据并监听返回
      当远程返回数据解包完成，跳到2.5
 2.5 获取下一个队列中的pipeData，如果为空，结束，否则跳到2.2步
  3. 当RyConnection解析到新的请求包时，或解析到返回包时，发出相应的signal给具体UI