## **宝塔安装YAPI开发文档**
参考连接1:https://blog.csdn.net/mp624183768/article/details/116990330
参考链接2:https://blog.csdn.net/mp624183768/article/details/116991149
参考链接3:https://www.cnblogs.com/dongv5/p/14990289.html
官方参考链接:https://hellosean1025.github.io/yapi/devops/index.html#%e5%ae%89%e8%a3%85
<span style="color:red;font-size:16px;font-weight:bolder">所需待安装的服务以及版本介绍:
PM2:5.5
Node:v14.17.6
Mongo:4.4
</span>
## 准备前工作
1. 使用centos7.9安装宝塔,安装宝塔后,以编译安装的方式安装lnmp环境和redis
2. 在服务器中,使用命令:bt,然后将宝塔对应的访问端口和地址以及账号密码根据提示改掉(如果访问地址忘记,可以使用bt中的14号命令查看)
3. 将端口:3000(Yapi访问端口)和9090(部署Yapi界面端口)开放(服务器对应服务商上面的安全组的端口也响应开放)
<hr>
### 1:在宝塔内部安装PM2管理器:
1. 在宝塔软件商店中搜索PM2,找到后,点击右侧,安装,任意版本均可
![](https://img.kancloud.cn/0c/19/0c197a3b8b7616e12235973f91ee7e59_1909x709.png)
2. 安装完成以后,在PM2中安装node版本:v14.17.6(点击切换版本即可安装)
![](https://img.kancloud.cn/ae/ad/aead7131c3b42f1117e21e85a1a936e2_1696x864.png)
![](https://img.kancloud.cn/0c/02/0c02816127b462e64da8baa02f9e1d89_341x40.png)
### 2:在宝塔内部安装mongo服务:
1. 在宝塔软件商店中搜索mongo,找到后,点击右侧,安装,任意版本均可
![](https://img.kancloud.cn/2c/10/2c1007b3f1d5d9700eb176ba41fffe77_1689x409.png)
![](https://img.kancloud.cn/fb/fc/fbfc937e7b007ce97b9de0619de5867a_1701x407.png)
![](https://img.kancloud.cn/f8/ca/f8ca8b1001018245c9c07ad6b6892612_499x223.png)
### 3:上述PM2,node,mongo安装完成后,创建一个yapi的目录,路径自定义
1. 当前的Yapi路径:/www/wwwroot/yapi/
2. 打开终端,在任意目录下执行命令:```npm install -g yapi-cli --registry https://registry.npm.taobao.org```
3. 切换到当前的Yapi路径,然后使用命令:```yapi server```,出现如下提示:使用服务器地址+9090即可打开部署界面,找到部署版本:1.9.2,数据库(Mongo)任意,没有会创建,输入完成后,点击开始部署,则会开始部署
![](https://img.kancloud.cn/20/ba/20bab892af8096438d42a5e339db9adc_902x462.png)
![](https://img.kancloud.cn/9c/25/9c2515098bc63e5671f3b4af8c4e956b_1602x809.png)
4. 部署期间会碰到报错,解决办法:找到common.js(路径:/www/wwwroot/yapi/my-yapi/vendors/server/utils
),注释掉一下代码:
```
jsf.extend('mock', function () {
return {
mock: function (xx) {
return Mock.mock(xx);
}
};
});
```
![](https://img.kancloud.cn/02/cc/02cc4a1196cfdb3cceb299fa731d946a_670x452.png)
然后回到命令行,ctrl+c 停止之前进度进入之前创建的项目文件夹的vendors 目录
![](https://img.kancloud.cn/5e/44/5e44f0cb2dfe393266849370447404a0_366x40.png)
### 4:启动方式有两种【推荐使用第二种】
1. 手动cmdy执行,一直在运行,此种方式只适合测试
命令1(执行安装js):```node server/install.js```,命令2(启动yapi):```node server/app.js```
然后会发现YAPI已经启动,输入网址即可访问:
![](https://img.kancloud.cn/83/b9/83b98511b29e786068e66f773f85bb36_912x431.png)
![](https://img.kancloud.cn/29/9b/299bf45677448973bb8f882b28af1a5a_1636x637.png)
2. 使用PM2管理器,将其加入到守护进程,可以使用IP访问,也可以使用域名访问(映射到反向代理即可实现域名访问),前两张图如果可以正常运行,则可以使用IP+3000端口访问Yapi:
![](https://img.kancloud.cn/1a/86/1a865a1cc5157c7760d63ce499f715be_1232x614.png)
![](https://img.kancloud.cn/93/ba/93ba3ad66fb7d00c3bfbd11607885b0c_1199x258.png)
![](https://img.kancloud.cn/14/23/14239d88988c252e4306975b9e074be0_1270x733.png)
3. 如果想使用域名访问Yapi的话,可以配置映射,配置完成后,即可使用域名进行访问,如下
![](https://img.kancloud.cn/25/be/25be2b8dcd63a0bbd0f7497d7c439e45_1216x549.png)
![](https://img.kancloud.cn/3d/84/3d84d8c76eb79be257f8fd4137113b5f_1171x712.png)
注释:添加完映射后,会自动生成一个站点,站点的目录即为刚才配置的目录,还有反向代理信息,如图所示
![](https://img.kancloud.cn/5e/93/5e9327677bf672358682824ab2b6a798_1916x314.png)
![](https://img.kancloud.cn/98/29/982966693bf4a6cafa5122530204878a_1354x831.png)
![](https://img.kancloud.cn/a5/96/a59622d2dafdaef9df876afc93a488b5_1723x760.png)