关于

hyk-proxy是一个web proxy框架，支持基于Google AppEngine平台和Seattle平台，以及PHP Web空间的proxy实现
hyk-proxy从V0.9.0开始结构更改为framework+plugins方式，具体proxy实现由各个plugin完成
在基于AppEngine实现的proxy部分，展示了通过RPC来实现高性能web proxy的途径。基于目前基于AppEngine部分实现机制，将来还可以实现暴露更多GAE特有功能,实现为一个远程的GAE lib，而不仅仅作为简单web proxy（目前已经实现用户权限管理/统计/基于用户流量控制等功能）。
在基于Seattle部分，目前仅实现web proxy功能，包括完整的https tunnel
在基于PHP Web空间部分，实现了http proxy功能，以及满足特定网络条件下的完全https tunnel
hyk-proxy目前支持HTTP(S) to GAE/XMPP to GAE/TCP to Seattle/HTTP to PHP四种方式完成web proxy功能
hyk-proxy从V0.8.6开始支持plugin，理论上可以任意扩展而不仅仅局限于GAE/Seattle/PHP

hyk-proxy原理

hyk-proxy分为两部分，一部分运行于远程server上，如GAE/Seattle/PHP Web Space，属于remote server;另一部分运行于本地，属于local server,实质为一个中转的http server。
当浏览器设置的代理服务器地址为local server地址时，local server将浏览器的请求编码发送给remote server执行proxy功能
1. 若remote server为GAE平台，则local server将http请求通过一个通用RPC框架远程调用到remote server上，获取远程调用结果；
2. 若remote server为Seattle平台，则local server将http请求加密后直接转发给remote server
3. 若remote server为PHP Space，实现原理类似Seattle部分，不同之处在于https tunnel实现是另外一种构建tunnel技术，对当前网络条件也有约束
local server在获取调用结果简单处理后，转给浏览器完成一次代理访问。
一次web访问经过此代理的完整过程如下：

Browser<-->Local Server<-->Remote Server<-->Real Web Server

其中Local Server与Remote Server之间属于通信层部分，不局限于HTTP连接；如GAE Remote Server由于防火墙原因无法直接通过HTTP连接，可采用XMPP模式穿越

由于基于AppEngine部分RPC框架通信层部分可以替换，因此local server与GAE remote server之间的通信方式可以视实际情况替换。由于GAE本身的限制，目前理论上只有三种方式可以选择：
1. HTTP，local server作为HTTP client访问remote server
2. XMPP，local server作为一个XMPP user与remote server进行通信
3. EMAIL，local server 与remote server发送/接受email通信（由于EMail限制较大，不适于用于RPC通信协议，目前不会实现）
而基于Seattle部分则在理论上支持TCP/UDP通信，目前实现TCP连接
基于PHP Web Hosting部分，目前通过HTTP方式完成普通http proxy，以及一种tunnel技术完成https proxy实现
hyk-proxy目前支持的四种默认内部proxy模式比较
- HTTP2GAE/HTTPS2GAE
- XMPP2GAE
- Seattle
- PHP

hyk-proxy的插件

hyk-proxy中很多功能由插件支持，默认并不安装，如Seattle/PHP/SPAC等，所有支持的插件具体说明/下载请查看项目hyk-proxy-plugins

如何使用

安装运行依赖
1. JRE/JDK 1.6+
2. Google App Engine SDK(Java) (最新版本)
创建自己的GAE应用 http://appengine.google.com/ (必须)
创建自己的Seattle账户以及Vessels Seattle(可选，仅对Programmer推荐使用)
申请自己的PHP空间（可选）
部署Remote Server
1. 部署应用到Google服务器 (必须)
  - GUI方式
    - appcfgwrapper安装程序已经集成到hyk-proxy-gae-server-[version].zip中，执行install.bat/install.sh即可，具体请参考此项目说明 http://code.google.com/p/appcfgwrapper/
  - 命令行方式
    - 下载并解压hyk-proxy-gae-server-[version].zip
    - 进入解压的目录, 修改war/WEB-INF/appengine-web.xml，将<application>值改为自己创建的appid
    - 执行appcfg.cmd/appcfg.sh update war上传, 注意在解压后进入的目录执行(appcfg在’<Google App Engine SDK>/bin’下 )
2. 部署应用到Seattle平台（可选，仅对Programmer推荐使用）
  - Seattle server程序在seattle plugin的deploy目录下，部署运行请参考(Seattle)
3. 部署应用到PHP空间（可选）
  - 上传phptunnel plugin目录下deploy/tunnel.php到服务器上

运行Local Server
1. 解压hyk-proxy-[version].zip 或者执行hyk-proxy-install_[version].exe(0.9.0后)
2. GUI方式
  - 执行bin/startgui.bat（windows）或者startgui.sh（linux/unix/mac）启动
3. 命令行方式
  - 执行bin/start.bat（windows）或者start.sh（linux/unix/mac）启动local server，bin/stop.bat(stop.sh)停止
4. 浏览器设置代理地址默认为 127.0.0.1:48100，可以修改
安装plugins
1. hyk-proxy中所有proxy功能均是由plugin来完成，包括基于GAE的proxy实现也是一个plugin。默认情况下，GAE的plugin包含在framework的安装包中，不需要单独下载
2. plugin安装包一般是zip包，目前均在此项目的site上；安装一般有两种方式:
  - GUI方式：在GUI界面上选择Plugins tab然后选择Available tab，点击相应plugin的install button即可
  - CLI方式：下载相应zip包，放置到<hyk-proxy>/plugins下重启即可
配置
- Framework
  1. <localserver host="localhost" port="48100" />, 默认的proxy地址，相应的浏览器的proxy地址应该填"127.0.0.1:48100"
  2. <proxyEventServiceFactory>GAE</proxyEventServiceFactory>, 默认选择的proxy实现，若安装了其他的plugin，则可以在此修改为其它的proxy实现
- GAE Plugin
  - <hyk-proxy-server appid="" /> 为已部署的ApplicationID，即<appid>.appspot.com中<appid>, eg:
  - <hyk-proxy-server appid="" />可配置多个，此情况下，代理过程中采用轮询策略选择, eg:
  - <hyk-proxy-server appid="" /> 中可以配置用户名/密码，具体用户名/密码概念请参考Authorization, eg:
  - 如果不配置appid的话，client会到master node上获取数个共享的appid用于自身启动，注意：
    - 共享的appid只能用于匿名用户使用（匿名用户的概念看这里Authorization）
    - appid所有者可以针对匿名用户设置proxy黑名单，proxy流量控制，所以不配置自己的appid是无法保证应用稳定性
  - <XMPPAccount user="" passwd="" />为XMPP账户，是可选配置，在HTTP无法直连情况下可启用，目前可配置GTALK/jabber.org/OVI等几乎所有XMPP帐号（若有不支持的XMPP account，请提交ISSUE）, eg:
  - XMPP账户可配置多个，此情况下代理过程中采用轮询策略选择,eg:
  - XMPP模式仅在connection mode模式为2（<connectionMode>2</connectionMode>）情况下生效
  - <maxFetcherNumber>3</maxFetcherNumber> 在下载文件/观看视频时生效，含义为并发的下载线程数，可以任意调整，建议在1～7之间调整
- Seattle Plugin
  1. 启用Seattle平台作为proxy服务器有两种方式：
    - 和AppEngine平台混合使用(建议)
    - 独立使用(不推荐，Seattle平台的资源限制非常严格)
  2. 配置Setattle平台目的地址
    - 修改plugin目录下etc/seattle.conf，加入申请得到的ip地址，端口（注意ip是通过seash shell中执行browse得到的ip，端口是你的seattle account profile中显示的port），eg:
- PHPTunnel Plugin
  1. 启用PHPTunnel也有两种方式：
    - 和AppEngine平台混合使用(建议)
    - 独立使用
  2. 配置PHP服务端目的地址
    - 修改plugin目录下etc/phptunnel.conf，最后加入部署得到的php url地址，可配置多个，eg:
  3. PHPTunnel作为https proxy需要满足的条件
    - 根据目前的技术实现，当选择phptunnel最为https proxy时需要当前网络满足以下任一条件：
      - 当前机器的IP为公网IP，即是非下面IP范围10.0.0.0 ~ 10.255.255.255 172.16.0.0 ~ 172.31.255.255 192.168.0.0 ~ 192.168.255.255
      - 若不满足上面条件，需要机器所直连的路由/NAT设备支持并开启UPNP功能
- SPAC Plugin
  1. 安装后启用SPAC需要修改etc/hyk-proxy-conf.xml启用SPAC：
  2. 修改proxy选择规则

`AppId`共享计划

在hyk-proxy的GAE Plugin的GUI(V0.8.5之后)中提供有一个共享appid的功能，任何人可以据此共享自己的appid，如下图:

当hyk-proxy的用户由于某些原因（如不知道怎么安装server侧）没有配置自己的appid时，默认情况下，hyk-proxy-client会从服务器上随机获取几个共享appid，然后用匿名用户方式连接<shareappid>.appspot.com
共享自己appid的贡献者需要据此考虑设置匿名用户的访问策略，在admin工具中提供有blacklist/traffic/stat工具用于监测/控制匿名用户的行为，具体参考Authorization
共享自己appid的贡献者建议在admin工具中执行下面命令设置默认匿名用户策略(root用户登录)：
- stat on — 开启流量统计
- traffic -u anonymouse -s * -r 25000000 — 对匿名用户访问所有站点限制25m流量
- stat reports 5 –查看流量前5的统计报告
流量统计结果每天定时自动清零，所以若使用共享appid用户当天无法使用，可以过一天再次尝试

注意

启用XMPP模式时，由于xmpp server限制，太频繁发送消息会被server拒绝，可采用配置多个XMPP账户规避
GUI中有一个Share appid功能，你可以分享自己的appid到中心服务器，也可以取消分享；中心服务器则随机分派appid给没有安装自己的hyk-proxy-gae-server的用户
分享自己的appid的用户需要注意配置anonymouse用户的访问策略，以免此appid被滥用，配置用户策略请参考Authorization
应用Seattle平台相对于Google AppEngine平台的优势：由于Seattle平台提供了非常底层的socket操作，因此可以比较完美实现https支持，上传，以及其他局限于Google AppEngine的限制无法实现的功能。
PHPTunnel插件在一定条件下也可以实现完美https的tunnel，但若不满足条件是无法实现https的proxy功能

Like this:

Be the first to like this post.

hyk-proxy – Project Hosting on Google Code

hyk-proxy – Project Hosting on Google Code

关于

hyk-proxy原理

hyk-proxy的插件

如何使用

AppId共享计划

注意

Like this:

你可能感兴趣的:(project)

`AppId`共享计划