基于docker安装yapi接口文档服务

一、 安装 Docker

如果系统中尚未安装 Docker，执行以下命令安装并启动 Docker：

# 安装 Docker
yum install -y yum-utils
yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
yum install -y docker-ce docker-ce-cli containerd.io

# 启动 Docker 并设置开机自启
systemctl start docker
systemctl enable docker

二、启动 MongoDB 容器

2.1 YApi 使用 MongoDB 作为数据库。我们创建一个数据卷来持久化存储数据：

# 创建数据卷
docker volume create mongo_data_yapi

# 运行 MongoDB 容器（使用 4.4 版本，稳定且兼容）
docker run -d \
  --name mongo-yapi \
  -v mongo_data_yapi:/data/db \
  -p 27017:27017 \
  --restart always \
  mongo:4.4

说明：--restart always 确保容器在退出或重启后自动启动。

2.2 初始化 YApi 数据库

YApi 需要初始化数据库表结构和默认管理员账号。执行以下一次性命令完成初始化：

docker run -it --rm \
  --link mongo-yapi:mongo \
  --entrypoint npm \
  --workdir /api/vendors \
  registry.cn-hangzhou.aliyuncs.com/anoy/yapi \
  run install-server

当控制台输出 初始化管理员账号成功, 账号名："admin@admin.com"，密码："ymfe.org" 时，表示初始化完成。

三、 启动 YApi 服务

3.1 使用以下命令启动 YApi 容器，并将容器的 3000 端口映射到宿主机：

docker run -it --rm \
  --link mongo-yapi:mongo \
  --entrypoint npm \
  --workdir /api/vendors \
  registry.cn-hangzhou.aliyuncs.com/anoy/yapi \
  run install-server

3.2 验证部署

在浏览器中访问 http://<你的服务器IP>:3000，出现登录页面即表示部署成功。

• 默认账号：admin@admin.com

• 默认密码：ymfe.org

登录后请立即修改密码。