|
|
@@ -39,16 +39,37 @@
|
|
|
|
|
|
#### 1. 启动服务
|
|
|
|
|
|
-在项目根目录下运行:
|
|
|
+根据您的运行环境选择对应的启动命令:
|
|
|
+
|
|
|
+**场景 A: Linux 服务器部署 (生产环境/标准 Linux)**
|
|
|
+适用于标准 Linux 服务器环境,使用本地目录挂载数据库,方便数据备份和查看。
|
|
|
|
|
|
```bash
|
|
|
# 启动服务
|
|
|
docker-compose up -d
|
|
|
```
|
|
|
+
|
|
|
+**场景 B: Windows (WSL 2) 本地开发**
|
|
|
+适用于在 Windows 上使用 Docker Desktop (WSL 2) 的用户。此配置使用 Docker 命名卷 (Named Volume) 存储数据库,以解决 Windows 文件系统 (NTFS) 挂载导致的 MySQL 权限问题。
|
|
|
+
|
|
|
```bash
|
|
|
-# 构建并启动服务
|
|
|
-sudo docker-compose up -d --build
|
|
|
+# 使用 WSL 专用配置文件启动
|
|
|
+docker-compose -f docker-compose.wsl.yml up -d
|
|
|
```
|
|
|
+
|
|
|
+> **提示**:
|
|
|
+> * 如果在 Windows 下直接运行 `docker-compose up -d` 遇到数据库启动失败 (Permission denied),请务必使用上述 **场景 B** 的命令。
|
|
|
+> * 如果遇到 "DEPRECATED" 警告,建议使用新版命令 `docker compose` (无连字符)。
|
|
|
+
|
|
|
+```bash
|
|
|
+# 构建并启动服务 (强制重新构建镜像)
|
|
|
+# Linux:
|
|
|
+docker-compose up -d --build
|
|
|
+# Windows/WSL:
|
|
|
+docker-compose -f docker-compose.wsl.yml up -d --build
|
|
|
+```
|
|
|
+
|
|
|
+#### 2. Windows 用户构建卡住解决方案
|
|
|
> **❗ Windows 用户特别提示 (构建卡住解决方案)**:
|
|
|
> 如果直接运行 `docker-compose build` 时遇到 `npm install` 阶段卡住不动(常见于 Windows Docker Desktop 网络环境),请按以下步骤手动构建:
|
|
|
>
|