如上图所示,Yapi就是一个接口管理平台。这里先不探讨高效、易用和功能强大。这里主要讲解一下是如何离线安装Yapi。
名词解释:
为何是离线安装?
答:因为接口的平台一般都在内网,但是内网机器一般都是屏蔽掉公网的访问的。因此我们不能使用各种linux命令去获取项目。主要是Yapi是一个vue直接操作数据库的项目。他并没有我们日常中的前后分离的概念。所以vue是个好东西。鉴于以上描述,我们了解到安装Yapi是个问题。可是既然是个vue项目么,那用node启动不就好了嘛,话是这么说的,但是这个过程需要摸索一番。以下就是我的摸索过程。
用到了哪些组件?
答:node、mongodb。node没办法,因为yapi是vue做的,mongodb显然就是数据库部分了。
Node安装
下载node,各种单击下一步。网上资料很多。这里不再赘述。
MongoDB安装
下载之后安装。选择自定义安装到您指定的目录,这里不再赘述。
安装好之后,将MongoDB设置为window服务
mongod.exe --logpath D:\Yapi\mongodb\mongdb\log\mongodb.log --logappend --dbpath D:\Yapi\mongodb\mongdb\data\db --directoryperdb --serviceName MongoDB --install
这里要创建log目录和数据库目录db
安装好之后您可以安装mongoDB得客户端。
https://www.mongodb.com/try/download/compass
Compass得安装也是一路下一步。当然您可以指定安装目录。
MongoDB默认是没有用户的,但是只能在127.0.0.1同机上使用,夸机器是不行的。所以您需要设置验证密码等。
安装完毕之后的效果是这样的。
Yapi安装
Yapi本地包制备
在能连接到外网的计算机上(已经安装node);创建一个文件夹,并在该文佳夹中进入cmd命令。
执行:
mkdir yapi
cd yapi
git clone --depth=1 https://github.com/YMFE/yapi.git vendors
xcopy vendors/config_example.json ./config.json
cd vendors
npm install --production --registry https://registry.npm.taobao.org
npm run install-server
node server/app.js #启动yapi,注意这里目录是vendors
执行完毕的效果是这样的
将yapi目录下得所有打成压缩包。
上传到服务器特定的文件夹(安装了Node),并解压。
将config.json中配置的user、pass配置去除。如果您的mongdb设置了用户验证您可以换成用户账户信息。
Yapi启动脚本
由于使用node server/app.js 启动是带有窗口的。这就比较别扭。所以我们需要让他不要带窗口的后台进程启动。这里编写脚本。
新建文件runYapi.bat,并在其里边输入node server/app.js,保存并退出
新建文件startup.vbs,并在其中输入:
set ws=WScript.CreateObject("WScript.Shell")
ws.Run "D:/Yapi/yapi/vendors/runYapi.bat",0
效果展示
安装结束之后,在浏览器中输入http://localhost:3000
注意,这里没有默认账户,您需要注册。注册成功并登录之后大概是这样的: