From 2a3276c1252fae25a5ee67283e043e9ab027fc1d Mon Sep 17 00:00:00 2001
From: d0lwl0b <208416493+d0lwl0b@users.noreply.github.com>
Date: Thu, 30 Oct 2025 12:26:00 +0800
Subject: [PATCH] docs: update Docker Compose documentation to V2 syntax

---
 DOCKER_DEPLOY.en.md |  99 ++++++++++++++++++++++-------------------
 DOCKER_DEPLOY.md    | 104 +++++++++++++++++++++++++-------------------
 README.md           |  10 ++++-
 README.ru.md        |   6 ++-
 README.uk.md        |   6 ++-
 README.zh-CN.md     |   6 ++-
 6 files changed, 135 insertions(+), 96 deletions(-)

diff --git a/DOCKER_DEPLOY.en.md b/DOCKER_DEPLOY.en.md
index 1b9c42f2..bf8adf63 100644
--- a/DOCKER_DEPLOY.en.md
+++ b/DOCKER_DEPLOY.en.md
@@ -15,22 +15,33 @@ Before you begin, ensure your system has:
 Download and install [Docker Desktop](https://www.docker.com/products/docker-desktop/)
 
 #### Linux (Ubuntu/Debian)
+
+> #### Docker Compose Version Notes
+>
+> **New User Recommendation:**
+> - **Use Docker Desktop**: Automatically includes latest Docker Compose, no separate installation needed
+> - Simple installation, one-click setup, provides GUI management
+> - Supports macOS, Windows, and some Linux distributions
+>
+> **Upgrading User Note:**
+> - **Deprecating standalone docker-compose**: No longer recommended to download the independent Docker Compose binary
+> - **Use built-in version**: Docker 20.10+ includes `docker compose` command (with space)
+> - If still using old `docker-compose`, please upgrade to new syntax
+
+*Recommended: Use Docker Desktop (if available) or Docker CE with built-in Compose*
+
 ```bash
-# Install Docker
+# Install Docker (includes compose)
 curl -fsSL https://get.docker.com -o get-docker.sh
 sudo sh get-docker.sh
 
-# Install Docker Compose
-sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
-sudo chmod +x /usr/local/bin/docker-compose
-
-# Add current user to docker group
+# Add user to docker group
 sudo usermod -aG docker $USER
 newgrp docker
 
-# Verify installation
+# Verify installation (new command)
 docker --version
-docker-compose --version
+docker compose --version  # Docker 24+ includes this, no separate installation needed
 ```
 
 ## 🚀 Quick Start (3 Steps)
@@ -69,10 +80,10 @@ nano config.json  # or use any other editor
 
 ```bash
 # Build and start all services (first run)
-docker-compose up -d --build
+docker compose up -d --build
 
 # Subsequent starts (without rebuilding)
-docker-compose up -d
+docker compose up -d
 ```
 
 **Startup options:**
@@ -91,49 +102,49 @@ Once deployed, open your browser and visit:
 ### View Running Status
 ```bash
 # View all container status
-docker-compose ps
+docker compose ps
 
 # View service health status
-docker-compose ps --format json | jq
+docker compose ps --format json | jq
 ```
 
 ### View Logs
 ```bash
 # View all service logs
-docker-compose logs -f
+docker compose logs -f
 
 # View backend logs only
-docker-compose logs -f backend
+docker compose logs -f backend
 
 # View frontend logs only
-docker-compose logs -f frontend
+docker compose logs -f frontend
 
 # View last 100 lines
-docker-compose logs --tail=100
+docker compose logs --tail=100
 ```
 
 ### Stop Services
 ```bash
 # Stop all services (keep data)
-docker-compose stop
+docker compose stop
 
 # Stop and remove containers (keep data)
-docker-compose down
+docker compose down
 
 # Stop and remove containers and volumes (clear all data)
-docker-compose down -v
+docker compose down -v
 ```
 
 ### Restart Services
 ```bash
 # Restart all services
-docker-compose restart
+docker compose restart
 
 # Restart backend only
-docker-compose restart backend
+docker compose restart backend
 
 # Restart frontend only
-docker-compose restart frontend
+docker compose restart frontend
 ```
 
 ### Update Services
@@ -142,7 +153,7 @@ docker-compose restart frontend
 git pull
 
 # Rebuild and restart
-docker-compose up -d --build
+docker compose up -d --build
 ```
 
 ## 🔧 Advanced Configuration
@@ -226,14 +237,14 @@ tar -xzf backup_20241029.tar.gz
 
 ```bash
 # View detailed error messages
-docker-compose logs backend
-docker-compose logs frontend
+docker compose logs backend
+docker compose logs frontend
 
 # Check container status
-docker-compose ps -a
+docker compose ps -a
 
 # Rebuild (clear cache)
-docker-compose build --no-cache
+docker compose build --no-cache
 ```
 
 ### Port Already in Use
@@ -273,10 +284,10 @@ curl http://localhost:3000/health
 
 ```bash
 # Check network connectivity
-docker-compose exec frontend ping backend
+docker compose exec frontend ping backend
 
 # Check if backend service is running
-docker-compose exec frontend wget -O- http://backend:8080/health
+docker compose exec frontend wget -O- http://backend:8080/health
 ```
 
 ### Clean Docker Resources
@@ -321,8 +332,8 @@ docker system prune -a --volumes
 
 4. **Regularly update images**
    ```bash
-   docker-compose pull
-   docker-compose up -d
+   docker compose pull
+   docker compose up -d
    ```
 
 ## 🌐 Production Deployment
@@ -391,7 +402,7 @@ logging:
     max-file: "3"
 
 # View log statistics
-docker-compose logs --timestamps | wc -l
+docker compose logs --timestamps | wc -l
 ```
 
 ### Monitoring Tool Integration
@@ -424,28 +435,28 @@ services:
 
 ```bash
 # Start
-docker-compose up -d --build       # Build and start
-docker-compose up -d               # Start (without rebuilding)
+docker compose up -d --build       # Build and start
+docker compose up -d               # Start (without rebuilding)
 
 # Stop
-docker-compose stop                # Stop services
-docker-compose down                # Stop and remove containers
-docker-compose down -v             # Stop and remove containers and data
+docker compose stop                # Stop services
+docker compose down                # Stop and remove containers
+docker compose down -v             # Stop and remove containers and data
 
 # View
-docker-compose ps                  # View status
-docker-compose logs -f             # View logs
-docker-compose top                 # View processes
+docker compose ps                  # View status
+docker compose logs -f             # View logs
+docker compose top                 # View processes
 
 # Restart
-docker-compose restart             # Restart all services
-docker-compose restart backend     # Restart backend
+docker compose restart             # Restart all services
+docker compose restart backend     # Restart backend
 
 # Update
-git pull && docker-compose up -d --build
+git pull && docker compose up -d --build
 
 # Clean
-docker-compose down -v             # Clear all data
+docker compose down -v             # Clear all data
 docker system prune -a             # Clean Docker resources
 ```
 
diff --git a/DOCKER_DEPLOY.md b/DOCKER_DEPLOY.md
index f48b005e..536ee159 100644
--- a/DOCKER_DEPLOY.md
+++ b/DOCKER_DEPLOY.md
@@ -11,26 +11,42 @@
 
 ### 安装 Docker
 
+> #### 提示：Docker Compose 版本说明
+> 
+> **新用户建议**：
+> - **推荐使用 Docker Desktop**：自动包含最新 Docker Compose，无需单独安装
+> - 安装简单，一键搞定，提供图形界面管理
+> - 支持 macOS、Windows、部分 Linux 发行版
+> 
+> **旧用户提醒**：
+> - **弃用独立 docker-compose**：不再推荐下载独立的 Docker Compose 二进制文件
+> - **使用内置版**：Docker 20.10+ 自带 `docker compose` 命令（注意是空格）
+> - 如果还在使用旧的 `docker-compose`，请升级到新语法
+
 #### macOS / Windows
 下载并安装 [Docker Desktop](https://www.docker.com/products/docker-desktop/)
 
-#### Linux (Ubuntu/Debian)
+**安装后验证：**
 ```bash
-# 安装 Docker
+docker --version
+docker compose --version  # 注意：使用空格，不再是连字符
+```
+
+#### Linux (Ubuntu/Debian)
+**推荐方式：使用 Docker Desktop（如果可用）或 Docker CE**
+
+```bash
+# 安装 Docker (自动包含 compose)
 curl -fsSL https://get.docker.com -o get-docker.sh
 sudo sh get-docker.sh
 
-# 安装 Docker Compose
-sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
-sudo chmod +x /usr/local/bin/docker-compose
-
 # 将当前用户加入 docker 组
 sudo usermod -aG docker $USER
 newgrp docker
 
-# 验证安装
+# 验证安装（新命令）
 docker --version
-docker-compose --version
+docker compose --version  # Docker 24+ 自带，无需单独安装
 ```
 
 ## 🚀 快速开始（3步完成部署）
@@ -69,10 +85,10 @@ nano config.json  # 或使用其他编辑器
 
 ```bash
 # 构建并启动所有服务（首次运行）
-docker-compose up -d --build
+docker compose up -d --build
 
 # 后续启动（不重新构建）
-docker-compose up -d
+docker compose up -d
 ```
 
 **启动过程说明：**
@@ -91,49 +107,49 @@ docker-compose up -d
 ### 查看运行状态
 ```bash
 # 查看所有容器状态
-docker-compose ps
+docker compose ps
 
 # 查看服务健康状态
-docker-compose ps --format json | jq
+docker compose ps --format json | jq
 ```
 
 ### 查看日志
 ```bash
 # 查看所有服务日志
-docker-compose logs -f
+docker compose logs -f
 
 # 只查看后端日志
-docker-compose logs -f backend
+docker compose logs -f backend
 
 # 只查看前端日志
-docker-compose logs -f frontend
+docker compose logs -f frontend
 
 # 查看最近 100 行日志
-docker-compose logs --tail=100
+docker compose logs --tail=100
 ```
 
 ### 停止服务
 ```bash
 # 停止所有服务（保留数据）
-docker-compose stop
+docker compose stop
 
 # 停止并删除容器（保留数据）
-docker-compose down
+docker compose down
 
 # 停止并删除容器和卷（清除所有数据）
-docker-compose down -v
+docker compose down -v
 ```
 
 ### 重启服务
 ```bash
 # 重启所有服务
-docker-compose restart
+docker compose restart
 
 # 只重启后端
-docker-compose restart backend
+docker compose restart backend
 
 # 只重启前端
-docker-compose restart frontend
+docker compose restart frontend
 ```
 
 ### 更新服务
@@ -142,7 +158,7 @@ docker-compose restart frontend
 git pull
 
 # 重新构建并重启
-docker-compose up -d --build
+docker compose up -d --build
 ```
 
 ## 🔧 高级配置
@@ -226,14 +242,14 @@ tar -xzf backup_20241029.tar.gz
 
 ```bash
 # 查看详细错误信息
-docker-compose logs backend
-docker-compose logs frontend
+docker compose logs backend
+docker compose logs frontend
 
 # 检查容器状态
-docker-compose ps -a
+docker compose ps -a
 
 # 重新构建（清除缓存）
-docker-compose build --no-cache
+docker compose build --no-cache
 ```
 
 ### 端口被占用
@@ -273,10 +289,10 @@ curl http://localhost:3000/health
 
 ```bash
 # 检查网络连接
-docker-compose exec frontend ping backend
+docker compose exec frontend ping backend
 
 # 检查后端服务是否正常
-docker-compose exec frontend wget -O- http://backend:8080/health
+docker compose exec frontend wget -O- http://backend:8080/health
 ```
 
 ### 清理 Docker 资源
@@ -321,8 +337,8 @@ docker system prune -a --volumes
 
 4. **定期更新镜像**
    ```bash
-   docker-compose pull
-   docker-compose up -d
+   docker compose pull
+   docker compose up -d
    ```
 
 ## 🌐 生产环境部署
@@ -391,7 +407,7 @@ logging:
     max-file: "3"
 
 # 查看日志统计
-docker-compose logs --timestamps | wc -l
+docker compose logs --timestamps | wc -l
 ```
 
 ### 监控工具集成
@@ -424,28 +440,28 @@ services:
 
 ```bash
 # 启动
-docker-compose up -d --build       # 构建并启动
-docker-compose up -d               # 启动（不重新构建）
+docker compose up -d --build       # 构建并启动
+docker compose up -d               # 启动（不重新构建）
 
 # 停止
-docker-compose stop                # 停止服务
-docker-compose down                # 停止并删除容器
-docker-compose down -v             # 停止并删除容器和数据
+docker compose stop                # 停止服务
+docker compose down                # 停止并删除容器
+docker compose down -v             # 停止并删除容器和数据
 
 # 查看
-docker-compose ps                  # 查看状态
-docker-compose logs -f             # 查看日志
-docker-compose top                 # 查看进程
+docker compose ps                  # 查看状态
+docker compose logs -f             # 查看日志
+docker compose top                 # 查看进程
 
 # 重启
-docker-compose restart             # 重启所有服务
-docker-compose restart backend     # 重启后端
+docker compose restart             # 重启所有服务
+docker compose restart backend     # 重启后端
 
 # 更新
-git pull && docker-compose up -d --build
+git pull && docker compose up -d --build
 
 # 清理
-docker-compose down -v             # 清除所有数据
+docker compose down -v             # 清除所有数据
 docker system prune -a             # 清理 Docker 资源
 ```
 
diff --git a/README.md b/README.md
index 1e6c15f7..ba9305fa 100644
--- a/README.md
+++ b/README.md
@@ -260,8 +260,14 @@ nano config.json  # or use any editor
 chmod +x start.sh
 ./start.sh start --build
 
-# Option 2: Use docker-compose directly
-docker-compose up -d --build
+> #### Docker Compose Version Notes
+>
+> **This project uses Docker Compose V2 syntax (with spaces)**
+>
+> If you have the older standalone `docker-compose` installed, please upgrade to Docker Desktop or Docker 20.10+
+
+# Option 2: Use docker compose directly
+docker compose up -d --build
 ```
 
 #### Step 3: Access Dashboard
diff --git a/README.ru.md b/README.ru.md
index 874c478a..51d8054a 100644
--- a/README.ru.md
+++ b/README.ru.md
@@ -196,8 +196,10 @@ nano config.json  # или используйте любой редактор
 chmod +x start.sh
 ./start.sh start --build
 
-# Вариант 2: Используйте docker-compose напрямую
-docker-compose up -d --build
+# Вариант 2: Используйте docker compose напрямую
+# Этот проект использует синтаксис Docker Compose V2 (с пробелами)
+# Если у вас установлена старая версия `docker-compose`, обновитесь до Docker Desktop или Docker 20.10+
+docker compose up -d --build
 ```
 
 #### Шаг 3: Доступ к панели
diff --git a/README.uk.md b/README.uk.md
index 8c955c59..d47c5921 100644
--- a/README.uk.md
+++ b/README.uk.md
@@ -196,8 +196,10 @@ nano config.json  # або використайте будь-який редак
 chmod +x start.sh
 ./start.sh start --build
 
-# Варіант 2: Використайте docker-compose безпосередньо
-docker-compose up -d --build
+# Варіант 2: Використайте docker compose безпосередньо
+# Цей проект використовує синтаксис Docker Compose V2 (з пробілами)
+# Якщо у вас встановлена стара версія `docker-compose`, оновіть до Docker Desktop або Docker 20.10+
+docker compose up -d --build
 ```
 
 #### Крок 3: Доступ до панелі
diff --git a/README.zh-CN.md b/README.zh-CN.md
index 91447973..9b47fa04 100644
--- a/README.zh-CN.md
+++ b/README.zh-CN.md
@@ -260,8 +260,10 @@ nano config.json  # 或使用其他编辑器
 chmod +x start.sh
 ./start.sh start --build
 
-# 方式2：直接使用docker-compose
-docker-compose up -d --build
+
+# 方式2：直接使用docker compose
+# 如果您还在使用旧的独立 `docker-compose`，请升级到 Docker Desktop 或 Docker 20.10+
+docker compose up -d --build
 ```
 
 #### 步骤3：访问控制台