Yapi安装手册

版本号

• Yapi：v1.9.2

• MongoDB：v4.4.2

• Node.js：v12.20.0

• Git：v1.8.3.1

 编辑

配置MongoDB

• 安装过程参考

• 下载MongoDB压缩包，下载地址

  wget https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-rhel70-4.4.2.tgz

• 解压

  tar -xvf mongodb-linux-x86_64-rhel70-4.4.2.tgz

• 安装依赖

  yum install libcurl openssl xz-libs

• 创建文件链接

  ln -s /path/to/the/mongodb-directory/bin/* /usr/local/bin/

• 创建数据及日志文件夹

  mkdir /var/lib/mongo

  mkdir /var/log/mongodb

• 启动

  mongod --dbpath /var/lib/mongo --logpath /var/log/mongodb/mongod.log --bind_ip xxx.xxx.xxx.xxx --fork

 编辑

安装Node.js

• 安装过程参考

• 下载Node.js压缩包，下载地址

  wget https://nodejs.org/dist/v14.15.3/node-v14.15.3-linux-x64.tar.xz

• 解压

  tar -xvf node-v14.15.3-linux-x64.tar.xz

• 创建文件链接

  ln -s /usr/local/nodejs/bin/npm /usr/local/bin/

  ln -s /usr/local/nodejs/bin/node /usr/local/bin/

• 测试是否安装成功

  node -v

 编辑

安装Yapi

• 安装过程参考参考

• 使用npm安装Yapi

  npm install -g yapi-cli --registry https://registry.npm.taobao.org

• 进入Node.js安装目录，启动

  bin/yapi server

• 浏览器访问9090端口，进入可视化部署程序页面，根据实际信息填写

  • 

  • 

• 点击开始部署

• 启动服务

  node vendors/server/app.js

• 访问3000端口，使用管理员账号密码登陆即可

  • 

• 
• 利用pm2进行服务管理

  npm install pm2 -g  //安装pm2
  cd  {项目目录}
  pm2 start "vendors/server/app.js" --name yapi //pm2管理yapi服务
  pm2 info yapi //查看服务信息
  pm2 stop yapi //停止服务
  pm2 restart yapi //重启服务

• 部署时报错解决方法

  • 'Accessing non-existent property 'count' of module exports inside circular dependency'

    • node.js版本过高，可降级到v12版本，降级node版本方法。

  • 提示init.lock文件已存在，无法初始化

    • 初始化完成后会生成init.lock文件，若重新初始化需删除此文件以及清空MongoDB中已生成的项目配置信息。

 编辑

Yapi使用

• 详细使用教程可参考

• Yapi接入swagger文档，参考