c handbook-master/docs/CentOS

部署YApi平台
Edited: Tuesday 7 July 2026

部署YApi平台

YApi 是高效、易用、功能强大的api管理平台,开源仓库。

安装环境

安装 Node.js,官方安装方法

1# On RHEL, CentOS or Fedora, for Node.js v8 LTS:
2curl --silent --location https://rpm.nodesource.com/setup_8.x | sudo bash -
3# Alternatively for Node.js 9:
4curl --silent --location https://rpm.nodesource.com/setup_9.x | sudo bash -
5# 安装 Node.js
6sudo yum -y install nodejs
7# Enterprise Linux(RHEL和CentOS)用户可以使用EPEL存储库中的Node.js和npm包。
8# 为您的版本安装相应的epel-release RPM(在EPEL存储库主页上找到),然后运行:
9sudo yum install nodejs npm --enablerepo=epel

安装构建工具,要从npm编译和安装本地插件,您可能还需要安装构建工具:

1sudo yum install gcc-c++ make
2# or: sudo yum groupinstall 'Development Tools'

安装 MongoDB,首先创建源,创建 mongodb.repo 文件

1# 在/etc/yum.repos.d/目录下创建文件mongodb.repo,它包含MongoDB仓库的配置信息,内容如下:
2# 复制代码, 代码如下:
3[mongodb]
4name=MongoDB Repository
5baseurl=http://downloads-distro.mongodb.org/repo/redhat/os/x86_64/
6gpgcheck=0
7enabled=1

yum 安装 MongoDB

sudo yum install mongodb-org

为 YApi 初始数据库

 1use yapi // 创建yapi数据库 
 2db.wong.insert({"name":"kenny wong"}) // 插入一条数据,将在数据库列表中展示
 3show dbs // 查看所有数据库
 4db.addUser('yapi','yapi321') // 老的,数据库加用户的命令
 5
 6// 新的数据库添加用户命令
 7db.createUser(
 8  {
 9    user: "yapi",
10    pwd: "yapi321",
11    roles:
12    [
13      {
14        role: "userAdminAnyDatabase",
15        db: "yapi"
16      }
17    ]
18  }
19)

安装YApi

  1. 创建工程目录
1mkdir yapi && cd yapi
2git clone https://github.com/YMFE/yapi.git vendors --depth=1 # 或者下载 zip 包解压到 vendors 目录
  1. 修改配置
1cp vendors/config_example.json ./config.json # 复制完成后请修改相关配置
2vi ./config.json

配置如下,主要配置 MongoDB 数据库,以及 Admin 账号。

 1{
 2  "port": "3011",
 3  "adminAccount": "admin@admin.com",
 4  "db": {
 5    "servername": "127.0.0.1",
 6    "DATABASE":  "yapi",
 7    "port": 27017,
 8    "user": "yapi",
 9    "pass": "yapi123"
10  },
11  "mail": {
12    "enable": true,
13    "host": "smtp.163.com",
14    "port": 465,
15    "from": "***@163.com",
16    "auth": {
17        "user": "***@163.com",
18        "pass": "*****"
19    }
20  }
21}
  1. 安装依赖
1cd vendors
2npm install --production --registry https://registry.npmmirror.com # 安装依赖
  1. 初始化
1npm run install-server  # 安装程序会初始化数据库索引和管理员账号,管理员账号名可在 config.json 配置
2# 默认输出
3# 初始化管理员账号成功,账号名:"admin@admin.com",密码:"ymfe.org"
  1. 启动服务
1# 后台启动,输出日志yapi.log
2node server/app.js >> yapi.log 2>&1 & 
3# 启动服务器后,请访问 127.0.0.1:{config.json配置的端口},初次运行会有个编译的过程,请耐心等候
4# 127.0.0.1:3011