SparkyFitness项目Docker容器化部署指南

项目概述

SparkyFitness是一个基于现代Web技术的健身应用系统，采用前后端分离架构。本文主要介绍如何使用Docker Compose快速部署SparkyFitness项目的生产环境。

部署架构解析

该Docker Compose配置定义了一个由两个核心服务组成的系统架构：

1. 前端服务：基于React/Vue等现代前端框架构建的用户界面
2. 后端服务：处理业务逻辑的Node.js服务器

两个服务通过自定义的IPv6网络sparky-fitness-ipv6-net进行通信，这种网络隔离设计既保证了服务间的互联互通，又提供了必要的安全隔离。

环境变量配置详解

前端服务环境变量

• NODE_ENV=production：设置生产环境模式
• VITE_SUPABASE_URL：Supabase项目URL
• VITE_SUPABASE_ANON_KEY：Supabase匿名访问密钥
• SUPABASE_PROJECT_REF：Supabase项目引用标识
• VITE_SUPABASE_DB_PASSWORD：数据库密码
• TZ：时区设置（默认为America/New_York）
• SUPABASE_ACCESS_TOKEN：可选，用于启用聊天机器人功能

后端服务环境变量

• SPARKY_FITNESS_SERVER_PORT：后端服务监听端口
• LOG_LEVEL：日志级别控制
• SUPABASE_URL：Supabase服务URL
• SUPABASE_SERVICE_ROLE_KEY：Supabase服务角色密钥
• SUPABASE_ACCESS_TOKEN：后端聊天机器人访问令牌

网络配置特色

该配置特别启用了IPv6支持，创建了一个名为sparky-fitness-ipv6-net的桥接网络，并分配了2001:db8:3::/64子网。这种配置：

1. 为未来IPv6环境做好准备
2. 提供更好的网络隔离性
3. 支持服务间通过容器名称直接通信

端口映射说明

• 前端服务：将容器内的3000端口映射到主机的3004端口
• 后端服务：将容器内的3010端口映射到主机的3010端口

这种映射方式使得：

• 前端可通过http://localhost:3004访问
• 后端API可通过http://localhost:3010访问

部署实践建议

1. 环境准备：

   • 确保主机已安装Docker和Docker Compose
   • 创建.env文件并设置所有必要的环境变量

2. 启动命令：

   docker-compose up -d
   

3. 监控与维护：

   • 使用docker-compose logs查看服务日志
   • 配置了restart: always确保服务异常退出后自动重启

4. 时区调整： 根据实际部署地区修改TZ环境变量，例如亚洲地区可使用Asia/Shanghai

安全注意事项

1. 敏感信息（如数据库密码、API密钥）应通过.env文件管理，不要直接写入配置文件
2. 生产环境应考虑添加TLS/SSL加密
3. 定期更新容器镜像以获取安全补丁

扩展性设计

该配置具有良好的扩展性：

• 可轻松添加数据库服务容器
• 支持横向扩展后端服务实例
• IPv6网络设计为未来扩展预留了空间

通过这份Docker Compose配置，SparkyFitness项目实现了快速部署、环境一致性和易于维护的生产环境搭建方案。开发者可以根据实际需求进一步调整和优化配置参数。