如果没有内网部署的条件,推荐使用在线服务。
Easy Mock 是一个可视化,并且能快速生成模拟数据的持久化服务。
- 支持接口代理
- 支持快捷键操作
- 支持协同编辑
- 支持团队项目
- 支持 RESTful
- 支持 Swagger | OpenAPI Specification (1.2 & 2.0 & 3.0)
- 基于 Swagger 快速创建项目
- 支持显示接口入参与返回值
- 支持显示实体类
- 支持灵活性与扩展性更高的响应式数据开发
- 支持自定义响应配置(例:status/headers/cookies)
- 支持 Mock.js 语法
- 支持 restc 方式的接口预览
- 在线使用文档
- Easy Mock CLI - 基于 Easy Mock 快速生成 api.js 的命令行工具。
在开始之前,假设你已经成功安装了 Node.js(v8.x,
不支持 v10.x)& MongoDB(>= v3.4)& Redis(>= v4.0)。
$ git clone https://github.com/easy-mock/easy-mock.git
$ cd easy-mock && npm install
找到 config/default.json,或者创建一个 config/local.json 文件,将如下需要替换的字段换成自己的配置即可。
不同环境会加载不同的配置文件,在此之前你应该对 node-config 有所了解。
{
"port": 7300,
"host": "0.0.0.0",
"pageSize": 30,
"proxy": false,
"db": "mongodb://localhost/easy-mock",
"unsplashClientId": "",
"redis": {
"keyPrefix": "[Easy Mock]",
"port": 6379,
"host": "localhost",
"password": "",
"db": 0
},
"blackList": {
"projects": [], // projectId,例:"5a4495e16ef711102113e500"
"ips": [] // ip,例:"127.0.0.1"
},
"rateLimit": { // https://github.com/koajs/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
}
},
"ldap": {
"server": "", // 设置 server 代表启用 LDAP 登录。例:"ldap://localhost:389" 或 "ldaps://localhost:389"(使用 SSL)
"bindDN": "", // 用户名,例:"cn=admin,dc=example,dc=com"
"password": "",
"filter": {
"base": "", // 查询用户的路径,例:"dc=example,dc=com"
"attributeName": "" // 查询字段,例:"mail"
}
},
"fe": {
"copyright": "",
"storageNamespace": "easy-mock_",
"timeout": 25000,
"publicPath": "/dist/"
}
}
背景图配置:
登录页的背景图服务目前支持 Unsplash 与 Bing。
如果 unsplashClientId
配置留空,默认由 Bing 提供服务。
注意:
publicPath
默认是'/dist/'
。如有需要,可以将其替换成自己的 CDN;- 关于
fe
的配置,一旦发生改变应该重新执行 build 命令。
$ npm run dev
# 访问 http://127.0.0.1:7300
# 前端静态资源构建打包
$ npm run build
# 以生产环境方式启动,需要提前执行 build
$ npm run start
# 单元测试
$ npm run test
# 语法检测
$ npm run lint
在此之前请先配置好配置文件。
当在内网服务器部署时,推荐使用 PM2 来守护你的应用进程。
$ [sudo] npm install pm2 -g
在此之前,你应该已经完成了 build。
$ NODE_ENV=production pm2 start app.js
Release 中记录了每个版本的详细更改。
Easy Mock 目前由大搜车无线架构团队进行维护。如有问题,欢迎提出 Issues,并通过 Pull Request 共同维护。不过在此之前,请务必阅读这份贡献指南。
实时问题可以加 QQ 群 595325417 进行反馈,当然也可以扫描下面的二维码加群。
如有内网部署,请务必告诉我们
- Souche inc | 大搜车
- Ruff
- Qiniu | 七牛
- Head Spring | 恒达时讯
- Digital Union | 数字联盟
- CityTogo | 兔狗家装
- Mistong | 铭师堂
- Tuotuo Internet | 妥妥网络
- Straight flush | 同花顺
- 360 Enterprise Security | 360企业安全集团
- MeiTuan | 美团网
- Wenba. Inc | 上海谦问万答吧云计算科技有限公司 AI学部门
- PPMoney | 万惠集团
- Mysoft Yunke | 明源云客
- GeekPark | 极客公园
- Enation Soft Co., Ltd | 易族智汇(北京)科技有限公司
- Harmony Cloud | 杭州谐云科技有限公司
- China Literature | 阅文集团
- huodongxing | 活动行
- kinhom | 金海马商业集团
- yuntongxun | 北京容联易通信息技术有限公司
- YHD | 1号店
- 51NB | 51信用卡
- Yunlai inc | 云来网络
- wozaijia | 我在家家居
- FOR U TRUCKING | 福佑卡车
- GUANLAN NETWORKS(HANGZHOU) CO.,LTD | 丁香园
- Bindo Labs Limited
- Value Simplex | 熵简科技
- Shanghai Mingyun | 上海明运
- Feidai | 深圳飞贷金融科技
- cibfintech | 兴业数字金融
- 广州三人行壹佰教育
- bangdao-tech | 邦道科技
- CGB | 广发银行
- Budiot | 萌发物联&玖竹科技
- ZTE | 中兴通讯股份有限公司
- Envision Digital | 远景智能
- Jianshu | 简书
- HYPERS | 宏路数据
- yunlong tech | 成都云隆科技有限公司
- taojiujiu tech | 涛舅舅网络科技有限公司
- shunfeng tongcheng tech | 北京顺丰同城科技有限公司
- bread finance | 面包财经
- Jimi | 机蜜
- zhongan | 众安科技信息技术服务有限公司
- verystar | 上海费芮网络科技有限公司
- lanren | 懒人听书
- IBPS | 广州流辰信息技术有限公司
- StarZP | 星众派
- Shijiazhuang banknote printing corporation | 石家庄印钞有限公司
chuangker |
XadillaX |
ostoc |
xinyu198736 |