Maxun项目Docker启动问题解决方案

问题背景

在使用Docker部署Maxun项目时，许多开发者遇到了前端与后端通信失败的问题。具体表现为两种不同情况：

1. 在master分支上运行时，系统持续报错提示8080端口已被占用
2. 在dev分支上运行时，虽然能显示Swagger文档界面，但当尝试注册操作时，后端连接会断开并导致服务崩溃

问题分析与解决方案

经过项目维护团队的调查，这些问题主要源于Docker配置的不完善。团队在issue #93中专门解决了这些启动问题，并提供了新的docker-compose文件。

最新部署指南

环境准备

1. 确保使用master分支代码
2. 检查Docker和Docker Compose版本是否为最新
3. 清理旧容器和关联卷（避免缓存问题）

关键配置

项目需要正确的环境变量配置才能正常运行。以下是一个完整的.env文件示例配置：

# 基础配置
NODE_ENV=production
JWT_SECRET=your_jwt_secret_key

# 数据库配置
DB_NAME=maxun
DB_USER=admin
DB_PASSWORD=admin
DB_HOST=postgres
DB_PORT=5432

# 加密配置
ENCRYPTION_KEY=your_encryption_key

# MinIO对象存储配置
MINIO_ENDPOINT=minio
MINIO_PORT=9000
MINIO_ACCESS_KEY=minio_access_key
MINIO_SECRET_KEY=minio_secret_key

# Redis缓存配置
REDIS_HOST=redis
REDIS_PORT=6379

# 服务通信配置
BACKEND_URL=http://localhost:8080
VITE_BACKEND_URL=http://localhost:8080

# Google OAuth配置（可选）
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_REDIRECT_URI=your_google_redirect_uri

# 遥测配置（可选）
MAXUN_TELEMETRY=true

部署步骤

1. 克隆项目仓库并切换到master分支
2. 创建.env文件并填入上述配置（根据实际情况修改）
3. 运行docker-compose up命令启动服务
4. 访问http://localhost查看前端界面
5. 访问http://localhost:8080/api-docs查看API文档

常见问题排查

如果遇到启动失败的情况，可以尝试以下步骤：

1. 完全删除旧容器和关联卷
2. 检查端口冲突情况（特别是8080端口）
3. 验证环境变量配置是否正确
4. 查看容器日志定位具体错误

总结

Maxun项目团队已经解决了Docker部署中的主要问题，开发者现在可以按照上述指南顺利启动项目。正确的环境变量配置和干净的部署环境是成功运行的关键。如果仍有问题，建议检查日志获取更详细的错误信息。