在线安装
安装nodejs
下载压缩包，设置环境变量，这里不祥述。
安装mongodb
添加yum源
vim /etc/yum.repos.d/mongodb-3.4.repo #添加下面的内容，wq保存。 [mongodb-org-3.4] name=MongoDB Repository baseurl=https://repo.mongodb.org/yum/RedHat/$releasever/mongodb-org/3.4/x86_64/ gpgcheck= 0 enabled=1 #安装 yum install -y mongodb-org
配置mongod
#启动: service mongod start [root@CENTSVR247 vendors]# mongo > use admin #切换到admin数据库 switched to db admin #创建dba用户 > db.createUser( ... ... { ... ... user: "dba", ... ... pwd: "dba", ... ... roles: [ { role: "userAdminAnyDatabase", db: "admin" } ] ... ... } ... ... ) #创建yapi数据库 > use yapi switched to db yapi 给yapi数据库添加test1用户,权限为读写 > db.createUser( ... ... { ... ... user: "test1", ... ... pwd: "test1", ... ... roles: [ ... ... { role: "readWrite", db: "yapi" } ... ... ] ... ... } ... ... )
安装Yapi
官方说明：https://yapi.ymfe.org/devops/index.html
方式一：可视化部署
npm install -g yapi-cli --registry https://registry.npm.taobao.org yapi server
根据提示，浏览器访问 http://部署YApi服务器的IP:9090。
填写完信息后，点击“开始部署”。（大概等待1分钟）
# 退出当前状态
CTRL + C
修改配置
这里我们不急着根据提示进行启动，有些参数我们可以通过修改配置达到。
# 修改config.json
vim /root/my-yapi/config.json
修改下面的内容（邮箱可以不用163的），wq保存。
{ "port": "80", "adminAccount": "[email protected]", "db": { "servername": "127.0.0.1", "DATABASE": "yapi", "port": "27017" }, "mail": { "enable": true, "host": "smtp.163.com", "port": 465, "from": "可用于发送邮件的163邮箱", "auth": { "user": "163邮箱", "pass": "163邮箱对应的密码或授权码" } } }
启动
# 切换到部署目录下
cd /root/my-yapi
# 启动服务
node vendors/server/app.js
由于修改了配置，所以直接访问 http://部署YApi服务器的IP/login。
访问http://部署YApi服务器的IP:3000/login
默认用户密码：[email protected] ymfe.org
方式二：命令行部署
安装yapi
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
安装pm2
cd vendors npm install -S pm2
初始化及启动yapi
npm run install-server //安装程序会初始化数据库索引和管理员账号，管理员账号名可在 config.json 配置 node server/app.js //启动服务器后，请访问 127.0.0.1:{config.json配置的端口}，初次运行会有个编译的过程，请耐心等候
使用pm2启动方式
#启动 npx pm2 start ./server/app.js #停止 npx pm2 stop all
离线安装
离线安装只能采用命令行部署方式
node安装
不再详述。
内网安装mongodb
解压mongodb-linux-x86_64-3.6.4.tgz并放入mongodb文件夹中
tar -zxvf mongodb-linux-x86_64-3.6.4.tgz mv mongodb-linux-x86_64-3.6.4 mongodb
把mongodb放入环境变量中, 修改~/.bashrc, 加入以下内容
export PATH=<mongodb文件夹的路径>/bin:$PATH
验证安装
source ~/.bashrc
mongo --version
创建dbdata/db文件夹和dblog文件夹(请自行确保这些文件夹的读写权限)
mkdir -p dbdata/db mkdir dblog
启动mongodb服务
sudo ./mongodb/bin/mongod --fork --dbpath ./dbdata --logpath ./dblog/log
配置
参考上文mongodb配置。
离线安装yapi
在一台连接互联网的pc上安装node环境
在外网机器获取yapi源码并安装依赖
使用git获取yapi源码, 如果没有git命令请按照对应平台的安装方法安装git.
创建一个新文件夹yapi, 使用clone将yapi源码放入vendors中:
mkdir yapi cd yapi git clone https://github.com/YMFE/yapi.git vendors cp vendors/config_example.json ./config.json cd vendors npm install --production
我这里还安装了pm2
npm n install -S pm2
将创建的yapi文件夹打成压缩包得到yapi.tar.gz(其目录下有config.json和vendors)
tar -czf yapi.tar.gz yapi
至此, 所有需要外部网络的操作已经完成, 可以进行内网部署.
启动yapi
解压yapi.tar.gz
tar -zxvf yapi.tar.gz
按需要修改yapi/config.json中的相关配置(例如管理员账号等)
初始化数据库:
cd ./yapi/vendors npm run install-server
使用pm2启动
npx n pm2 start ./server/app.js
启动完成后即可尝试访问yapi看是否成功, 具体地址要根据内网机器的ip和在config.json中配置的端口号
如果要关闭yapi服务, 可以使用
npx n pm2 stop all
问题总结：
两种方式安装yapi,按照正常方式安装都是无法安装的，有如下错误
- 方式1图形界面，yapi server 启动9090服务后，页面无法打开，会报错误，原因是无网络。
- 方式2命令行安装，npm install –production 回报git错误，因需要联网git操作，原因无网络，npm使用私库代理也不行。
- 全局安装pm2: npm install pm2 -g
- 使用pm2启动YAPI: pm2 start ./server/app.js
- mongodb不启用验证的情况下，config.json中的db用户名和密码设为空