SparkyFitness - MyFitnessPal 的自托管替代方案

SparkyFitness 是一款全面的健身跟踪与管理应用，旨在帮助用户监控营养、锻炼和身体数据。它提供每日进展跟踪、目标设定和有洞察力的报告工具，支持健康生活方式。

文档：https://codewithcj.github.io/SparkyFitness

✨ 功能亮点

🍎 营养追踪

• 记录您的每日饮食
• 创建和管理自定义食物与类别
• 通过交互式图表查看摘要并分析趋势

💪 运动记录

• 记录您的锻炼
• 浏览和搜索全面的运动数据库
• 跟踪健身进展

💧 饮水摄入监控

• 跟踪每日饮水目标
• 简单快捷地记录饮水

📏 身体测量

• 记录身体指标（如体重、腰围、臂围）
• 添加自定义测量类型
• 通过图表可视化进展

🎯 目标设定

• 设定和管理健身与营养目标
• 跟踪进展情况

🗓️ 每日签到

• 监控每日活动
• 通过习惯追踪保持一致性

🤖 AI营养教练（SparkyAI）

• 通过聊天记录食物、锻炼、身体数据和步数
• 上传食物图片自动记录餐饮
• 包括聊天历史和个性化指导

🔒 用户认证与个人资料

• 安全登录系统
• 在用户资料之间切换
• 支持家庭访问和管理

📊 综合报告

• 生成营养和身体指标摘要
• 跟踪数周或数月的长期趋势

🎨 可自定义主题

• 切换浅色和深色模式
• 采用极简、无干扰界面设计

需要帮助？

• 加入 Discord

https://discord.gg/vcnMT5cPEA

• 在讨论区发帖

� 快速开始

几分钟内让 SparkyFitness 运行起来：

# Clone the repository
git clone https://github.com/CodeWithCJ/SparkyFitness.git
cd SparkyFitness
Copy environment template and edit as needed
cp docker/.env.example .env
Start development environment (with live reloading)
./docker/docker-helper.sh dev up
Access application at http://localhost:8080

📖 文档

有关完整的安装指南、开发环境设置和使用说明，请访问我们的综合文档：

👉 SparkyFitness 文档网站

快速链接

• 🚀 入门指南 - 开发与生产环境的完整设置指南
• 🐳 Docker 指南 - Docker 部署与配置说明
• 🔧 开发工作流程 - 开发者指南及贡献流程
• 📊 功能概览 - 全部功能文档
• 🏗️ 架构设计 - 技术架构与设计说明
• 参考 WIiki 获取示例环境配置和移动应用设置。

🐳 Docker 部署

生产环境（推荐）：

cp docker/.env.example .env  # Edit as needed
./docker/docker-helper.sh prod up
Access at http://localhost:3004

开发：

cp docker/.env.example .env  # Edit as needed  
./docker/docker-helper.sh dev up
Access at http://localhost:8080 (live reloading)

有关详细的安装说明、环境配置和故障排除，请参阅完整文档。

⚠️ 已知问题 / Beta 功能 ⚠️

以下功能目前处于测试阶段，可能尚未经过全面测试。请注意可能存在的漏洞或功能不完整：

• AI 聊天机器人
• 多用户支持
• 家庭和朋友访问
• 集成 Apple Health 数据

该应用程序正在积极开发中。由于 Supabase 到 PostgreSQL 的迁移，某些功能可能无法按预期工作。在应用稳定之前，可能会引入重大更改（BREAKING CHANGES）。 对于新版本，你可能需要更改 Docker/环境变量。因此，不建议使用 Watchtower 或类似应用自动升级。请阅读发布说明以了解任何重大更改（BREAKING CHANGES）。

--- Tranlated By Open Ai Tx | Last indexed: 2025-10-04 ---