在单独前端开发的时候,后台还没有完整开发出接口的时候,这个时候就需要一个接口模拟工具。当然有一些在线的接口工具可以使用,这里推荐的是一个开源项目,可以直接部署到局域网中。另外还支持Swagger文档接口对接。

1. 下载项目到本地
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
开源地址
https://github.com/easy-mock/easy-mock

中文文档: https://github.com/easy-mock/easy-mock/blob/dev/README.zh-CN.md


1. 下载
git clone https://github.com/easy-mock/easy-mock.git

2. 安装
cd easy-mock && npm install

3. 启动
npm run dev

4. 访问
访问 http://127.0.0.1:7300
2. 使用docker compose部署
2.1 镜像地址

https://hub.docker.com/r/easymock/easymock/

2.2 docker-compose.yml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
version: '3'

services:
mongodb:
image: mongo:3.4.1
volumes:
# ./data/db 数据库文件存放地址,根据需要修改为本地地址
- './data/db:/data/db'
networks:
- easy-mock
restart: always

redis:
image: redis:4.0.6
command: redis-server --appendonly yes
volumes:
# ./data/redis redis 数据文件存放地址,根据需要修改为本地地址
- './data/redis:/data'
networks:
- easy-mock
restart: always

web:
image: easymock/easymock:1.6.0
command: /bin/bash -c "npm start"
ports:
- 7300:7300
volumes:
# 日志地址,根据需要修改为本地地址
- './logs:/home/easy-mock/easy-mock/logs'
# 配置地址,请使用本地配置地址替换
# - './production.json:/home/easy-mock/easy-mock/config/production.json'
networks:
- easy-mock
restart: always

networks:
easy-mock:
2.3 production.json
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
{
"port": 7300,
"host": "0.0.0.0",
"pageSize": 30,
"proxy": false,
"db": "mongodb://mongodb/easy-mock" # host 请务必替换为mongodb, 而非 localhost
"unsplashClientId": "",
"redis": {
"keyPrefix": "[Easy Mock]",
"port": 6379,
"host": "redis", // 请勿使用 localhost,换 "redis"
"password": "",
"db": 0
},
"blackList": {
"projects": [],
"ips": []
},
"rateLimit": {
"max": 1000,
"duration": 1000
},
"jwt": {
"expire": "14 days",
"secret": "shared-secret"
},
"upload": {
"types": [".jpg", ".jpeg", ".png", ".gif", ".json", ".yml", ".yaml"],
"size": 5242880,
"dir": "../public/upload",
"expire": {
"types": [".json", ".yml", ".yaml"],
"day": -1
}
},
}
3. 使用方式
  1. 安装 docker-compose
  2. 新建文件 docker-compose.yml 并将上面 docker-compose 文件内容复制进入 docker-compose.yml,然后将内容中注释位置替换为自己需要的本地地址即可。主要有三个需要替换的地方,数据库文件存储位置,日志文件存储位置,自定义配置文件本地地址。
  3. 启动:docker-compose up -d

注意

  • 使用容器方式运行不需要指定 dbredis 参数
  • production.json 配置中注意以下问题
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
{
"port": 7300,
"host": "0.0.0.0",
"pageSize": 30,
"proxy": false,
"db": "mongodb://mongodb/easy-mock" # host 请务必替换为mongodb, 而非 localhost
"unsplashClientId": "",
"redis": {
"keyPrefix": "[Easy Mock]",
"port": 6379,
"host": "redis", // 请勿使用 localhost,换 "redis"
"password": "",
"db": 0
},
......
......
}
  • 如果遇到 easymock docker 实例报文件权限错误

    1
    Error: EACCES: permission denied....
  • 可在项目根目录执行以下命令*

    1
    chmod 777 /yourfile/logs