335 lines
6.2 KiB
Markdown
335 lines
6.2 KiB
Markdown
# Docker 部署指南
|
||
|
||
## 项目架构
|
||
|
||
本项目采用前后端分离架构，使用 Docker Compose 进行编排部署。
|
||
|
||
### 服务说明
|
||
|
||
- **crm-frontend**: 前端服务（Nginx），端口 80
|
||
- **crm-backend**: 后端服务（Spring Boot），端口 8080
|
||
- **crm-mysql**: MySQL 8 数据库，端口 3306
|
||
|
||
### 网络架构
|
||
|
||
```
|
||
Internet
|
||
│
|
||
▼
|
||
Nginx (crm-frontend:80)
|
||
│
|
||
├─► 静态文件 (Vue SPA)
|
||
│
|
||
└─► /api/* 代理到 Spring Boot (crm-backend:8080)
|
||
│
|
||
└─► MySQL (crm-mysql:3306)
|
||
```
|
||
|
||
## 快速开始
|
||
|
||
### 1. 准备工作
|
||
|
||
确保已安装以下软件：
|
||
- Docker (20.10+)
|
||
- Docker Compose (2.0+)
|
||
|
||
检查安装：
|
||
```bash
|
||
docker --version
|
||
docker-compose --version
|
||
```
|
||
|
||
### 2. 配置环境变量
|
||
|
||
编辑 `docker-compose.yml`，根据需要修改以下配置：
|
||
|
||
**数据库配置：**
|
||
```yaml
|
||
environment:
|
||
MYSQL_ROOT_PASSWORD: MySQL123s56 # 修改为强密码
|
||
MYSQL_DATABASE: crm_db
|
||
```
|
||
|
||
**后端配置：**
|
||
```yaml
|
||
environment:
|
||
JWT_SECRET: your-secret-key-change-in-production # 修改为随机密钥
|
||
JWT_EXPIRATION: 86400000
|
||
SPRING_DATASOURCE_PASSWORD: MySQL123s56 # 与数据库密码一致
|
||
```
|
||
|
||
### 3. 构建并启动
|
||
|
||
```bash
|
||
# 进入项目根目录
|
||
cd by-crm
|
||
|
||
# 构建并启动所有服务（后台运行）
|
||
docker-compose up -d
|
||
|
||
# 查看日志
|
||
docker-compose logs -f
|
||
|
||
# 查看服务状态
|
||
docker-compose ps
|
||
```
|
||
|
||
### 4. 访问应用
|
||
|
||
- **前端应用**: http://localhost
|
||
- **后端 API**: http://localhost:8080/api
|
||
- **默认账号**:
|
||
- 管理员: `admin` / `admin123`
|
||
- 经销商: `user001` / `admin123`
|
||
|
||
## 常用命令
|
||
|
||
### 服务管理
|
||
|
||
```bash
|
||
# 启动所有服务
|
||
docker-compose up -d
|
||
|
||
# 停止所有服务
|
||
docker-compose stop
|
||
|
||
# 重启所有服务
|
||
docker-compose restart
|
||
|
||
# 停止并删除容器
|
||
docker-compose down
|
||
|
||
# 停止并删除容器、网络、数据卷
|
||
docker-compose down -v
|
||
```
|
||
|
||
### 查看日志
|
||
|
||
```bash
|
||
# 查看所有服务日志
|
||
docker-compose logs -f
|
||
|
||
# 查看特定服务日志
|
||
docker-compose logs -f crm-backend
|
||
docker-compose logs -f crm-frontend
|
||
docker-compose logs -f crm-mysql
|
||
|
||
# 查看最近 100 行日志
|
||
docker-compose logs --tail=100 crm-backend
|
||
```
|
||
|
||
### 重新构建
|
||
|
||
```bash
|
||
# 重新构建并启动
|
||
docker-compose up -d --build
|
||
|
||
# 重新构建特定服务
|
||
docker-compose build crm-backend
|
||
docker-compose build crm-frontend
|
||
```
|
||
|
||
### 进入容器
|
||
|
||
```bash
|
||
# 进入后端容器
|
||
docker-compose exec crm-backend sh
|
||
|
||
# 进入数据库容器
|
||
docker-compose exec crm-mysql mysql -uroot -p
|
||
|
||
# 进入前端容器
|
||
docker-compose exec crm-frontend sh
|
||
```
|
||
|
||
## 数据持久化
|
||
|
||
### 数据卷挂载
|
||
|
||
```yaml
|
||
# MySQL 数据
|
||
./mysql/data:/var/lib/mysql
|
||
|
||
# 后端日志
|
||
./backend/logs:/app/logs
|
||
```
|
||
|
||
### 备份数据库
|
||
|
||
```bash
|
||
# 导出数据库
|
||
docker-compose exec crm-mysql mysqldump -uroot -pMySQL123s56 crm_db > backup.sql
|
||
|
||
# 导入数据库
|
||
docker-compose exec -T crm-mysql mysql -uroot -pMySQL123s56 crm_db < backup.sql
|
||
```
|
||
|
||
## 生产环境部署
|
||
|
||
### 1. 修改端口映射
|
||
|
||
根据实际情况修改端口映射：
|
||
|
||
```yaml
|
||
services:
|
||
crm-frontend:
|
||
ports:
|
||
- "80:80" # 或者使用 443:443 (HTTPS)
|
||
|
||
crm-backend:
|
||
ports:
|
||
- "8080:8080" # 生产环境建议不对外暴露，仅通过 Nginx 访问
|
||
|
||
crm-mysql:
|
||
ports:
|
||
- "3306:3306" # 生产环境建议注释掉，不对外暴露
|
||
```
|
||
|
||
### 2. 配置 HTTPS（推荐）
|
||
|
||
修改 `frontend/nginx.conf`：
|
||
|
||
```nginx
|
||
server {
|
||
listen 443 ssl http2;
|
||
server_name your-domain.com;
|
||
|
||
ssl_certificate /etc/nginx/ssl/cert.pem;
|
||
ssl_certificate_key /etc/nginx/ssl/key.pem;
|
||
|
||
# 其他配置...
|
||
}
|
||
|
||
# HTTP 重定向到 HTTPS
|
||
server {
|
||
listen 80;
|
||
server_name your-domain.com;
|
||
return 301 https://$server_name$request_uri;
|
||
}
|
||
```
|
||
|
||
挂载 SSL 证书：
|
||
|
||
```yaml
|
||
crm-frontend:
|
||
volumes:
|
||
- ./ssl:/etc/nginx/ssl:ro
|
||
ports:
|
||
- "443:443"
|
||
- "80:80"
|
||
```
|
||
|
||
### 3. 优化配置
|
||
|
||
**后端 JVM 参数**（backend/Dockerfile）：
|
||
|
||
```dockerfile
|
||
ENTRYPOINT ["java", \
|
||
"-Xms512m", \
|
||
"-Xmx1024m", \
|
||
"-XX:+UseG1GC", \
|
||
"-jar", "app.jar"]
|
||
```
|
||
|
||
**MySQL 优化**（docker-compose.yml）：
|
||
|
||
```yaml
|
||
crm-mysql:
|
||
command: [
|
||
'--default-authentication-plugin=mysql_native_password',
|
||
'--character-set-server=utf8mb4',
|
||
'--collation-server=utf8mb4_unicode_ci',
|
||
'--max_connections=500',
|
||
'--innodb_buffer_pool_size=1G'
|
||
]
|
||
```
|
||
|
||
### 4. 安全加固
|
||
|
||
- 修改所有默认密码
|
||
- 使用强密码策略
|
||
- 配置防火墙规则
|
||
- 启用 HTTPS
|
||
- 定期备份数据
|
||
- 限制数据库访问（不对外暴露 3306 端口）
|
||
|
||
## 故障排查
|
||
|
||
### 容器启动失败
|
||
|
||
```bash
|
||
# 查看详细日志
|
||
docker-compose logs crm-backend
|
||
|
||
# 检查容器状态
|
||
docker-compose ps
|
||
|
||
# 检查网络
|
||
docker network ls
|
||
docker network inspect by-crm_crm_network
|
||
```
|
||
|
||
### 数据库连接失败
|
||
|
||
```bash
|
||
# 等待数据库健康检查通过
|
||
docker-compose logs crm-mysql
|
||
|
||
# 检查数据库是否就绪
|
||
docker-compose exec crm-mysql mysql -uroot -pMySQL123s56 -e "SHOW DATABASES;"
|
||
```
|
||
|
||
### 前端访问后端跨域
|
||
|
||
检查 `frontend/nginx.conf` 中的代理配置：
|
||
|
||
```nginx
|
||
location /api/ {
|
||
proxy_pass http://crm-backend:8080/api/;
|
||
# 确保包含这些头
|
||
proxy_set_header Host $host;
|
||
proxy_set_header X-Real-IP $remote_addr;
|
||
}
|
||
```
|
||
|
||
### 性能监控
|
||
|
||
```bash
|
||
# 查看容器资源使用
|
||
docker stats
|
||
|
||
# 查看特定服务资源使用
|
||
docker stats crm-backend crm-frontend crm-mysql
|
||
```
|
||
|
||
## 升级部署
|
||
|
||
```bash
|
||
# 1. 备份数据
|
||
docker-compose exec crm-mysql mysqldump -uroot -pMySQL123s56 crm_db > backup_$(date +%Y%m%d).sql
|
||
|
||
# 2. 拉取最新代码
|
||
git pull
|
||
|
||
# 3. 重新构建并启动
|
||
docker-compose up -d --build
|
||
|
||
# 4. 清理旧镜像
|
||
docker image prune -f
|
||
```
|
||
|
||
## 注意事项
|
||
|
||
1. **首次启动**：数据库初始化可能需要 1-2 分钟，请耐心等待
|
||
2. **健康检查**：后端服务依赖数据库健康检查通过后才会启动
|
||
3. **数据安全**：生产环境务必修改默认密码
|
||
4. **资源限制**：可根据服务器配置添加资源限制（cpus、memory）
|
||
5. **日志管理**：建议配置日志轮转，避免磁盘占满
|
||
|
||
## 参考资源
|
||
|
||
- [Docker 官方文档](https://docs.docker.com/)
|
||
- [Docker Compose 文档](https://docs.docker.com/compose/)
|
||
- [Nginx 配置指南](https://nginx.org/en/docs/)
|
||
- [Spring Boot Docker 部署](https://docs.spring.io/spring-boot/docs/current/reference/html/docker.html)
|