安装依赖

# mongodb
brew tap mongodb/brew
brew install mongodb-community@4.2
 
# 查看服务状态
brew services list
 
# 启动 mongodb
brew services start mongodb-community
 
# nginx
brew install nginx
 
# 启动 nginx
sudo brew services start nginx
 
# node.js 直接从官网下载 dmg 包安装

安装 & 运行

第一种办法:

# 安装
npm install -g yapi-cli
 
# 直接运行
yapi server
 
# 放到后台运行
nohup yapi server > /tmp/yapi.log &

安装简单,运行迅速,但是没找到修改端口的办法。由于我本地的 9090 端口已经被占用,导致无法运行。

第二种办法:

mkdir yapi
cd yapi
git clone https://github.com/YMFE/yapi.git vendors
 
# 配置
cp vendors/config_example.json ./config.json
vim config.json # 参见后面的说明,我把端口号改成了 3333
 
# 安装依赖
cd vendors
npm install --production --registry https://registry.npm.taobao.org
 
# 运行
npm run install-server
node server/app.js
 
# 运行成功效果:
MCDTONY:vendors cn-tonylu$ npm run install-server
 
> yapi-vendor@1.9.2 install-server /Users/cn-tonylu/workspace/examples/yapi/vendors
>  node server/install.js
 
log: mongodb load success...
初始化管理员账号成功,账号名:"admin@admin.com",密码:"ymfe.org"
MCDTONY:vendors cn-tonylu$ node server/app.js
log: -------------------------------------swaggerSyncUtils constructor-----------------------------------------------
log: 服务已启动,请打开下面链接访问:
http://127.0.0.1:3333/
log: mongodb load success...

安装后的目录结构如下:

|-- config.json
|-- init.lock
|-- log
`-- vendors
    |-- CHANGELOG.md
    |-- LICENSE
    |-- README.md
    |-- client
    |-- common
    |-- config_example.json
    |-- doc
    |-- exts
    |-- nodemon.json
    |-- npm-debug.log
    |-- package.json
    |-- plugin.json
    |-- server
    |-- static
    |-- test
    |-- webpack.alias.js
    |-- yapi-base-flow.jpg
    |-- ydocfile.js
    `-- ykit.config.js

笔者的配置文件参考(修改了端口号,将 mongodb 的账户密码置空):

{
  "port": "3333",
  "adminAccount": "admin@admin.com",
  "timeout":120000,
  "db": {
    "servername": "127.0.0.1",
    "DATABASE": "yapi",
    "port": 27017,
    "user": "",
    "pass": "",
    "authSource": ""
  },
  "mail": {
    "enable": true,
    "host": "smtp.163.com",
    "port": 465,
    "from": "***@163.com",
    "auth": {
      "user": "***@163.com",
      "pass": "*****"
    }
  }
}

Nginx 代理转发

首先配置hosts:

# 在 /etc/hosts 文件里新增一条记录:
127.0.0.1  yapi.tony.com

配置 Nginx:

cd /usr/local/etc/nginx/servers/
vim yapi
 
# 内容如下:
server {
    listen 80;
    server_name yapi.tony.com;
    location / {
        proxy_pass http://127.0.0.1:3333;
    } 
}
 
# 最后重启或重新加载 nginx 配置:
sudo brew services restart nginx

即可通过域名访问: http://yapi.tony.com/

根据安装时的提示信息,初始化管理员账号成功,账号名:"admin@admin.com",密码:"ymfe.org"。

标签: none

添加新评论