Skip to content

代理服务器的新轮子:anyproxy

ottomao edited this page Nov 26, 2014 · 11 revisions

是的,我大支付宝的前端攻城师们又写了一个代理服务器,基于Node.js,取名 anyproxy项目主页)。

anyproxy

业界的代理工具已经不少了,windows有fiddler,mac有charles,跨平台的有腾讯alloy team出品的liver pool。满足特定功能的民间产品更是层出不穷,如代理线上combo文件的flex-combo,clam中的doji等等。

如此之多的产品,仍无法满足前端攻城师们奇葩的需求。举几个调试场景的栗子:

  • 调试线上页面,需要在页面里注入某个脚本,或是替换一些html数据。
  • 向同一个URL发送post,需要根据post body来mock数据。
  • 服务器不支持跨域头Access-Control-Allow-*,调试时却需要发送跨域请求。
  • 需要模拟个别接口超时。
  • 不改url,把请求发送到另一个地址,移动端的dns结果又有缓存,改host效率太低。
  • 替换cookie,模拟多账户/越过登录过程。

anyproxy的诞生,就是为了提供一个大底层,让类似的工具不再遥远,分分钟提升我们的调试效率。

代理服务器的战略价值

代理服务器是个中间人,站在了客户端和服务端中间,双方通信的每个比特,都会滴水不漏地经过它。 从http协议的角度来看,它控制了完整的请求头、请求体、响应头、响应体,可以在客户端与服务端都无感知的情况下介入处理所有的流程,是通信过程中的战略要塞。

AnyProxy的开放式代理服务器设计

可编程的API接口(rule)

面对纷繁的调试需求,传统的“配置文件”遭遇了灵活性瓶颈,因此我们决定开放接口,由攻城师们自己来编写各类代理规则。

类似obj-c中的delegate机制,我们把http请求的每个过程都进行分拆,用户可以根据需求对网络请求的任一环节进行干预。在这里,用户编写的规则文件被称为 rule

接口流程

具体来说,我们允许用户干预的接口:

  • 收到用户请求之后
    • shouldUseLocalResponse ,是否在本地直接发送响应(不再向服务器发出请求)
    • dealLocalResponse 如果shouldUseLocalResponse返回true,会调用这个函数来获取本地响应内容(异步接口)
  • 向服务端发出请求之前
    • replaceRequestProtocol 替换向服务器发出的请求协议,支持http和https的替换
    • replaceRequestOption 替换向服务器发出的请求参数,即nodeJS中的 request option
    • replaceRequestData 替换请求的body
  • 向用户返回服务端的响应之前
    • replaceResponseStatusCode 替换服务器响应的http状态码
    • replaceResponseHeader 替换服务器响应的http头
    • replaceServerResDataAsync 替换服务器响应的数据(异步接口)
    • pauseBeforeSendingResponse 在请求返回给用户前的延迟时间

清晰易懂的图解

右侧加粗气泡里即是anyproxy的接口。

实践和sample

为了帮助你更快地编写规则(rule)文件,我们提供了些sample(点击访问):

  • rule__blank.js
    • 空白的规则文件模板,和一些注释
  • rule_adjust_response_time.js
    • 把所有的响应延迟1500毫秒
  • rule_allow_CORS.js
    • 为ajax请求增加跨域头
  • rule_intercept_some_https_requests.js
    • 截获github.com的https请求,再在最后加点文字
  • rule_remove_cache_header.js
    • 去除响应头里缓存相关的头
  • rule_replace_request_option.js
    • 在请求发送到服务端前对参数做一些调整
  • rule_replace_response_data.js
    • 修改响应数据
  • rule_replace_response_status_code.js
    • 改变服务端响应的http状态码
  • rule_use_local_data.js
    • 把响应映射到本地

界面

可视化查看流量的利器。界面中的数据通信用websocket完成,保证了传输的实时性。

Https的中间人(man-in-the-middle)代理

Charles和fiddler有https的代理,可以做https的明文解码,anyProxy也做到了。

配合openSSL,制作一个根证书并在宿主机信任,anyproxy可以实时签发任意域名的二级证书,来协助https明文代理。

其他特性

  • 网速模拟,弱网络环境优化必备,你懂的!

跃跃欲试?

  • 完整的文档和介绍:https://github.com/alibaba/anyproxy, 记得给我们加个star。
  • 有任何问题,请直接提issue,或者加入anyproxy用户旺旺群:1203077233。

Clone this wiki locally