YApi 是去哪儿网大前端技术中心开源的一个可视化的接口管理平台。下面是在CentOS7下搭建二次开发环境步骤。
1 安装MongoDB
具体安装参考CentOS7安装MongoDB
2 安装Node.js和npm
具体安装参考CentOS下安装nvm
Node.js版本7.6.0，npm版本大于5.0
查看Node.js版本
node –v
查看npm版本
npm –v
3 部署yapi
mkdir yapi cd yapi git clone https://github.com/YMFE/yapi.git vendors --depth=1 //或者下载 zip 包解压到 vendors 目录 cp vendors/config_example.json ./config.json //复制完成后请修改相关配置 cd vendors npm install --production --registry https://registry.npm.taobao.org //安装依赖 npm run install-server //安装程序会初始化数据库索引和管理员账号，管理员账号名可在 config.json 配置
3.1 创建工程目录
mkdir yapi cd yapi git clone https://github.com/YMFE/yapi.git vendors --depth=1 //或者下载 zip 包解压到 vendors 目录
3.2 修改配置文件
cp vendors/config_example.json ./config.json //复制完成后请修改相关配置 vi ./config.json
配置修改如下，主要配置 MongoDB 数据库：
{
"port": "3011",
"adminAccount": "[email protected]",
"db": {
"servername": "10.228.129.235",
"DATABASE": "yapi",
"port": 27017,
"authSource": ""
},
"mail": {
"enable": true,
"host": "smtp.163.com",
"port": 465,
"from": "***@163.com",
"auth": {
"user": "***@163.com",
"pass": "*****"
}
}
}
3.3 安装依赖
cd vendors npm install --registry https://registry.npm.taobao.org //安装依赖
3.4 初始化
npm run install-server //安装程序会初始化数据库索引和管理员账号，管理员账号名可在 config.json 配置
3.5 启动开发机
若要启动开发环境服务器，执行如下命令：
npm run dev //启动服务器后，请访问 127.0.0.1:{config.json配置的端口}，初次运行会有个编译的过程，请耐心等候
4 安装打包工具
安装webpack
npm install -g webpack //全局安装 npm install --save-dev webpack //安装到项目目录
安装ykit
npm install ykit -g
若安装过程中，出现npm ERR!报错，解决方法如下：
npm install ykit -g --unsafe-perm=true --allow-root
5 用ykit执行打包
ykit pack -m
若打包过程中，出现目录权限Permission denied报错，解决方法如下：
chmod 777 文件或目录
打包成功后，会在vendors/static/prd文件夹下生成如下压缩文件：
6 启动生产环境服务器
node server/app.js
服务启动成功后，显示如下信息：
7 服务后台运行
使用如下命令：
nohup node server/app.js &
查看进程
ps -aux
杀掉进程
kill -9 具体pid号
8 相关问题
ykit打包成功，启动生产环境服务器后，打开浏览器报错：
报错原因：二次开发不支持windows环境，请在CentOS或者MacOS环境下进行二次开发。