原創

      docker-compose部署yapi

? 完整 docker-compose.yml（推薦直接使用）

# cat docker-compose.yml
version: '3.8'

services:
  mongo:
    image: mongo:4.4
    container_name: yapi-mongo
    restart: always
    volumes:
      - ./data/mongo/db:/data/db
    environment:
      MONGO_INITDB_ROOT_USERNAME: yapi
      MONGO_INITDB_ROOT_PASSWORD: yapi_password
    networks:
      - yapi-network

  yapi:
    image: jayfong/yapi:latest
    container_name: yapi-server
    restart: always
    depends_on:
      - mongo
    ports:
      - "3000:3000"
    volumes:
      - ./data/yapi/plugins:/yapi/plugins
      - ./data/yapi/logs:/yapi/logs
      - ./data/yapi/certs:/yapi/certs
      #   config.json
      - ./config.json:/yapi/config.json
    environment:
      - YAPI_ADMIN_ACCOUNT=admin@example.com
      - YAPI_ADMIN_PASSWORD=wanyanzhenjiang
      - YAPI_CLOSE_REGISTER=true
      - YAPI_DB_SERVERNAME=mongo
      - YAPI_DB_PORT=27017
      - YAPI_DB_NAME=yapi
      - YAPI_DB_USER=yapi
      - YAPI_DB_PASS=yapi_password
      - YAPI_DB_AUTH_SOURCE=admin
      - YAPI_MAIL_ENABLE=false
      - YAPI_SERVER_HOST=http://localhost:3000
    networks:
      - yapi-network

networks:
  yapi-network:
    driver: bridge

?? 部署命令（一鍵復制）

# 1. 創建項目目錄并進入
mkdir -p /opt/yapi && cd /opt/yapi

# 2. 創建 docker-compose.yml 文件

# 3. 創建config.json
cd /opt/yapi
cat > config.json << 'EOF'
{
  "port": 3000,
  "adminAccount": "admin@example.com",
  "adminPassword": "wanyanzhenjiang",
  "closeRegister": true,
  "db": {
    "servername": "mongo",
    "port": 27017,
    "user": "yapi",
    "pass": "yapi_password",
    "authSource": "admin"
  },
  "mail": {
    "enable": false,
    "auth": {}
  },
  "ldapLogin": {
    "enable": true,
    "server": "ldap://172.19.220.168:389",
    "baseDn": "cn=admin,dc=xiaoma,dc=cn",
    "bindPassword": "xxxxxxxxxxxxx",
    "searchDn": "ou=People,dc=xiaoma,dc=cn",
    "searchStandard": "uid",
    "usernameKey": "description"
  }
}
EOF
# 4. 創建所有持久化目錄
mkdir -p ./data/{mongo/db,yapi/plugins,yapi/logs,yapi/certs}

# 5. 刪除舊容器和數據（首次部署或重置時執行）
docker-compose down
rm -rf ./data/mongo/db/*    # 清空舊數據庫（確保是首次或已備份）

# 6. 啟動服務
docker-compose up -d

# 7. 查看初始化日志（耐心等待 1-2 分鐘）
docker logs -f yapi-server

? 成功標志

當看到以下輸出時，表示成功：

初始化管理員賬號成功: admin@example.com
YApi 初始化完成!
Server running at http://localhost:3000

按 Ctrl+C 退出日志。

?? 驗證端口監聽

netstat -tulnp | grep 3000

應有輸出，表示宿主機正在監聽。

?? 訪問地址

?? http://你的服務器IP:3000

• 賬號：admin@example.com
• 密碼：4Gr8YPXc0d67eyphnjQa

??? 建議后續操作

1. 首次登錄后修改密碼：進入「個人設置」→ 修改密碼。

2. 配置備份腳本（可選）：

   # 示例：每日備份 MongoDB
   0 2 * * * /usr/bin/docker exec yapi-mongo mongodump -u yapi -p yapi_password --authenticationDatabase admin --gzip --archive > /opt/yapi/backup/yapi_$(date +\%F).gz