YAPI安装使用

前置条件

数据库:mongoDB 已经安装完全。
(可以参考 https://blog.youkuaiyun.com/IT_ZRS/article/details/118642997/ 我按这个方式失败)

安装包准备

在服务器上
创建目录 my-yapi
将下载的文件夹 vendors 和 配置文件config.json 放在该文件夹下面
在这里插入图片描述
其中配置文件 config.json

{
  "port": "3000",
  "adminAccount": "***@***",
  "timeout":120000,
   "db": {
      "servername": "***",
      "DATABASE": "***",
      "port": "***"
   },
   "mail": {
      "enable": false,
      "host": "***.***.***",
      "port": ***,
      "from": "***@163.com",
      "auth": {
         "user": "***@163.com",
         "pass": "*****"
      }
  }
}

文件夹vendors
在这里插入图片描述

开始安装

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

使用进程管理工具(如 PM2)
PM2 是一个流行的 Node.js 进程管理工具,可以方便地管理和监控 Node.js 应用。

  1. 安装 PM2:
    npm install -g pm2
  2. 使用 PM2 启动应用:
    pm2 start server/app.js
  3. 查看应用状态:
    pm2 status

如果部分门没有满足 需要根据下面命令选择对应的命令执行

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.npm.taobao.org

同时也可以采用自动化部署方式部署,但容易报错,我就是按这个方式安装报错,后选择上面方法。

### YAPI 的离线安装方法 #### 准备工作 为了成功完成 YAPI 的离线安装,需准备以下资源和工具: - Node.js 安装包[^2]。 - MongoDB 数据库安装包[^3]。 - YAPI 离线安装包[^1]。 #### Windows 平台下的离线安装步骤 对于 Windows 7 或更高版本的操作系统,可以参考以下流程进行 YAPI 的离线下部署: 1. **Node.js 安装** - 下载适用于 Windows 的 Node.js 安装程序,并按照官方指南完成本地安装。 - 验证安装是否成功可以通过命令 `node -v` 和 `npm -v` 来确认其版本号。 2. **MongoDB 安装** - 获取 MongoDB 的 Windows 版本安装包,并将其解压至指定路径。 - 修改配置文件以适配本地环境需求,并启动 MongoDB 服务。 3. **YAPI 安装包导入** - 将 YAPI 的离线安装包放置于目标机器上,并通过 NPM 进行全局安装或手动运行脚本来初始化项目。 以下是部分关键操作的代码示例: ```bash # 启动 MongoDB 服务 (Windows CMD 中执行) "C:\Program Files\MongoDB\Server\<version>\bin\mongod.exe" --dbpath="C:\data\db" # 初始化 YAPI 项目 npm install yapi-cli -g yapi server init ./config.json ``` --- #### Linux 平台下的离线安装步骤 针对基于 Unix/Linux 的操作系统,推荐采用以下方式实现 YAPI 的离线部署: 1. **创建必要的目录结构** 创建 `/home/opt/package` 文件夹作为存储所有安装包的位置,并设置权限以便后续操作正常进行: ```bash mkdir -p /home/opt/package chmod 755 /home/opt/package ``` 2. **安装 Node.js** 解压缩已下载好的 Node.js 软件包,并调整路径使其生效[^4]: ```bash tar -xvf node-v12.13.0-linux-x64.tar.xz mv node-v12.13.0-linux-x64 /usr/local/node echo 'export PATH=/usr/local/node/bin:$PATH' >> /etc/profile source /etc/profile ``` 3. **安装 MongoDB** 将 MongoDB 的二进制分发版上传到服务器上的对应位置后展开并测试连接功能: ```bash tar -zxvf mongodb-linux-x86_64-<version>.tgz -C /opt/mongodb/ ln -s /opt/mongodb/bin/* /usr/bin/ mongod --fork --logpath /var/log/mongodb.log --dbpath /data/db ``` 4. **部署 YAPI 应用** 使用 npm 工具加载所需的依赖项以及配置初始数据源链接地址等参数: ```javascript const config = { port: 3000, db: { host: '127.0.0.1', database: 'yapi' } }; module.exports = config; ``` 最后一步就是确保防火墙允许外部访问所设定的服务端口(默认为 3000),从而能够顺利浏览 API 文档界面。 ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

心系代码

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值