material_manage_system/DEPLOY.md

Docker 部署指南

项目简介

仓库物料管理系统 (WMMS) - 前后端分离架构

• 后端: Go + Gin + MySQL (端口 8082)
• 前端: Vue 3 + Vite + Nginx (端口 80)
• 数据库: MySQL 8.0 (端口 3306)

快速启动 (Windows)

前置条件

1. 安装 Docker Desktop (Windows 10/11)
2. 启动 Docker Desktop

启动服务

# 进入项目目录
cd c:\1111\12.project\VSCode\warehouse-mms

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

# 查看服务状态
docker-compose ps

访问应用

• 前端地址: http://localhost
• 后端API: http://localhost:8082/api
• 健康检查: http://localhost:8082/api/health

默认用户

用户名	密码	角色
admin	admin123	管理员
user	user123	普通用户

常用命令

# 查看日志
docker-compose logs -f

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

# 停止服务
docker-compose down

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

# 删除所有数据（谨慎操作）
docker-compose down -v

数据持久化

• MySQL数据: mysql_data Docker volume
• 上传文件: uploads_data Docker volume

环境变量

变量	默认值	说明
DB_DSN	root:wmms1234@tcp(db:3306)/wmms?charset=utf8mb4&parseTime=true	数据库连接字符串
GIN_MODE	release	Gin 运行模式

手动构建

# 构建后端
docker build -t wmms-backend .

# 构建前端
cd frontend
docker build -t wmms-frontend .

# 启动
docker-compose up -d

故障排查

端口冲突

如果 80 或 3306 端口被占用:

# 查看端口占用
netstat -ano | findstr ":80"
netstat -ano | findstr ":3306"

# 修改 docker-compose.yml 中的端口映射

数据库连接失败

# 检查数据库是否就绪
docker-compose logs db

# 等待数据库启动完成（约10秒）

查看容器内部

# 进入后端容器
docker exec -it wmms-backend sh

# 进入数据库容器
docker exec -it wmms-db mysql -u root -p