代理工具

代理工具

启动代理

YKit 使用 Jerry Proxy 作为代理插件。它结合了SwitchHost和Charles/Fiddler的功能，包括：

无 DNS 缓存的 Host 分组管理
请求 / 响应日志（抓包）
断点
URL MAP
接口 Mock 服务
网速控制(Throttling)
并且支持 Qunar 通用域名的 HTTPS。通过下面命令启动代理：

$ sudo ykit server -x

切换到代理服务

注意此时代理还未生效，我们还需要把请求打到我们的本地代理上。简单的方式是使用SwitchyOmega等chrome代理插件，或者使用Proxy右上角推荐的代理插件。以下是SwitchyOmega的配置，我们将所有外部请求打到127.0.0.1:999，也就是我们的本地代理上。

注意: 你需要把所有忽略的规则全部清空。另外, ShadowSocks和所有的代理都冲突, 在使用时也需要关闭。

Host管理

我们建议你彻底放弃编辑Host文件修改Host的方式并清空系统host文件中的所有内容, 直接转移到这套方案。这套方案不仅没有DNS缓存, 项目和环境的切换也十分便捷。

访问http://127.0.0.1:1000/qproxy#/?_k=1kpa78左侧导航是项目(方案)列表，右侧面板是该分组下 Host 规则。这里你需要手动选择当前激活的分组。

对于YKit项目，会在项目内新建/读取ykit.host，并且同步更新。也就是说你不需要手动创建一个新的方案。

点击添加规则可以批量导入Host规则, 格式和Host文件完全相同, 除了不支持注释以外:

在Host导入以后, 配置会立即生效, 无需重启浏览器。点击导出Host可以将当前的Host配置转换成Host文件的格式。

另外, Jerry还提供了快速切换环境的功能, 每条Host的右侧有可选择的环境和机器IP, 你可以通过选择它们来快速切换环境。

我们内置了一些常用的环境如qzz和local, 如果选择online等于没有配置host, 选择custom可以手动输入IP。

如果你需要修改默认的环境/机器组配置, 可以在服务器组配置面板中手动编辑, 如图:

修改完成后, 你需要重新启动代理才能生效。

Mock服务

所有ykit项目都可以开启mock服务, 首先你需要在项目的根路径下添加一个mock.js, 内容如下:

module.exports = [
    {
        // 当前环境
        current: 'local',
        // 匹配规则
        pattern: /test\.qunar\.com\/([^?]*)(\?.*)?/,
        // 所有的responder, 生效的是等于current的那个
        responders: {
            "beta": 'http://$1.qunar.com',
            "dev": 'http://$1.qunarman.com',
            "local": './mock/$1.json'
        },
        // 配置jsonp wrapper函数名
        jsonpCallback: 'jsCallback',
        // 响应头的content-type
        contentType: 'text/html'
    },
    {
        // 简易配置, 匹配规则
        pattern: /test2\.qunar\.com\/(.*)/,
        // 可以直接返回一个json，同样也支持上面那种正则匹配的方式
        responder: {id: 2222},
        // 同样可以配这个和contentType
        jsonpCallback: 'jsCallback'
    },
    {
        pattern: /test3\.qunar\.com/,
        responder: {id: '1212dl;akds;l'}
    },
    {
        pattern: /fakeurl/,
        // 也支持传入函数，它的参数是一个parse过的URL对象
        // 例如localhost/fakeurl?a=1&b=2 parse的结果是 {"protocol":"http:","slashes":true,"auth":null,"host":"localhost","port":null,"hostname":"localhost","hash":null,"search":"?a=1&b=2","query":"a=1&b=2","pathname":"/fakeurl","path":"/fakeurl?a=1&b=2","href":"http://localhost/fakeurl?a=1&b=2"}
        // 这在API依赖参数时会非常有用，例如某个分页列表的API需要传入当前页码的情况
        responder: function (parsedUrl) {
            // 它的返回值将作为请求的response.body
            return parsedUrl;
        }
    }
];