From ed4eddc0719ea76c294f80f40e2fb8749c582098 Mon Sep 17 00:00:00 2001
From: Tian jianyong <11429339@qq.com>
Date: Fri, 1 Aug 2025 19:44:48 +0800
Subject: [PATCH] =?UTF-8?q?=E4=BF=AE=E6=94=B9=E9=83=A8=E7=BD=B2=E6=96=87?=
 =?UTF-8?q?=E6=A1=A3?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 deploy/docker/prepare-offline-images.sh | 65 +++++++++++++++++++++++--
 deploy/docs/离线部署指南.md             | 22 ++++++++-
 deploy/docs/部署指南.md                 | 12 +++++
 3 files changed, 94 insertions(+), 5 deletions(-)

diff --git a/deploy/docker/prepare-offline-images.sh b/deploy/docker/prepare-offline-images.sh
index 43dcc8f5..76d6ca6e 100755
--- a/deploy/docker/prepare-offline-images.sh
+++ b/deploy/docker/prepare-offline-images.sh
@@ -334,14 +334,21 @@ cat > "$PROJECT_ROOT/offline-deploy/README-离线部署.md" << 'EOF'
 ## 包含内容
 
 - `images/` - Docker 镜像文件
-- `config/` - 配置文件
 - `scripts/` - 部署脚本
 - `docker/` - Docker配置和数据库初始化脚本
 - `docs/` - 部署文档
 - `sql/` - 数据库架构文件（如果存在）
+- `docker-compose.yml` - Docker Compose 主配置文件
+- `docker-compose.prod.yml` - 生产环境配置文件
+- `.env.template` - 环境变量模板文件
 
 ## 重要文件说明
 
+### 配置文件
+- `docker-compose.yml` - Docker Compose 主配置文件
+- `docker-compose.prod.yml` - 生产环境特定配置
+- `.env.template` - 环境变量配置模板
+
 ### 数据库初始化数据
 - `docker/postgres/export/01_system_data.sql` - 系统基础数据
 - `docker/postgres/export/02_business_data.sql` - 业务数据
@@ -351,9 +358,32 @@ cat > "$PROJECT_ROOT/offline-deploy/README-离线部署.md" << 'EOF'
 ## 部署步骤
 
 1. 将整个 `offline-deploy` 目录复制到目标服务器
-2. 导入镜像：`sh ./scripts/load-images.sh`
-3. 配置环境：`cp config/.env.template .env` 并编辑
-4. 启动服务：`sh ./scripts/deploy.sh install`
+2. 进入部署目录：`cd offline-deploy`
+3. 导入镜像：`sh ./scripts/load-images.sh`
+4. 配置环境：`cp .env.template .env` 并根据实际情况编辑 `.env` 文件
+5. 启动服务：`sh ./scripts/deploy.sh install`
+
+## 手动部署方式
+
+如果使用部署脚本遇到问题，可以手动执行：
+
+```bash
+# 1. 导入镜像
+sh ./scripts/load-images.sh
+
+# 2. 配置环境变量
+cp .env.template .env
+# 编辑 .env 文件，设置数据库密码、端口等配置
+
+# 3. 启动服务
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml --env-file .env up -d
+
+# 4. 查看服务状态
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml ps
+
+# 5. 查看日志
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml logs -f
+```
 
 ## 系统要求
 
@@ -368,6 +398,33 @@ cat > "$PROJECT_ROOT/offline-deploy/README-离线部署.md" << 'EOF'
 1. 系统数据（用户、角色、权限等）
 2. 业务数据（机场配置、区域设置等）
 3. 示例数据（测试用途，可选）
+
+## 常见问题
+
+### 端口冲突
+如果遇到端口被占用的问题，请修改 `.env` 文件中的端口配置：
+- `NGINX_PORT` - Nginx HTTP 端口（默认 80）
+- `NGINX_HTTPS_PORT` - Nginx HTTPS 端口（默认 443）
+- `APP_PORT` - 应用端口（默认 8080）
+
+### 权限问题
+如果遇到数据目录权限问题，请执行：
+```bash
+sudo chown -R $USER:$USER data/
+sudo chmod -R 755 data/
+```
+
+### 服务管理
+```bash
+# 停止服务
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml down
+
+# 重启服务
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml restart
+
+# 查看特定服务日志
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml logs -f qaup-app
+```
 EOF
 
 # 创建离线部署包
diff --git a/deploy/docs/离线部署指南.md b/deploy/docs/离线部署指南.md
index b30b14ad..93797024 100644
--- a/deploy/docs/离线部署指南.md
+++ b/deploy/docs/离线部署指南.md
@@ -55,9 +55,10 @@ ls -lh qaup-offline-deploy-*.tar.gz
 
 **离线部署包包含：**
 - Docker镜像文件（images/）
-- 配置文件（config/）
 - 部署脚本（scripts/）
+- Docker配置（docker/）
 - 文档（docs/）
+- 配置文件（docker-compose.yml, docker-compose.prod.yml, .env.template）
 - 镜像导入脚本
 - 校验和文件
 
@@ -107,6 +108,9 @@ sh ./scripts/deploy.sh init
 #### 4. 配置系统
 
 ```bash
+# 复制环境配置模板
+cp .env.template .env
+
 # 编辑环境配置
 nano .env
 ```
@@ -124,6 +128,22 @@ NGINX_PORT=80
 # 其他配置根据实际环境调整
 ```
 
+**手动部署方式**（如果部署脚本遇到问题）：
+```bash
+# 1. 导入镜像
+sh ./scripts/load-images.sh
+
+# 2. 配置环境变量
+cp .env.template .env
+# 编辑 .env 文件，设置数据库密码、端口等配置
+
+# 3. 启动服务
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml --env-file .env up -d
+
+# 4. 查看服务状态
+docker-compose -f docker-compose.yml -f docker-compose.prod.yml ps
+```
+
 #### 5. 启动系统
 
 ```bash
diff --git a/deploy/docs/部署指南.md b/deploy/docs/部署指南.md
index 8e3db09c..695f834d 100644
--- a/deploy/docs/部署指南.md
+++ b/deploy/docs/部署指南.md
@@ -83,6 +83,18 @@ QAUP-Management/
 └── 其他项目文件...
 ```
 
+**离线部署包结构（更新后）：**
+```
+qaup-offline-deploy/
+├── docker-compose.yml        # Docker Compose 配置（根目录）
+├── docker-compose.prod.yml   # 生产环境配置（根目录）
+├── .env.template             # 环境变量模板（根目录）
+├── deploy.sh                 # 部署脚本
+├── images/                   # Docker 镜像文件
+├── scripts/                  # 部署脚本
+└── README-离线部署.md        # 离线部署说明
+```
+
 **重要说明：**
 - 所有部署操作都在 `deploy` 目录下进行
 - Docker 构建上下文指向项目根目录，确保能正确访问所有源码文件