gongxiangp2/QUICK_DEPLOY.md

快速部署指南 v2.0

🚀 一键部署所有新功能

方式一：使用自动部署脚本（推荐）

cd /Users/lanmu/Desktop/gongxiangp2
./update-deploy.sh

脚本会自动完成：

• ✅ 打包项目文件
• ✅ 上传到NAS服务器
• ✅ 备份上传目录
• ✅ 停止旧容器
• ✅ 构建新容器
• ✅ 运行数据库迁移
• ✅ 初始化分类数据
• ✅ 验证部署状态

预计时间：5-10分钟

---

方式二：手动部署

步骤1：打包项目

cd /Users/lanmu/Desktop/gongxiangp2
tar -czf update.tar.gz \
  --exclude='node_modules' \
  --exclude='.next' \
  --exclude='uploads/*' \
  --exclude='.git' \
  .

步骤2：上传到NAS

scp update.tar.gz root@192.168.58.20:/mnt/tank/apps/youyidian-3d/

密码：jsjj8888

步骤3：SSH到NAS

ssh root@192.168.58.20
# 密码：jsjj8888

步骤4：解压并部署

cd /mnt/tank/apps/youyidian-3d

# 备份上传目录
cp -r uploads backups/uploads-$(date +%Y%m%d-%H%M%S)

# 解压更新
tar -xzf update.tar.gz
rm update.tar.gz

# 恢复上传目录
cp -r backups/uploads-* uploads/

# 重新构建
docker compose down
docker compose up -d --build

# 等待启动
sleep 15

# 数据库迁移
docker compose exec app npx prisma db push

# 初始化分类
docker compose exec -T app npx prisma db execute --schema=/app/prisma/schema.prisma --stdin <<< "
INSERT INTO categories (id, name, \"createdAt\") VALUES 
(gen_random_uuid(), '家居', NOW()),
(gen_random_uuid(), '办公', NOW()),
(gen_random_uuid(), '商业', NOW()),
(gen_random_uuid(), '户外', NOW()),
(gen_random_uuid(), '其他', NOW())
ON CONFLICT (name) DO NOTHING;
"

# 检查状态
docker compose ps
docker compose logs --tail=30 app

---

✅ 验证部署

1. 检查容器状态

ssh root@192.168.58.20
cd /mnt/tank/apps/youyidian-3d
docker compose ps

应该看到所有容器都是 Up 状态。

2. 检查日志

docker compose logs --tail=50 app

应该没有严重错误。

3. 访问系统

内网访问（推荐）：

• 地址：http://192.168.58.20:4320
• 优势：速度快，适合上传大文件

外网访问：

• 地址：http://180.97.221.140:2320
• 优势：随时随地访问

4. 测试新功能

4.1 测试黑暗模式

• 在系统设置中启用黑暗模式
• 刷新页面，应该自动切换

4.2 测试内外网识别

• 访问内网地址：应该显示"内网模式 🏠"（绿色）
• 访问外网地址：应该显示"公网模式 🌍"（蓝色）

4.3 测试一级分类

1. 点击"上传素材"
2. 应该看到"一级分类"下拉框
3. 点击"新建分类"，输入测试分类
4. 应该能成功添加并在下拉框中看到

4.4 测试7Z格式

1. 准备一个.7z文件
2. 上传时选择该文件
3. 应该能成功识别并上传

4.5 测试上传进度

1. 选择一个较大的文件（如50MB以上）
2. 开始上传
3. 应该看到：
   • 进度条动画
   • 百分比显示
   • 上传速度显示（MB/s）

4.6 测试大文件上传

1. 准备一个1GB以上的文件
2. 应该能成功上传（之前限制100MB）

---

🎯 新功能清单

• ✅ 浏览器黑暗模式支持
• ✅ 上传进度条和速度显示
• ✅ 支持7Z压缩格式
• ✅ 取消上传大小限制（3GB）
• ✅ 内外网模式识别和提示
• ✅ 一级分类功能

---

🐛 常见问题

Q1: 部署后无法访问

A:

1. 检查容器状态：docker compose ps
2. 查看日志：docker compose logs app
3. 重启容器：docker compose restart

Q2: 数据库迁移失败

A:

docker compose exec app npx prisma db push --accept-data-loss

Q3: 看不到一级分类

A:

# 手动初始化分类数据
docker compose exec -T app npx prisma db execute --schema=/app/prisma/schema.prisma --stdin <<< "
INSERT INTO categories (id, name, \"createdAt\") VALUES 
(gen_random_uuid(), '家居', NOW()),
(gen_random_uuid(), '办公', NOW())
ON CONFLICT (name) DO NOTHING;
"

Q4: 黑暗模式不生效

A:

• 清除浏览器缓存
• 硬刷新页面（Ctrl+Shift+R 或 Cmd+Shift+R）
• 检查系统是否启用了黑暗模式

Q5: 内外网识别错误

A:

• 确保访问地址正确
• 内网：http://192.168.58.20:4320
• 外网：http://180.97.221.140:2320

---

📞 需要帮助？

如果遇到问题：

1. 查看详细文档：FEATURE_UPDATES.md
2. 检查日志：

   ssh root@192.168.58.20
   cd /mnt/tank/apps/youyidian-3d
   docker compose logs --tail=100 app
   

3. 重新部署：

   ./update-deploy.sh
   

---

部署愉快！ 🎉