Linux安装Yapi

时间：2022年1月4日

需求：按公司需求，前后端开发，由于过往开发都是后端先进行，前端须等后端开发玩接口，依照开发文档才能进行接口调试，大大增加了项目时间，故采用YAPI来作为解决方案

好处：(个人认为)

1：支持线上部署，接口不易丢失（接口文档可能存在系统重装或某些特殊情况丢失情况），即时同步

2：支持多种数据管理模式。Swagger、postman等等

3：支持多种请求模式，GET\POST\PUSH等等

4：支持默认接口返回值。前端不再需要后端开发完接口进行联调，可以直接调用yapi接口地址，就很方便，会直接返回yapi设置的默认结果集

5：支持多用户、多项目管理，页面简洁清晰

6：这个目前是免费滴，免费滴，免费滴，滴滴滴滴滴滴滴滴

前言

话不多说，开始安装，安装时间为22年1月，参考了很多其他写的博客，大多使用比较老的版本，特别是node和mongodb

node地址：Node.js Mirror 这里使用的是v12版本，现阶段最新好像是v14，但是都说太高版本会安装失败，但我也不懂，没用过。安装node不要安装小于12的版本，linux安装v10会直接显示版本太老了

mogondb地址：MongoDB Community Download | MongoDB

PART 1: 安装NODE

由于很多博文说，不要安装太高版本的node,容易失败，访问地址发现最新版本是v14，且node维护最多的都说偶数版本，所以选择了node12。

一：下载并安装

curl -sL https://rpm.nodesource.com/setup_12.x | bash -
yum install -y nodejs

二：查询node版本

node -v

三：查询npm版本

npm -v

PART 2: 安装Mongodb

访问Mongodb官网MongoDB Community Download | MongoDB，发现目前最新版本是5.0版本，这里我们不用压缩包安装

一：更新yum

很多博客都这么说，但确实无害，那就更新吧（摊手），更新要时间，耐心等待

yum -y update

二：创建Mongodb源文件，并编辑，保存

touch /etc/yum.repos.d/mongodb-org.repo


vim /etc/yum.repos.d/mongodb-org.repo

mongodb-org.repo写入下列代码：

[mongodb-org]
name=MongoDB Repository
baseurl=http://mirrors.aliyun.com/mongodb/yum/redhat/7Server/mongodb-org/5.0/x86_64/
gpgcheck=0
enabled=1

注意：这里baseurl是Mongodb的安装文件地址，刚刚上文说了，最新版本是5.0的，如果安装其他版本，把5.0改为其他就行了，另外5.0.5也是5.0，不要写5.0.5

三：安装mongodb

yum install -y mongodb-org

四：启动mongodb

service mongod start

五：设置开机启动

chkconfig mongod on

 注：如果提示Failed to execute operation: No such file or directory

 这里是因为linux版本是centos是7.0以上版本，需要执行下面代码，如果没报错就忽略

systemctl enable mongod.service

六：配置远程访问

        修改mongod.conf配置文件  注释 bindIp: 127.0.0.1，然后保存

vim /etc/mongod.conf

七：重启mongod

service mongod restart

PART 3: 安装YAPI

yapi文档地址：内网部署

提前准备：云服务器安全组，开放9000 和3000端口

一： 安装

npm install -g yapi-cli --registry https://registry.npm.taobao.org
yapi server

安装后显示如下，这时就代表成功了

二：平台部署配置

安装成功后，默认端口是9000，开发服务器9000端口，通过IP地址访问:http://ip:9000

 图中所示3000是，yapi后台地址，这里我就默认了，27017是刚刚安装的mongondb的连接端口，由于是内网，所以服务器没有必要开放27017端口。

注：记住yapi部署路径，可自定义

管理员邮箱将作为你的YAPI登录账号

点击“开始部署”，等待，会出现如下图，则部署成功

三：启动yapi后端服务器

按ctrl+C,退出，然后进入到yapi部署路径

cd /root/my-yapi

启动服务

node vendors/server/app.js

守护线程启动

（允许执行其他shell脚本，yapi服务不关闭，但是关闭shell客户端后，yapi会关闭）

node vendors/server/app.js &

访问地址：http://ip:3000

登录账号：你在PRAT3第二步是配置的管理员邮箱

登录密码：ymfe.org  (密码可以修改，登录后自行在后台修改)

PART4: pm2后台启动Yapi

这种启动方式，可以关闭shell客户端，yapi进程依旧存在。

一：安装pm2

npm install -g pm2

二：pm2启动yapi

由于我安装yapi的目录就是上文让记录部署路径：/root/my-yapi

pm2 start /root/my-yapi/vendors/server/app.js

三：pm2关闭YAPI

pm2 stop /root/my-yapi/vendors/server/app.js

到此安装步骤全部结束，可以愉快的使用YAPI了

PART5: 禁用注册功能

当外人知晓yapi访问路径后，就可以自行进行注册，不太好，

这时管理员可以手动注册用户，然后再禁用注册功能，就能防止外人注册了

首先进入yapi的安装目录，上面已经讲过了，记住路径，默认是/root/my-yapi/目录下

编辑config.json文件，插入 closeRegister=true 开启禁用用户注册功能

cd /root/my-yapi
vim config.json

{
   "port": "3000",
   "adminAccount": "abc@abc.com",
   // 开启禁用注册功能，ture: 禁用注册功能 false: 允许注册
   "closeRegister":true,
   "db": {
      "servername": "127.0.0.1",
      "DATABASE": "yapi",
      "port": "27017"
   },
   // 这里是管理员邮箱的邮件服务器配置，yapi安装好后会自动存在，不用管他
   // 不同邮箱的配置都不一样,我的是163邮箱
   "mail": {
      "enable": false,
      "host": "smtp.163.com",
      "port": 465,
      "from": "***@163.com",
      "auth": {
         "user": "***@163.com",
         "pass": "*****"
      }
   }
}

保存，然后通过pm2重启即可

pm2 restart /root/my-yapi/vendors/server/app.js