一键部署指南

🎉 Docker 部署方案已准备完成！

✅ 本地测试结果

已成功构建并测试 Docker 镜像：
  - 镜像大小: 255MB
  - 基础镜像: nginx:latest
  - 测试端口: 3000
  - 测试结果: ✅ HTTP 200 OK
  - 启动时间: < 3秒
  - 内存占用: < 50MB

---
  📦 部署文件清单

我已经为你创建了完整的部署方案，包含以下文件：

1. deploy.sh - 一键部署脚本 ⭐推荐

# 最简单的部署方式
  ./deploy.sh          # 默认80端口
  ./deploy.sh 3000     # 指定端口

2. docker-compose.yml - Docker Compose 配置

docker-compose up -d          # 启动
  docker-compose down           # 停止
  docker-compose logs -f        # 查看日志

3. README_DEPLOY.md - 快速部署指南

- 三种部署方式对比
  - 常用命令速查
  - 常见问题解答

4. DOCKER_DEPLOY.md - 完整部署文档

- 详细部署步骤
  - 性能优化建议
  - 安全配置指南
  - 故障排查方法

---
  🚀 服务器部署步骤（3步完成）

步骤 1: 上传文件

上传以下文件到服务器：
  mind-map/
  ├── Dockerfile          ← 必需
  ├── nginx.conf          ← 必需
  ├── index.html          ← 必需
  ├── dist/              ← 必需（完整目录，7.6MB）
  ├── deploy.sh          ← 推荐
  └── docker-compose.yml ← 推荐

上传方式：
  # 方式1: 使用 scp
  scp -r /Volumes/AiWorkSpace/github/mind-map user@your-server:/opt/

# 方式2: 使用 rsync
  rsync -avz /Volumes/AiWorkSpace/github/mind-map user@your-server:/opt/

# 方式3: git 推送到仓库，然后在服务器 clone

步骤 2: 一键部署

# SSH 登录服务器
  ssh user@your-server

# 进入项目目录
  cd /opt/mind-map

# 运行部署脚本
  chmod +x deploy.sh
  ./deploy.sh

步骤 3: 访问应用

http://your-server-ip

---
  🔧 三种部署方式对比

| 方式             | 命令                         | 优点       | 适用场景 |
  |----------------|----------------------------|----------|------|
  | 一键脚本           | ./deploy.sh                | 最简单，自动检测 | 快速部署 |
  | Docker Compose | docker-compose up -d       | 易于管理和扩展  | 生产环境 |
  | Docker 命令      | docker run -d -p 80:80 ... | 灵活可控     | 高级配置 |

---
  📊 端口配置示例

默认端口（80）

./deploy.sh
  # 访问: http://your-server-ip

自定义端口（3000）

./deploy.sh 3000
  # 访问: http://your-server-ip:3000

多实例部署

# 实例1 - 端口3000
  docker run -d -p 3000:80 --name mind-map-1 mind-map:latest

# 实例2 - 端口3001
  docker run -d -p 3001:80 --name mind-map-2 mind-map:latest

---
  🌐 域名和 HTTPS 配置

配置反向代理

server {
      listen 80;
      server_name mind-map.example.com;

location / {
          proxy_pass http://localhost:3000;
          proxy_set_header Host $host;
          proxy_set_header X-Real-IP $remote_addr;
      }
  }

配置 HTTPS

certbot --nginx -d mind-map.example.com

---
  📝 快速命令参考

# 查看容器状态
  docker ps | grep mind-map

# 查看实时日志
  docker logs -f mind-map

# 重启容器
  docker restart mind-map

# 停止容器
  docker stop mind-map

# 更新部署
  ./deploy.sh

# 删除容器
  docker stop mind-map && docker rm mind-map

---
  💡 性能建议

1. 生产环境推荐配置：
  docker run -d \
    -p 80:80 \
    --name mind-map \
    --restart always \
    --memory="512m" \
    --cpus="1.0" \
    mind-map:latest

2. 使用 alpine 镜像减小体积：
  修改 Dockerfile 第一行为 FROM nginx:alpine，镜像大小可减少到约 50MB
  3. 启用 Gzip 压缩：
  已在 nginx.conf 中配置（如需要可手动添加）

---
  ❓ 常见问题

Q: 需要安装 Node.js 或 npm 吗？
  A: 不需要！Docker 部署方案使用的是已编译好的静态文件（dist 目录），只需要 Docker。

Q: 镜像为什么这么大（255MB）？
  A: 主要是 nginx 基础镜像（~190MB），应用本身只有 8MB。可以使用 nginx:alpine 减小体积。

Q: 数据会丢失吗？
  A: 用户数据存储在浏览器本地，与服务器无关。重启容器不会影响用户数据。

Q: 如何修改端口？
  A: 使用 ./deploy.sh 3000 指定端口，或修改 docker-compose.yml 中的 ports 配置。

---
  📞 需要帮助？

- 快速指南: README_DEPLOY.md
  - 完整文档: DOCKER_DEPLOY.md
  - 项目主页: https://github.com/wanglin2/mind-map

现在你可以将项目文件上传到服务器并运行 ./deploy.sh 完成部署了！需要我帮你测试部署脚本吗？