记一次 Centos7.x YApi 私有化部署

最新推荐文章于 2024-08-15 10:30:01 发布
置顶 最新推荐文章于 2024-08-15 10:30:01 发布
阅读量1.7k 收藏 4
点赞数 2
分类专栏： 团队协作工具 Linux-Centos x.x 开发工具 文章标签： 经验分享 node.js centos 服务器
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/llwy1428/article/details/113408974
版权

一、基本信息

官网：https://hellosean1025.github.io/yapi/
开源中国：https://www.oschina.net/p/yapi?hmsr=aladdin1e1
教程： https://hellosean1025.github.io/yapi/documents/index.html
内网部署：https://hellosean1025.github.io/yapi/devops/index.html
开发Api ：https://hellosean1025.github.io/yapi/openapi.html

二、工具、环境

1、工具：xshell5
2、VMware 版本：VMware Workstation Pro15
3、虚拟机安装 Centos7.x
参考 https://blog.csdn.net/llwy1428/article/details/89328381
4、NodeJS v8.17
参考 https://blog.csdn.net/llwy1428/article/details/111880286
5、MongoDB v4.0.22
参考https://blog.csdn.net/llwy1428/article/details/93462075

三、系统配置

1、防火墙配置开启指定端口

[root@localhost ~]# firewall-cmd --list-all
[root@localhost ~]# firewall-cmd --permanent --add-port=9090/tcp
[root@localhost ~]# firewall-cmd --permanent --add-port=3000/tcp
[root@localhost ~]# service firewalld restart

关闭防火墙（不推荐）

关闭防火墙    ：[root@localhost ~]# systemctl stop firewalld
查看状态      ： [root@localhost ~]# systemctl status firewalld
开机禁用      ： [root@localhost ~]# systemctl disable firewalld

2、禁用 SELinux
参考 https://blog.csdn.net/llwy1428/article/details/100938748

四、MongoDB v4.0.22 安装部署

1、MongoDB 官网下载页面
https://www.mongodb.com/try/download/community
说明：本文中 MongoDB 选择了 v4.0.22 版本，没有选择最新版本。
2、系统创建目录

[root@master ~]# mkdir -p /opt/mongodb

3、下载安装文件

[root@master ~]# wget -P /opt/mongodb https://fastdl.mongodb.org/linux/mongodb-linux-x86_64-4.0.22.tgz

在这里插入图片描述
4、进入安装包所在目录

[root@master ~]# cd /opt/mongodb/

5、解压缩安装文件、查看文件目录

# 解压缩文件
[root@master mongodb]# tar zxf mongodb-linux-x86_64-4.0.22.tgz

在这里插入图片描述
6、创建目录、赋权（用来存放数据、日志、配置文件）

[root@master ~]# mkdir /opt/mongodb/mongodb-linux-x86_64-4.0.22/data
[root@master ~]# mkdir /opt/mongodb/mongodb-linux-x86_64-4.0.22/log
[root@master ~]# mkdir /opt/mongodb/mongodb-linux-x86_64-4.0.22/conf

7、创建、编辑配置文件

[root@master ~]# vim /opt/mongodb/mongodb-linux-x86_64-4.0.22/conf/mongodb.conf

8、编辑、写入内容

# 端口
port=27017
# 数据库存文件存放目录  
dbpath= /opt/mongodb/mongodb-linux-x86_64-4.0.22/data
#日志文件存放路径
logpath= /opt/mongodb/mongodb-linux-x86_64-4.0.22/log/mongodb.log
#使用追加的方式写日志
logappend=true
#不以守护程序的方式启用，即不在后台运行
fork=true
#最大同时连接数
maxConns=100
#不启用验证
noauth=true
#每次写入会记录一条操作日志（通过journal可以重新构造出写入的数据）
journal=true
#即使宕机，启动时wiredtiger会先将数据恢复到最近一次的checkpoint点，然后重放后续的journal日志来恢复。
#storageEngine=wiredTiger  #存储引擎有mmapv1、wiretiger、mongorocks
#这样就可外部访问了，例如从win10中去连虚拟机中的MongoDB
bind_ip = 0.0.0.0

9、给目录授权

[root@master ~]# chmod 755 -R /opt/mongodb/

10、编辑系统配置文件

[root@master ~]# vim /etc/profile

11、编辑、写入内容

export MONGODB_HOME="/opt/mongodb/mongodb-linux-x86_64-4.0.22"
export PATH=$PATH:$MONGODB_HOME/bin

12、使配置的系统环境变量生效

[root@master ~]# source /etc/profile

13、查看 MongoDB 版本

[root@master ~]# mongod -v

在这里插入图片描述
14、MongoDB 服务启动（根据自己需要选择启动形式）

# 控制台启动
[root@master ~]# mongod -f /opt/mongodb/mongodb-linux-x86_64-4.0.22/conf/mongodb.conf
# 后台启动
[root@master ~]# nohup  mongod -f /opt/mongodb/mongodb-linux-x86_64-4.0.22/conf/mongodb.conf &

15、查看服务的启动情况

[root@master ~]# netstat -lntp
tcp        0      0 0.0.0.0:27017           0.0.0.0:*               LISTEN      2165/mongod

16、进入 MongoDB 的命令行创建数据库（此处我没设置密码，生产、开发过程中建议设置密码）

[root@master ~]# mongo
> show dbs;
admin   0.000GB
config  0.000GB
local   0.000GB
> use yapi;
switched to db yapi
> db;
yapi

17、MongoDB 其他安装、操作方式
docker 安装

// 1.docker  环境配置（略）
// 2.运行mongo服务，因为是测试所以也不设置用户名密码了
docker run -d --name yapi-mongo -p 27017:27017 mongo
// 3.进入mongo服务
docker exec -it yapi-mongo bash
// 4.进入mongo交互命令环境
mongo
// 5.创建名为yapi的DB，这个在可视化部署用得上
use yapi
// 6.查看所有DB
show dbs

五、内网部署 YApi

1、Nodejs环境安装
参考 https://blog.csdn.net/llwy1428/article/details/111880286
其他参考 官网

sudo yum install gcc-c++ make
curl -sL https://dl.yarnpkg.com/rpm/yarn.repo | sudo tee /etc/yum.repos.d/yarn.repo
sudo yum install yarn
curl --silent --location https://rpm.nodesource.com/setup_10.x | sudo bash -
sudo yum -y install nodejs

2、方式一

2.1、npm 安装 yapi

[root@master ~]# npm install -g yapi-cli --registry https://registry.npm.taobao.org
# 进行初始化
[root@master ~]# yapi server
在浏览器打开 http://0.0.0.0:9090 访问。非本地服务器，请将 0.0.0.0 替换成指定的域名或ip

2.2、创建系统目录，来存放 yapi 安装文件

[root@master ~]# mkdir -p /opt/util/my-yapi

2.3、浏览器录入 http://【 你服务器的 IP 】:9090/
YApi 平台初始化
（1）选择版本、公司名称、部署在系统中的绝对路径
（2）YApi 平台的端口
（3）MongoDB 数据库所在服务的 IP
（4）MongoDB 数据库服务的端口
（5）MongoDB 数据库中创建的数据库（存放 YApi 使用过程中的所有数据）
（6）如果 MongoDB 中设置了密码，则要填写相应的数据库认证
在这里插入图片描述
2.4、开始部署（需要几分钟）
在这里插入图片描述
2.5、部署完毕
在这里插入图片描述
控制台信息
在这里插入图片描述
2.6、初始化管理员账号成功,账号名：“admin@admin.com”，密码：“ymfe.org”
部署成功，请切换到部署目录，输入： “node vendors/server/app.js” 指令启动服务器, 然后在浏览器打开 http://【YApi 服务器 IP】:3000 访问

2.7、进入 YApi 的系统部署目录 /opt/util/my-yapi/ 查看目录文件

[root@master ~]# cd /opt/util/my-yapi/
[root@master my-yapi]# ll
总用量 8
-rw-r--r--  1 root root  362 1月  30 01:04 config.json
-rw-r--r--  1 root root    0 1月  30 01:05 init.lock
drwxr-xr-x  2 root root   24 1月  30 01:05 log
drwxr-xr-x 10 root root 4096 1月  30 01:05 vendors

2.8、查看 YApi 的配置文件信息

[root@master my-yapi]# cat config.json 
{
   "port": "3000",
   "adminAccount": "admin@admin.com",
   "db": {
      "servername": "192.168.11.21",
      "DATABASE": "yapi",
      "port": "27017"
   },
   "mail": {
      "enable": false,
      "host": "smtp.163.com",	//邮箱服务器
      "port": 465,				//端口
      "from": "***@163.com",	//发送人邮箱
      "auth": {
         "user": "***@163.com",	//邮箱服务器账号
         "pass": "*****"		//邮箱服务器密码
      }
   }
}

2.9、配置 LDAP 登录

[root@master my-yapi]# vim config.json 
{
   "port": "3000",
   "adminAccount": "admin@admin.com",
   "db": {
      "servername": "192.168.11.21",
      "DATABASE": "yapi",
      "port": "27017"
   },
   "mail": {
      "enable": false,
      "host": "smtp.163.com",	//邮箱服务器
      "port": 465,				//端口
      "from": "***@163.com",	//发送人邮箱
      "auth": {
         "user": "***@163.com",	//邮箱服务器账号
         "pass": "*****"		//邮箱服务器密码
      }
   },
   "ldapLogin": {
      "enable": true,
      "server": "ldap://l-ldapt1.com",
      "baseDn": "CN=Admin,CN=Users,DC=test,DC=com",
      "bindPassword": "password123",
      "searchDn": "OU=UserContainer,DC=test,DC=com",
      "searchStandard": "mail",    // 自定义格式： "searchStandard": "&(objectClass=user)(cn=%s)"
      "emailPostfix": "@163.com",
      "emailKey": "mail",
      "usernameKey": "name"
   }
}

LDAP 登录里面的配置项含义如下：
enable 表示是否配置 LDAP 登录，true(支持 LDAP登录 )/false(不支持LDAP登录);
server LDAP 服务器地址，前面需要加上 ldap:// 前缀，也可以是 ldaps:// 表示是通过 SSL 连接;
baseDn LDAP 服务器的登录用户名，必须是从根结点到用户节点的全路径(非必须);
bindPassword 登录该 LDAP 服务器的密码(非必须);
searchDn 查询用户数据的路径，类似数据库中的一张表的地址，注意这里也必须是全路径;
searchStandard 查询条件，这里是 mail 表示查询用户信息是通过邮箱信息来查询的。注意，该字段信息与LDAP数据库存储数据的字段相对应，如果如果存储用户邮箱信息的字段是 email, 这里就需要修改成 email.（1.3.18+支持）自定义filter表达式，基本形式为：&(objectClass=user)(cn=%s), 其中%s会被username替换
emailPostfix 登陆邮箱后缀（非必须）
emailKey: ldap数据库存放邮箱信息的字段（v1.3.21 新增 非必须）
usernameKey: ldap数据库存放用户名信息的字段（v1.3.21 新增 非必须）
重启服务器后，可以在登录页看到如下画面，说明 ladp 配置成功

2.10、YApi 服务启动

# 控制台启动
[root@master my-yapi]# node vendors/server/app.js
# 后台启动（ 使用 pm2 启动、管理 app.js ）
[https://blog.csdn.net/llwy1428/article/details/113487584](https://blog.csdn.net/llwy1428/article/details/113487584)

2.11、我使用了控制台启动

[root@master my-yapi]# node vendors/server/app.js
log: -------------------------------------swaggerSyncUtils constructor-----------------------------------------------
log: 服务已启动，请打开下面链接访问: 
http://127.0.0.1:3000/
log: mongodb load success...

2.12、查看启动状态

[root@master ~]# netstat -lntp
tcp        0      0 0.0.0.0:27017           0.0.0.0:*               LISTEN      2165/mongod 
tcp6       0      0 :::3000                 :::*                    LISTEN      2376/node

3、方式二（官网）我这里没有具体操作

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

六、基本配置、操作

1、浏览器地址栏录入 http://【YApi 服务器 IP】:3000 可进入首页
在这里插入图片描述
2、点击 登录 / 注册 使用管理员默认账号和密码登录
账号：“admin@admin.com”，密码：“ymfe.org”
在这里插入图片描述
3、引导
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
在这里插入图片描述
4、新建项目
在这里插入图片描述
5、项目列表
在这里插入图片描述
6、添加接口在这里插入图片描述
7、接口列表
在这里插入图片描述
8、接口基本信息
在这里插入图片描述
9、测试集合
在这里插入图片描述
10、测试集合下配置要测试的已有接口
在这里插入图片描述
在这里插入图片描述
11、动态：系统操作日志
在这里插入图片描述
12、数据管理
在这里插入图片描述
13、设置—项目配置
在这里插入图片描述
14、设置—环境配置
在这里插入图片描述
15、设置—请求配置
在这里插入图片描述
16、设置—token配置
在这里插入图片描述
17、设置—全局 mock 脚本
在这里插入图片描述
18、设置—生产 ts services
在这里插入图片描述
19、设置— Swagger 同步
在这里插入图片描述
20、Wiki 文档管理
在这里插入图片描述
在这里插入图片描述
21、系统管理员—个人中心
在这里插入图片描述
22、系统管理员—个人设置
在这里插入图片描述
23、系统管理员—用户管理
在这里插入图片描述
24、非管理员注册
在这里插入图片描述
25、系统管理员—查看所有人员列表，管理员可修改指定人员密码等
在这里插入图片描述
26、系统管理员—系统信息
在这里插入图片描述
27、添加分组
在这里插入图片描述
28、给新建的小组添加新项目，按分组显示项目列表
在这里插入图片描述
29、对小组添加成员，可指定成员权限
在这里插入图片描述
30、查看小组成员列表
在这里插入图片描述
31、普通用户的个人设置
在这里插入图片描述

至此，Centos7.x YApi 私有化部署、基本操作完毕，希望能够对您有所帮助！

一花一世界~
关注
专栏目录
Centos7.x 运维常用命令总结（每天记录一点点）
叱咤少帅的博客
06-09 6089
Centos7.x 运维常用命令总结（每天记录一点点）
Centos7.x 安装中文字体库
叱咤少帅的博客
06-09 6005
背景 接到开发的需求，由于合同部分需要用到宋体来生成文件，服务器需要安装宋体字体。而应用服务器用的操作系统的版本如下: $cat /etc/redhat-release CentOS Linux release 7.5.1804 (Core) 检查支持哪些字体 $fc-list $fc-list|grep sim 我们发现并没有 宋体 和开题等字体文件。 安装字体库 如果 fc-list 没有这个命令的话，请通过如下方式进行安装 yum -y install fontconfig
【YApi接口管理平台】在Linux上使用Docker搭建YApi (亲测完美运行)
Sihang_Xie的博客
12-21 1910
博主想在自己的 Linux 虚拟机上使用 Docker 搭建 API 接口管理平台来团队开发一个项目，跟着网上的教程硬是装了好几次，都是在 YApi 登录界面点击【登录】无反应，今天终于把等成功登录的搭建步骤整理出来了。基本上直接粘贴命令一把梭就能装完，方便快捷，希望对你有帮助。
yapi部署
strivelcy的博客
11-24 559
yapi 部署
搭建一个适合企业和个人私有化部署使用的WIKI知识库管理系统
最新发布
xxue345678的博客
08-15 761
zyplayer-doc是一款适合企业和个人使用的WIKI知识库管理工具，提供在线化的知识库管理功能，专为私有化部署而设计，最大程度上保证企业或个人的数据安全，可以完全以内网的方式来部署使用它。您也可以将其作为企业产品的说明文档来使用，支持一键将整个空间的内容开放到互联网，提供有不同风格的开放文档页样式可供选择，以及适配了在手机端、小程序中文档的展示，省去为产品的说明文档而定制开发系统的成本。
MongoDB：创建用户
Methun
12-13 773
db.createUser( { user: "zhibo", pwd: "123456", roles: [ { role: "readWrite", db: "zhibo" } ] } Read：允许用户读取指定数据库 readWrite：允许用户读写指定数据库 dbAdmin：允许用户在指定数据库中执行管理函数，如索引创建、删除，查看统计或
centos7上安装YAPI项目【软件搭建】
大火yzs
05-18 373
linux上安装YAPI项目 【软件搭建】 YAPI安装 1.安装node curl -O https://nodejs.org/dist/v10.9.0/node-v10.9.0-linux-x64.tar.xz #下载 tar xf node-v10.9.0-linux-x64.tar.xz #解压 ln -s 【node解压包路径】/bin/npm /usr/local/bin/ #快捷方式 ln -s 【node解压包路径】/bin/node /usr/loca
CentOS7 安装 YAPI
Able
03-24 205
https://blog.csdn.net/dwyane__wade/article/details/103326927
YApi轻松部署
qq_43429919的博客
12-07 3346
如何轻松安装YApi，从node，到mongodb，再到YApi一文足够，在windows、linux部署时常见问题与解决方案
CentOS7部署YApi
变成习惯
09-29 801
YApi 是高效、易用、功能强大的 api 管理平台，旨在为开发、产品、测试人员提供更优雅的接口管理服务。可以帮助开发者轻松创建、发布、维护 API，YApi 还为用户提供了优秀的交互体验，开发人员只需利用平台提供的接口数据写入工具以及简单的点击操作就可以实现接口的管理。 github地址：https://github.com/YMFE/yapi 特性： 基于 Json5 和 Mockjs 定义接口返回数据的结构和文档，效率提升多倍 扁平化权限设计，即保证了大型企业级项目的管理，又保证了易用性 类似
CentOS7安装部署YApi笔记
南山有谷堆
07-23 523
CentOS7安装部署YApi笔记 安装环境准备 PS：我这里全程拥有root权限的，包括mongo，所以不存在文件夹没权限之类 nodejs & npm安装 我使用的是wget下载然后手动安装，前期有试过yum安装但是版本是6.17左右（YApi要求最低版本7.6+），按照网上的升级教程又总没折腾成功就放弃了转为手动安装，也并不复杂。首先输入下面确认你是否有wget，直接命令行输入wget如果有的话会提示“wget：未指定 URL”之类信息，没有的话直接yum -y install wget安装即
centos7.x安装最新版YAPI(1.18.8)
热门推荐
weixin_42183854的博客
03-12 1万+
文章目录官方地址机器环境安装YAPI基础环境nodejs安装1.下载安装包:2. 解压到指定目录下3.建立软连接4.安装cnpm(可略,我们此次安装不用)安装mongodb官方安装docker安装 官方地址 https://github.com/YMFE/yapi 机器环境 lsb_release -a 安装YAPI基础环境 nodejs（7.6+) mongodb（2.6+） git n...
Centos7安装部署YApi
czxboys的博客
05-30 2444
Centos7安装部署YApi YApi官网教程：内网部署 (hellosean1025.github.io) 下载前需要安装部署node和MongoDB，安装教程见Linux-常用软件安装（2）_czxboys的博客-CSDN博客 的第8，9小节。 1、安装YApi npm install -g yapi-cli --registry https://registry.npm.taobao.org # 会有WARN的警告，无视就可以 mkdir -p /usr/local/yapi cd /usr
CentOS 7.x 内核kernel版本升级实操
海渊_haiyuan的博客
11-28 5181
文章目录CentOS 7.x 内核kernel版本升级实操前言实操记录升级前信息查看和准备升级 CentOS 7.× 内核,启用 ELRepo设置 GRUB 默认的内核版本删除 CentOS 更新后的旧内核 CentOS 7.x 内核kernel版本升级实操 前言 在玩耍kubernetes 集群中(之前部署的一套，可以查看我之前的博客内容)，想要尝试部署的CNI Cilium 仅在 kernel 4.8 版本以上支持，推荐使用4.9 以上内核版本；而之前部署使用的CentOS 7.6 缺省内核版本为3.1
centOS 部署YApi api管理平台
As的博客
02-21 160
前提：已安装node.js 7.6+、mongodb 2.6+ 配置mongodb 进入mongodb mongo 创建 yapi数据库 use yapi 添加用户 db.createUser({ user: "用户", pwd: "密码", roles: [{role: "dbOwner",db: "yapi"}] }) 退出mongodb ^C 即Ctrl + C 创建并进入目录 mkdir yapi cd yapi 下载YApi源码 方式一： 执行命令 git clone ht
Yapi简介和部署
wokoone的博客
08-30 982
Yapi简介和部署
yapi服务搭建
weixin_60092693的博客
01-08 692
学习笔记
一款私有化部署的企业级在线文档和知识库
02-16 1654
基础说明：无忧企业文档是JVS体系下的一款企业协同在线文档，主要服务客群为企业用户，解决企业内部文档编辑、知识沉淀、知识协同等痛点。项目主要采用Java开发，基础框架采用JVS（spring cloud+Vue）
顶尖 API 文档管理工具 (YAPI)
闪电小子
03-21 288
链接：https://www.jianshu.com/p/a97d2efb23c5。商业转载请联系作者获得授权，非商业转载请注明出处。最后编辑于 ：2020.12.17 14:16:02。值修改为你需要构建的 YAPI 版本。稍微有一丢丢麻烦，看心情解决。
CentOS 7.x 主从DNS服务器部署详解与配置步骤
在 CentOS 7.x 系统上部署主、从DNS服务器是一项常见的网络管理任务，它有助于提高网络的可靠性和性能。以下步骤将详细指导如何在两台 CentOS 7.x 服务器（例如：192.168.219.146为主服务器，192.168.219.147为从...
评论 1
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

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

余额充值