前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >centos部署yapi爬坑记

centos部署yapi爬坑记

作者头像
胡琦
发布2021-09-09 10:19:16
8180
发布2021-09-09 10:19:16
举报
文章被收录于专栏:胡琦胡琦

前言

这几天终于完成了为期三个月的公司某个demo版的项目,在这期间和公司的后台因为API的事怼过无数次了,'我的接口没问题,是你请求的方式不对吧!'、'一定是你请求的参数不对'......诸如此类问题贯穿这三个月,仅仅因为我们没有一个良好的接口管理习惯,一堆省事的工具没有被利用起来,接口定义很随意基本靠口头传达。于是乎,我想YApi接口管理平台必须先用起来,再者,张鑫旭大大也在为接口管理打call,前端也应该把工具用起来。解放生产力,提高效率!

安装node

因为yapi的安装必须依赖node,centos环境安装node的各种方法google一下,千千万万种。而我还是踩到坑了,不知道为什么我根据wget安装源码的方法,失败了,当然也不是完全失败,是make的时候,等的太久,我直接ctrl+c了。还是用nvm安装吧,尽管我也不知道合不合理。请代码说话:

Wget下载安装nvm

或者Curl

下载完成后加入系统环境

验证安装

查看远程node版本

安装所需版本 要求nodejs(7.6+)

安装mongdb

yapi依赖mongodb(2.6+,理论上可配置远程的mlab,此处安装centos的mongdb,前提是确保centos为64位。 同样安装方法也有千千万万种,这里用yum安装

修改yum包管理配置

复制下面配置信息:

安装mongodb

修改mongdb配置(公网可访问:127.0.0.1 => 0.0.0.0)

启动mongodb

此时如果是阿里云服务器,安全组添加端口12071就能通过公网地址访问,当然此时是不安全的

此时任何一个人都能通过连接你的mongdb数据篡改你的数据,这时候试着加下验证试试,这里方法也有千千万万种,请自行google,例如:

代码语言:javascript
复制
mongo --port 27017use admindb.createUser(
 {    user: "adminUser",    pwd: "adminPass",    roles: [ { role: "userAdminAnyDatabase", db: "admin" } ]
 }
)

## 部署yapi 根据官方文档,部署方法有两种,鉴于我前几天在电脑上用第一种方法安装时失败,于是就采用第二种复杂一点的方法

代码语言:javascript
复制
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.orgnpm run install-server //安装程序会初始化数据库索引和管理员账号,管理员账号名可在 config.json 配置node server/app.js //启动服务器后,请访问 127.0.0.1:{config.json配置的端口},初次运行会有个编译的过程,请耐心等候

此时只是暂时成功部署了,还要永久守护这个yapi进程,这里用到pm2

安装pm2

切换到yapi的vendors目录 执行pm2 start

代码语言:javascript
复制
正常的话,应该能正常访问到,默认接口是3000

总结

至此,已经把yapi的源代码clone了一份到你自己的内网,当然,期间还是会遇到不少的坑,我遇到的主要还是mongdb认证的坑:比如认证设置不成功、config文件配置不正确之类的,甚至pm2启动yapi失败,总之多尝试多动手,自己实在不能解决再去请教大牛。

① mongdb认证获取失败

解决: 检查mongdb配置是否正确、认证设置是否成功,yapi的config文件是否配置正确

② pm2启动yapi失败,一直重启

决:通过pm2 log查看是之前通过npm开启的服务没有结束,导致端口占用,ctrl+c之前的服务就行 前两个问题貌似都不算是坑,无非就是拦路虎

③配置好的邮箱失败

解决:那肯定是邮箱配置不对喽,重来吧!然后就继续采坑 不确定是不是网易邮箱有点问题还是怎么的,换成qq的就行,修改完config.json文件,我以为重npm run install-server就万事大吉了,其实 -->

应该是mongdb中yapi已经存在这个管理员的信息,如果admin下面没有数据的话就直接删掉这条,如果有点话就修改数据吧。我很懒,直接用mongdb compass把整个yapi都删掉了,删库跑路!

不足之处欢迎拍砖指正!

yapi开启https访问

虽然对小白来说https然并卵,我还是想捣鼓一下试着通过https来访问我的yapi,首先证书我是有了,获取证书的方法也有千千万万种,我这里用的阿里云的免费证书,总之有证书的话应该能拿到证书文件如.pem、.key、.pfx之类文件。技术菜的我天真的以为还能开启3000端口的https访问,结果啪啪啪打脸打的很清脆,于是乎把https的端口设定成了8443。大概步骤如下:

获取证书文件(默认有证书并且能拿到.key和.pem文件或者.pfx文件)

上传证书(我直接放在app.js同级,根据个人喜好)

修改app.js 是基于koa的 不过我没有再引用koa-ssl,直接用的node的https方法的第一种

成功开启https

同样还是踩了不少坑

  • 文件径不对 not such file 解决:用__dirname
本文参与 腾讯云自媒体分享计划,分享自微信公众号。
原始发表:2018-06-28,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 胡琦 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
目录
  • 前言
  • 安装node
  • 安装mongdb
  • 总结
    • ① mongdb认证获取失败
      • ② pm2启动yapi失败,一直重启
        • ③配置好的邮箱失败
          • 不足之处欢迎拍砖指正!
          • yapi开启https访问
          相关产品与服务
          云数据库 MongoDB
          腾讯云数据库 MongoDB(TencentDB for MongoDB)是腾讯云基于全球广受欢迎的 MongoDB 打造的高性能 NoSQL 数据库,100%完全兼容 MongoDB 协议,支持跨文档事务,提供稳定丰富的监控管理,弹性可扩展、自动容灾,适用于文档型数据库场景,您无需自建灾备体系及控制管理系统。
          领券
          问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档