SparkyFitness

一个自托管、隐私优先的 MyFitnessPal 替代方案。在完全控制自己数据的前提下，跟踪营养、锻炼、身体指标和健康数据。

SparkyFitness 是一个由以下部分组成的自托管健身追踪平台：

• 后端服务器（API + 数据存储）
• 基于 Web 的前端
• 适用于 iOS 和 Android 的原生移动应用

它在您可控的基础设施上存储和管理健康数据，无需依赖第三方服务。

核心功能

• 营养、锻炼、饮水、睡眠、禁食、情绪和身体测量跟踪
• 目标设定与每日签到
• 交互式图表和长期报告
• 多用户档案和家庭访问
• 浅色和深色主题
• OIDC、TOTP、Passkey、多因素认证等

健康与设备集成

SparkyFitness 可从多个健康与健身平台同步数据：

• Apple Health（iOS）
• Google Health Connect（Android）
• Fitbit
• Garmin Connect
• Withings
• Polar Flow（部分测试）
• Hevy（未测试）
• OpenFoodFacts
• USDA
• Fatsecret
• Nutritioninx
• Mealie
• Tandoor
• Strava（部分测试）

集成会自动将步数、锻炼和睡眠等活动数据，以及体重和身体测量等健康指标，同步到您的 SparkyFitness 服务器。

可选 AI 功能（测试版）

SparkyAI 提供用于记录数据和回顾进展的对话界面。

• 通过聊天记录饮食、锻炼、身体数据和步数
• 上传食物图片，实现自动膳食记录
• 保留对话历史以便后续跟进

注意：AI 功能目前处于测试阶段。

快速开始（服务器）

使用 Docker Compose 可在几分钟内部署 SparkyFitness 服务器。

# 1. Create a new folder
mkdir sparkyfitness && cd sparkyfitness
2. Download Docker files only
curl -L -o docker-compose.yml https://github.com/CodeWithCJ/SparkyFitness/releases/latest/download/docker-compose.prod.yml
curl -L -o .env https://github.com/CodeWithCJ/SparkyFitness/releases/latest/download/default.env.example
3. (Optional) Edit .env to customize database credentials, ports, etc.
4. Start the app
docker compose pull && docker compose up -d
Access application at http://localhost:8080

🎥 视频教程

快速 2 分钟教程，演示如何安装 SparkyFitness（自托管健身追踪器）。

文档

如需完整的安装指南、配置选项和开发文档，请访问我们的文档网站。

快捷链接

• 安装指南 - 部署与配置
• 功能概览 - 完整功能文档
• 开发流程 - 开发者指南与贡献流程
• iOS 应用信息 与 Android 应用信息

需要帮助？

• 在 Github issues/discussion 发帖。
• 想要更快获得响应并与社区成员互动，加入我们的 Discord

Star 历史

翻译

Weblate 翻译

代码仓库活动

贡献者

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

SparkyFitness 正在积极开发中。 版本间可能会有重大更改。

• 不推荐自动更新容器
• 升级前请务必查看发布说明

以下功能目前处于测试版，可能尚未经过充分测试。请预期可能存在缺陷或功能不完整：

• AI 聊天机器人
• 家庭和朋友访问
• API 文档

--- Tranlated By Open Ai Tx | Last indexed: 2026-04-20 ---