手摸手,带你在Win10环境下安装YApi可视化接口管理平台
YApi
YApi 是高效、易用、功能强大的 api 管理平台,旨在为开发、产品、测试人员提供更优雅的接口管理服务。可以帮助开发者轻松创建、发布、维护 API,YApi 还为用户提供了优秀的交互体验,
开发人员只需利用平台提供的接口数据写入工具以及简单的点击操作就可以实现接口的管理。
一、环境要求
- nodejs(7.6+)
- mongodb(2.6+)
- git
二、安装Git
1、Git官网下载:https://git-scm.com/downloads
2、直接下一步,下一步安装。
三、安装Node
1、官网下载:https://nodejs.org/en/download/
2、下一步下一步下一步安装
3、安装成功后,可查看node版本
node -v
或
node --version
4、查看npm版本
npm -v
查看各版本截图,如下图所示。
四、安装MongoDB
1、官网下载:https://www.mongodb.com/try/download/community?jmp=nav
官网下载太慢的话,可以使用下面的链接:
http://dl.mongodb.org/dl/win32/x86_64
2、选择Custom,一路next
3、下一步安装 "install mongoDB compass" 不勾选,否则可能要很长时间都一直在执行安装,MongoDB Compass 是一个图形界面管理工具,我们可以在后面自己到官网下载安装,下载地址:
https://www.mongodb.com/download-center/compass
4、配置MongoDB,进入MongoDB安装目录,进入bin文件夹,复制文件夹路径,打开控制面板,选择“系统与安全”——“系统”——“高级系统设置”,点击环境变量Path,将复制的路径新建在环境变量里面。
MongoDB的安装路径一般在:C:\Program Files\MongoDB\Server\4.2\bin
5、在安装目录下\data\创建一个db目录,作为安装目录\data\的备用目录,可以使用--dbpath""安装目录\data\db"显式指定该目录为存储位置,来启动MongoDB,如:
cd C:\Program Files\MongoDB\Server\4.2
mongod.exe --dbpath "C:\Program Files\MongoDB\Server\4.2\data\db"
6、此时MongoDB已经开启,浏览器访问http://localhost:27017/,页面上会出现如下图所示。说明MongoDB已经启动了,且默认端口(27017)没有被占用。
五、安装YApi
1、前提安装好Node、Git、MongoDB
2、采用方式一:可视化部署[推荐]
3、在D盘下创建yapi空文件夹,利用git工具进行开启yapi服务。在文件夹空白处鼠标右击,会出现“Git Bash Here”,点击。
4、安装yapi,命令如下所示。
npm install -g yapi-cli --registry https://registry.npm.taobao.org
yapi server
成功安装后,会出现如下截图。
直接按照提示要求,打开网站http://localhost:9090/,填写公司名称。
点击开始部署,部署完成并成功后,可通过底部提示启动服务器。
我们回到Git Hash终端,最终底部也有相同的提示。如下图所示。
直接输入“node vendors/server/app.js的命令,可看出有throw异常报错。报错如下图所示。
打开创建项目的文件D:yapi,可发现文件夹下多出一个my-yapi的文件夹。在my-yapi下面才是YApi项目的文件。如下图所示。
我们可得知,是我们运行的文件目录不对,应重新定位文件目录。我们需要定位目录至my-yapi文件夹。如下图所示。
这样,我们就可以直接访问http://127.0.0.1:3000/。默认帐号:admin@admin.com
默认密码:ymfe.org。如下图所示。
六、YApi设置后台运行
利用PM2管理YApi后台运行
PM2是node进程管理工具,可以利用它来简化很多node应用管理的繁琐任务,如性能监控、自动重启、负载均衡等,而且使用非常简单。
1、先全局安装PM2。打开CMD输入全局安装命令。如下所示。
npm install -g pm2
直接安装可看出经常安装失败。我们可利用国内镜像来安装,如下图所示
npm install -g pm2 --registry https://registry.npm.taobao.org
安装成功,如下图所示。
2、后台启动或关闭
我的YApi的安装目录在D:\yapi\my-yapi\。
启动执行:
pm2 start D:\yapi\my-yapi\vendors\server\app.js
启动执行成功,如下所示。
关闭执行:
pm2 stop D:\yapi\my-yapi\vendors\server\app.js
关闭执行成功,如下所示。
参考:
1、YAPI接口管理平台:https://hellosean1025.github.io/yapi/index.html
2、PM2实用入门指南:https://imweb.io/topic/57c8cbb27f226f687b365636
3、MongoDB安装与配置:https://www.cnblogs.com/wjaaron/p/7800490.html