Yapi部署说明

1.环境搭建

确保 node 版本=> 7.6,请运行 node -v 查看版本号
确保 mongodb 版本 => 2.6,请运行 mongo --version 查看版本号
确保安装了 npm, 运行 npm -v 查看版本号(高点版本node一般自带)
确保安装了 git,运行 git --version 查看版本号(确保git版本最新,不然会报错:由于GitHub 不再支持TLSv1/TLSv1.1了)

猛戳了解

2.部署

这里将采用官网的第二种命令行方式进行部署

mkdir yapi
cd yapi
git clone https://github.com/YMFE/yapi.git vendors //或者下载 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 配置
node server/app.js //启动服务器后,请访问 127.0.0.1:{config.json配置的端口},初次运行会有个编译的过程,请耐心等候

安装后的目录结构如下:

|-- config.json
|-- init.lock
|-- log
`-- vendors
|-- CHANGELOG.md
|-- LICENSE
|-- README.md
|-- client
|-- common
|-- config_example.json
|-- doc
|-- exts
|-- nodemon.json
|-- npm-debug.log
|-- package.json
|-- plugin.json
|-- server
|-- static
|-- test
|-- webpack.alias.js
|-- yapi-base-flow.jpg
|-- ydocfile.js
`-- ykit.config.js

注意:如果在初始化数据库认证失败时,请确保下面几点:

1.config.json配置文件中数据库、用户名和密码的正确性

"db": {
"servername": "127.0.0.1",
"DATABASE": "yapi",
"port": 27017,
"user": "myuser",
"pass": "",
"authSource": ""
},

2.配置中数据库对应的用户名是否存在和加以验证

db.createUser({user:'myuser',pwd:'',roles:[{role:'dbOwner',db:'yapi'}]})
db.auth('myuser','')

3.服务器管理

官网推荐使用 pm2 管理 node 服务器启动,停止,具体使用方法可参考下面的教程:

由于经常服务一停止,网站就挂了。为了永久守护这个yapi进程,这里要用到pm2。

安装

npm install pm2@latest -g

执行

切换到yapi的vendors目录 执行pm2 start

pm2 start server/app.js --watch

正常的话,应该能正常访问到,默认接口是3000,默认密码(ymfe.org) 登录系统(默认密码可在个人中心修改)
Yapi部署说明

上一篇:zabbix监控-percona监控MySQL(三)


下一篇:Oracle SQL语句之常见优化方法总结