From 2570583b4868873e8a0b989bc3de836b0acd8982 Mon Sep 17 00:00:00 2001
From: zhang1106 <849185023@qq.com>
Date: Tue, 16 Jun 2026 10:12:13 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E4=BC=98=E5=8C=96=20Docker=20=E9=83=A8?=
 =?UTF-8?q?=E7=BD=B2=E6=95=99=E7=A8=8B=E7=9A=84=E7=9B=AE=E5=BD=95=E5=88=9B?=
 =?UTF-8?q?=E5=BB=BA=E6=B5=81=E7=A8=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 移除提前创建 /opt/idc_assest 目录的步骤

- 直接 git clone 到部署目录，整个项目作为部署目录使用

- 明确说明持久化目录已通过 .gitkeep 在仓库中预留
---
 docs/docker-deployment-guide.md | 25 ++++++++++++-------------
 1 file changed, 12 insertions(+), 13 deletions(-)

diff --git a/docs/docker-deployment-guide.md b/docs/docker-deployment-guide.md
index 92d1532..45fcec0 100644
--- a/docs/docker-deployment-guide.md
+++ b/docs/docker-deployment-guide.md
@@ -59,35 +59,34 @@ docker --version
 docker compose version
 ```
 
-### 2.2 创建目录结构
+### 2.2 验证 Docker 安装
 
 ```bash
-# 在服务器上创建项目根目录
-mkdir -p /opt/idc_assest
-cd /opt/idc_assest
+docker --version
+docker compose version
 ```
 
+部署目录会在第三节"克隆项目代码"步骤中直接创建到 `/opt/idc_assest`，无需提前创建。
+
 ---
 
 ## 三、拉取项目与配置
 
 ### 3.1 克隆项目代码
 
-> 注意：克隆代码是为了获取 `docker-compose.prod.yml` 和 `.env` 配置模板，**不是用来构建镜像的**（镜像已由CI/CD自动构建好）。
+> 注意：克隆代码是为了获取 `docker-compose.prod.yml` 和 `.env` 配置模板，**不是用来构建镜像的**（镜像已由 CI/CD 自动构建好，部署服务器无需 Node.js 源码）。
 
 ```bash
-git clone https://github.com/gituib/idc_assest.git .
+# 直接克隆到部署目录
+git clone https://github.com/gituib/idc_assest.git /opt/idc_assest
+cd /opt/idc_assest
 ```
 
+克隆完成后，整个项目目录就是部署目录。多余的源代码（`backend/`、`frontend/` 源码）不影响运行，运行时只会用到 `docker-compose.prod.yml`、`.env` 和持久化目录。
+
 ### 3.2 持久化目录
 
-通过 `git clone` 完整克隆项目时，`backend/uploads/` 和 `backend/temp/` 目录已包含占位文件（`.gitkeep`）。`backend/logs/` 和 `backend/backups/` 也已在仓库中预留。
-
-如果是 sparse-checkout 或下载 release 包的方式，需要手动创建：
-
-```bash
-mkdir -p backend/uploads backend/logs backend/backups backend/temp
-```
+通过 `git clone` 完整克隆项目后，`backend/uploads/`、`backend/temp/`、`backend/logs/`、`backend/backups/` 四个持久化目录已经在仓库中预留（包含 `.gitkeep` 占位文件），**无需手动创建**。
 
 ### 3.3 配置 .env 文件