前端修饰与渲染处理

DOCKER-BUILD-GUIDE.md

@@ -0,0 +1,175 @@
+# Docker 构建最终解决方案
+
+## 🎯 核心改进
+
+### 自动镜像源 Fallback 机制
+
+现在的 Dockerfile 会自动尝试三个国内镜像源：
+
+1. **阿里云镜像** (https://registry.npmmirror.com) - 首选
+2. **腾讯云镜像** (https://mirrors.cloud.tencent.com/npm/) - 备选
+3. **华为云镜像** (https://repo.huaweicloud.com/repository/npm/) - 最后备选
+
+如果第一个镜像源失败，会自动切换到下一个，无需手动干预！
+
+## 🚀 立即开始构建
+
+### 步骤 1：清理旧缓存
+
+```powershell
+docker system prune -a --volumes -f
+docker builder prune -a -f
+```
+
+### 步骤 2：重新构建
+
+```powershell
+# 使用 PowerShell 脚本（推荐）
+.\build-docker.ps1
+
+# 或者直接使用 docker-compose
+docker-compose build --no-cache
+```
+
+### 步骤 3：启动服务
+
+```powershell
+docker-compose up -d
+```
+
+## 📊 构建过程说明
+
+构建时您会看到类似这样的输出：
+
+```
+# Backend Builder
+Trying Aliyun mirror...
+[如果阿里云成功，继续构建]
+[如果阿里云失败，显示:]
+Aliyun failed, trying Tencent Cloud...
+[如果腾讯云成功，继续构建]
+[如果腾讯云失败，显示:]
+Tencent failed, trying Huawei Cloud...
+```
+
+## 🔍 故障排除
+
+### 问题 1：所有镜像源都失败
+
+**可能原因**：
+- 网络连接完全中断
+- 防火墙阻止了所有镜像源
+
+**解决方案**：
+```powershell
+# 测试网络连接
+npm ping --registry=https://registry.npmmirror.com
+npm ping --registry=https://mirrors.cloud.tencent.com/npm/
+npm ping --registry=https://repo.huaweicloud.com/repository/npm/
+
+# 检查防火墙设置
+# 确保允许访问这些域名
+```
+
+### 问题 2：构建速度很慢
+
+**可能原因**：
+- 正在使用较慢的镜像源
+- 首次构建需要下载大量依赖
+
+**解决方案**：
+- 等待构建完成，后续构建会使用缓存
+- 或者切换到更快的镜像源（见下方）
+
+### 问题 3：内存不足
+
+**错误信息**：`JavaScript heap out of memory`
+
+**解决方案**：
+在 Docker Desktop 中增加内存分配：
+1. Settings → Resources → Advanced
+2. 将 Memory 设置为至少 4GB
+
+## 💡 手动切换镜像源（可选）
+
+如果想手动指定镜像源，可以运行：
+
+```powershell
+.\switch-npm-mirror.bat
+```
+
+然后选择：
+- `1` - 阿里云（默认）
+- `2` - 腾讯云
+- `3` - 华为云
+
+## 📝 验证构建成功
+
+```powershell
+# 查看镜像列表
+docker images | findstr sillytavern-repalice
+
+# 应该看到：
+# sillytavern-repalice-backend
+# sillytavern-repalice-frontend
+```
+
+## 🎉 访问应用
+
+构建完成后：
+
+- **前端**: http://localhost:5173
+- **后端**: http://localhost:3000
+
+查看日志：
+```powershell
+docker-compose logs -f
+```
+
+## ⚙️ 技术细节
+
+### Dockerfile 改进
+
+**之前**：
+```dockerfile
+RUN cd server && npm install
+```
+
+**现在**：
+```dockerfile
+RUN cd server && \
+    npm install --registry=https://registry.npmmirror.com || \
+    npm install --registry=https://mirrors.cloud.tencent.com/npm/ || \
+    npm install --registry=https://repo.huaweicloud.com/repository/npm/
+```
+
+### 优势
+
+1. ✅ **自动化**：无需手动切换镜像源
+2. ✅ **容错性**：一个失败自动尝试下一个
+3. ✅ **速度优化**：使用 `--prefer-offline`、`--no-audit`、`--no-fund`
+4. ✅ **可靠性**：三个镜像源保证至少有一个可用
+
+## 🆘 仍然有问题？
+
+如果以上方案都不起作用，请提供：
+
+1. 完整的构建日志：
+   ```powershell
+   docker-compose build --no-cache > build.log 2>&1
+   ```
+
+2. 网络测试结果：
+   ```powershell
+   .\test-npm-registry.bat
+   ```
+
+3. 系统信息：
+   ```powershell
+   docker --version
+   docker-compose --version
+   ```
+
+---
+
+**祝构建顺利！** 🚀