Skip to main content

Rocky Linux 上 Docker 部署 YAPI 指南

YAPI 是一个高效、易用的可视化接口管理平台，通过 Docker 可以快速部署。以下是在 Rocky Linux 上使用 Docker 部署 YAPI 的完整步骤。

一、准备工作

1. 系统要求

  • Rocky Linux 8 或更高版本
  • 至少 2GB 内存
  • 10GB 可用磁盘空间

2. 安装必要工具

sudo dnf install -y yum-utils device-mapper-persistent-data lvm2

二、安装 Docker

1. 添加 Docker CE 仓库

sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

2. 安装 Docker 引擎

sudo dnf install -y docker-ce docker-ce-cli containerd.io

3. 启动并设置开机自启

sudo systemctl enable --now docker

4. 验证安装

sudo docker version

三、安装 Docker Compose

1. 下载 Docker Compose

sudo curl -L "https://github.com/docker/compose/releases/download/v2.23.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

2. 设置执行权限

sudo chmod +x /usr/local/bin/docker-compose

3. 验证安装

docker-compose --version

四、部署 YAPI

1. 创建部署目录

mkdir ~/yapi && cd ~/yapi

2. 创建 docker-compose.yml 文件

version: '3'
services:
  yapi-mongo:
    image: mongo:4
    container_name: yapi-mongo
    volumes:
      - ./mongo-data:/data/db
    restart: always
    environment:
      - MONGO_INITDB_ROOT_USERNAME=root
      - MONGO_INITDB_ROOT_PASSWORD=example
    ports:
      - "27017:27017"
    networks:
      - yapi-net

  yapi-web:
    image: jayfong/yapi:latest
    container_name: yapi-web
    depends_on:
      - yapi-mongo
    ports:
      - "3000:3000"
    environment:
      - YAPI_ADMIN_ACCOUNT=admin@yapi.com
      - YAPI_ADMIN_PASSWORD=admin123
      - YAPI_CLOSE_REGISTER=true
      - YAPI_DB_SERVERNAME=yapi-mongo
      - YAPI_DB_PORT=27017
      - YAPI_DB_DATABASE=yapi
      - YAPI_DB_USER=root
      - YAPI_DB_PASS=example
      - YAPI_DB_AUTH_SOURCE=admin
    restart: always
    networks:
      - yapi-net

networks:
  yapi-net:
    driver: bridge

3. 启动 YAPI 服务

docker-compose up -d

五、访问和初始化

1. 等待服务启动

首次启动需要 2-3 分钟初始化时间

2. 访问 YAPI

在浏览器中访问：

http://服务器IP:3000

3. 登录信息

  • 管理员账号：admin@yapi.com
  • 密码：admin123

六、配置优化

1. 修改默认密码

首次登录后务必修改管理员密码

2. 邮件通知配置

在 YAPI 管理界面配置 SMTP 邮件服务

3. 数据备份

# 备份 MongoDB 数据
docker exec yapi-mongo sh -c 'exec mongodump -d yapi --archive' > yapi-backup-$(date +%Y%m%d).archive

七、日常维护

1. 查看服务状态

docker-compose ps

2. 查看日志

docker-compose logs -f

3. 更新 YAPI

docker-compose pull yapi-web
docker-compose up -d

4. 停止服务

docker-compose down

八、安全建议

  1. 修改默认端口（通过修改 docker-compose.yml 中的端口映射）
  2. 配置 Nginx 反向代理并启用 HTTPS
  3. 定期备份 MongoDB 数据
  4. 限制访问 IP（通过防火墙或 Nginx 配置）

通过以上步骤，您已在 Rocky Linux 上成功部署了 YAPI 接口管理平台。根据团队需求，可以在 YAPI 中创建项目、接口和分组，提高接口管理效率。

No Comments
Back to top