Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
dao
logServer
proxyServer
test
util
viewServer
.gitignore
.travis.yml
README.md
app.js
electron.js
package.json
pm2.json

README.md

Groundhog

土拨鼠代理器。支持代理静态文件,请求mock数据,host绑定方式代理。

Build Status

Download

mac win

Quickstart

本代理器,代理端口为8888,前端页面端口为8887。换句话说就是,请保证这两个端口没有被其他程序占用。否则程序将无法启动

界面

  1. 主界面 区域1展示所有经过代理器的请求。区域2展示每个请求的详细信息,包含请求头,请求体等。还有如果设置了代理规则,会在rule tab页显示那条代理规则生效了。

  2. 配置界面 区域1展示所有配置,区域2展示单个配置的详细信息和修改配置。

实战配置

  1. pc端本地开发静态文件代理

增加一个如下图的配置


这样规则的意思就是所有请求中带有/test路径的请求都会被转到本地的/Users/flyover/test目录下。
/Users/flyover下创建一个test文件夹。
在test目录下创建一个index.html。
然后浏览器访问127.0.0.1:8888/test/index.html

  1. pc端本地开发mock数据代理

mock数据是在开发过程中,没有真实后端数据的时候。可以编写一些mock数据用于接口返回。

修改之前的配置,增加mock文件路径


这样mock文件就会去指定的路径下寻找。
/Users/flyover/下创建一个mock文件夹。
在mock目录中增加test_info.js文件,里面内容为

```

module.exports = function(params) { if (params) { return { result: '200' } } else { return { result: '400' } } } ```

类似得可以建更多简单的mock数据。 mock数据本身就是function。传入的params就是接口传给后端的参数。因此可以根据params返回不动的mock数据。      

在浏览器中直接打开

```

http://127.0.0.1:8888/xxxxx?api_name=test_info&info=xxxx ``` 其中api_name是需要增加这个参数的, 跟mock文件中的test_info.js对应。 api_name也可为apiName。

注意当有多个配置的时候,只有一个配置的mock路径会生效 建议关掉其他不用的配置

  1. 移动端的开发调试

    移动端设置网络代理到pc的ip地址和端口8888上。
    静态文件代理和mock数据代理和pc基本相似。
    需要注意的是配置静态资源替换规则的时候需要全域名

  2. 本地静态文件采用线上数据

    配置线上或者测试环境的ip

    一旦配置了host,将忽略mock数据路径, 同样也只有一个配置的host会生效