6.4 KiB

Raw Blame History

简化版 Docker 部署指南

这是一个简化的 Docker 部署方案，直接使用已经打包好的 jar 包和 dist 文件，无需在容器内重新构建。

📁 目录结构

deploy/
├── docker-compose.yml          # Docker Compose 配置文件
├── backend/                    # 后端部署目录
│   ├── Dockerfile             # 后端 Dockerfile
│   └── ruoyi-admin.jar        # 【需要放置】后端 jar 包
├── frontend/                   # 前端部署目录
│   ├── Dockerfile             # 前端 Dockerfile
│   ├── nginx.conf             # Nginx 配置文件
│   └── dist/                  # 【需要放置】前端打包文件
└── sql/                        # 【可选】数据库初始化脚本
    └── ry_20xx.sql

🚀 快速部署步骤

1. 准备文件

将以下文件上传到服务器的 deploy 目录：

# 1. 将后端 jar 包放到 backend 目录
deploy/backend/ruoyi-admin.jar

# 2. 将前端 dist 文件夹放到 frontend 目录
deploy/frontend/dist/

# 3. （可选）将数据库初始化脚本放到 sql 目录
deploy/sql/ry_20xx.sql

2. 修改配置

编辑 docker-compose.yml，根据需要修改以下配置：

# MySQL 配置
environment:
  MYSQL_ROOT_PASSWORD: password      # 修改为你的密码
  MYSQL_DATABASE: ry-vue            # 数据库名称

# 端口配置（如果端口冲突，可以修改）
ports:
  - "3306:3306"  # MySQL
  - "6379:6379"  # Redis
  - "8080:8080"  # 后端
  - "8081:80"    # 前端

3. 启动服务

# 进入 deploy 目录
cd deploy

# 启动所有服务
docker-compose up -d

# 查看服务状态
docker-compose ps

# 查看日志
docker-compose logs -f

4. 访问应用

前端地址: http://your-server-ip:8081/ashai-wecom-test
后端 API: http://your-server-ip:8080
默认账号: admin / admin123

📝 常用命令

# 启动所有服务
docker-compose up -d

# 停止所有服务
docker-compose down

# 重启某个服务
docker-compose restart backend
docker-compose restart frontend

# 查看服务日志
docker-compose logs -f backend
docker-compose logs -f frontend

# 查看服务状态
docker-compose ps

# 进入容器
docker exec -it wecom-backend sh
docker exec -it wecom-frontend sh

# 重新构建并启动
docker-compose up -d --build

# 停止并删除所有容器、网络、数据卷
docker-compose down -v

🔄 更新部署

更新后端

# 1. 停止后端服务
docker-compose stop backend

# 2. 替换 jar 包
cp new-ruoyi-admin.jar backend/ruoyi-admin.jar

# 3. 重新构建并启动
docker-compose up -d --build backend

更新前端

# 1. 停止前端服务
docker-compose stop frontend

# 2. 替换 dist 文件
rm -rf frontend/dist
cp -r new-dist frontend/dist

# 3. 重新构建并启动
docker-compose up -d --build frontend

🔧 配置说明

后端配置

后端使用 --spring.profiles.active=prod 启动，确保你的 jar 包中包含正确的生产环境配置：

数据库连接：jdbc:mysql://mysql:3306/ry-vue
Redis 连接：redis://redis:6379

如果需要修改配置，可以通过环境变量或重新打包 jar。

前端配置

前端通过 Nginx 提供服务，配置文件在 frontend/nginx.conf：

访问路径：/ashai-wecom-test
API 代理：/ashai-wecom-test/prod-api/ → http://backend:8080/

数据库初始化

首次启动时，如果 sql 目录中有 .sql 文件，MySQL 会自动执行这些脚本。

如果需要手动导入：

# 复制 SQL 文件到容器
docker cp ry_20xx.sql wecom-mysql:/tmp/

# 进入 MySQL 容器
docker exec -it wecom-mysql bash

# 导入数据库
mysql -uroot -ppassword ry-vue < /tmp/ry_20xx.sql

🌐 集成到现有 Nginx（80 端口）

如果服务器 80 端口已有 Nginx，可以添加反向代理配置：

# 在你的 Nginx 配置中添加
location /ashai-wecom-test {
    proxy_pass http://localhost:8081/ashai-wecom-test;
    proxy_set_header Host $host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
}

然后重启 Nginx：

nginx -t
nginx -s reload

🐛 故障排查

1. 后端无法连接数据库

# 检查 MySQL 是否启动
docker-compose ps mysql

# 查看 MySQL 日志
docker-compose logs mysql

# 检查网络连接
docker exec -it wecom-backend ping mysql

2. 前端无法访问后端 API

# 检查后端是否启动
docker-compose ps backend

# 查看后端日志
docker-compose logs backend

# 测试后端接口
curl http://localhost:8080/

3. 前端页面 404

# 检查 dist 文件是否正确放置
docker exec -it wecom-frontend ls -la /usr/share/nginx/html/ashai-wecom-test

# 查看 Nginx 日志
docker-compose logs frontend

# 检查 Nginx 配置
docker exec -it wecom-frontend cat /etc/nginx/conf.d/default.conf

4. 端口被占用

# 查看端口占用
netstat -tulpn | grep 8080
netstat -tulpn | grep 8081

# 修改 docker-compose.yml 中的端口映射
ports:
  - "8082:8080"  # 改为其他端口

5. 容器启动失败

# 查看详细日志
docker-compose logs -f

# 检查容器状态
docker-compose ps

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

📊 数据持久化

所有数据都通过 Docker 卷持久化：

mysql_data: MySQL 数据
redis_data: Redis 数据
upload_data: 文件上传目录

即使删除容器，数据也不会丢失。如需完全清理：

docker-compose down -v

🔒 安全建议

修改默认密码：修改 MySQL root 密码和应用管理员密码
限制端口访问：使用防火墙限制数据库端口的外部访问
使用 HTTPS：在生产环境配置 SSL 证书
定期备份：定期备份数据库和上传文件

📈 性能优化

调整 JVM 参数：在 backend/Dockerfile 中添加 JVM 参数
配置 Nginx 缓存：已在 frontend/nginx.conf 中配置
数据库优化：根据实际情况调整 MySQL 配置

💡 提示

首次启动可能需要等待 1-2 分钟，等待数据库初始化
确保服务器有足够的内存（建议至少 2GB）
生产环境建议使用外部数据库，而不是容器内的数据库

6.4 KiB Raw Blame History Unescape Escape