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配置的端口},初次运行会有个编译的过程,请耐心等候

安装后的目录结构如下:

SRE实战 互联网时代守护先锋,助力企业售后服务体系运筹帷幄!一键直达领取阿里云限量特价优惠。
|-- 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": "123456",
"authSource": ""
},

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

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

3.服务器管理

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

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

安装

npm install pm2@latest -g

执行

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

pm2 start server/app.js --watch

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

扫码关注我们
微信号:SRE实战
拒绝背锅 运筹帷幄