项目中用到很多的RESTAPI,光靠人工管理或者普通文档肯定是不行的,翻了很多的RESTAPI管理工具,还是选择了YAPI,原因有2,一个是接口位于内网,外网网站上管理测试不到内网接口,另外一个是使用方式,YAPI里的布局,个人感觉更容易理解上手
找了太比较老的Centos7, 因为不是新的,所以安装过程中,需要反复调整版本,包括node的版本,和YAPI的版本,版本高了缺组件,要额外安装,版本低了有事后不适配,所以装了四五次不同的版本来适配,最后成功了
下面是要用到的网址
1、安装
1.1 安装的前提条件
- nodejs(7.6+)
- mongodb(2.6+)
Mongodb没啥讲的,node7.6太低了,node不同版本在安装YAPI时会有不同的反应,常见的是缺包,反复几次,后来装了V12.12.12,太高了不行,太低了也不行,YAPI装了1.10.2版本
不同node的下载地址
Node下载:https://nodejs.org/dist/v12.22.12/
node安装方法
下载node-v12.22.12-linux-x64.tar.gz
tar -zxvf node-v12.22.12-linux-x64.tar.gz
修改/etc/profile,最后增加以下两句
export NODEJS_HOME=/usr/local/nodejs
export PATH=$PATH:$NODEJS_HOME/bin
source /etc/profile,让其生效
然后试一下,是不是好了
node -v
如果看到版本号就生效了。
1.2 YAPI安装
- 方式一. 可视化部署[推荐]
执行 yapi server 启动可视化部署程序,输入相应的配置和点击开始部署,就能完成整个网站的部署。部署完成之后,可按照提示信息,执行 node/{网站路径/server/app.js} 启动服务器。在浏览器打开指定url, 点击登录输入您刚才设置的管理员邮箱,默认密码(ymfe.org) 登录系统(默认密码可在个人中心修改)。
npm install -g yapi-cli --registry https://registry.npm.taobao.org
yapi server
执行完后会给你个网址,上去后,可以在网址里填写信息,然后就让网站触发安装
注意:淘宝的这个仓库过期了,会报错,要改到新仓库https://registry.npmmirror.com
npm install --production --registry https://registry.npmmirror.com
因为我们与github代码库网络不通,因为是外国,网络不联通,所以只能采用方式二
- 方式二. 命令行部署
如果 github 压缩文件无法下载,或需要部署到一些特殊的服务器,可尝试此方法
mkdir yapi
cd yapi
git clone https://github.com/YMFE/yapi.git vendors //或者下载 zip 包解压到 vendors 目录(clone 整个仓库大概 140+ M,可以通过 `git clone --depth=1 https://github.com/YMFE/yapi.git vendors` 命令减少,大概 10+ M)
cp vendors/config_example.json ./config.json //复制完成后请修改相关配置
cd vendors
npm install --production --registry https://registry.npmmirror.com
npm run install-server //安装程序会初始化数据库索引和管理员账号,管理员账号名可在 config.json 配置
node server/app.js //启动服务器后,请访问 127.0.0.1:{config.json配置的端口},初次运行会有个编译的过程,请耐心等候
官网的这些文字让我有歧义,所以又绕了好几圈,比如从浏览器上的github上下载zip压缩文件,下了几次只有17M,按照上述要有至少100M,所以后来本地用git命令下到本地,才会有两百多兆,加了–depth=1 又是一百多M,我是用两百多M版本去安装的
按照上面的命令严格执行,不能错一点儿,比如config.json,竟然放在项目外面,反正就是一个字都不要错的执行
同样是淘宝仓库过期问题,要改成https://registry.npmmirror.com
归纳总结就是,不同版本切换试,最后挑个不报错的!
2、运行
node server/app.js &
装完了会命令行里显示用户名,密码
在浏览器上访问,输入用户名密码,就可以用了。