CodeWithCJ/SparkyFitness

这是什么？

核心功能

• 01记录饮食、运动、饮水、睡眠、断食、情绪和身体围度。
• 02可从 Apple Health、Fitbit、Garmin Connect 等平台同步数据。
• 03支持多用户档案和家庭共享。
• 04支持 OIDC、TOTP、Passkey 和多因素认证登录。
• 05提供交互式图表和长期报告。
• 06包含可选的测试版 AI 聊天记录功能。

适用场景

• 为家庭成员免费记录饮食和训练数据，无需订阅付费应用。
• 在家用服务器或私有云上存放个人健康数据。
• 将多个穿戴设备和食品数据库的数据集中到一处管理。

快速上手

1. 1

   创建项目文件夹

   mkdir sparkyfitness && cd sparkyfitness
2. 2

   下载 docker-compose.yml

   curl -L -o docker-compose.yml https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/docker-compose.prod.yml
3. 3

   使用安全密钥填写 .env 文件（使用环境变量生成器或替换占位符）

4. 4

   启动应用，并在 http://localhost:3004 打开

   docker compose pull && docker compose up -d

使用前须知

• !SparkyFitness 是源码可见而非开源项目，许可证为非商业用途，商业使用需要获得许可。
• !版本之间可能出现破坏性变更，不建议自动更新容器。
• !AI 功能、家庭成员访问和 API 文档仍处于测试阶段，可能存在缺陷。

收录于专题

标签

常见问题

SparkyFitness 是什么？

可自托管的健身与健康记录工具，支持饮食、运动、饮水、睡眠和身体指标，并可多人共用。 SparkyFitness 是一个可自托管的健身记录平台，由后端 API 与数据存储、Web 前端以及 iOS 和 Android 原生应用组成。健康数据保存在用户自己控制的基础设施上，不依赖第三方服务。

SparkyFitness 可以免费使用吗？用的什么许可证？

SparkyFitness 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

SparkyFitness 还在维护吗？

活跃维护中。SparkyFitness 最近一次提交是在 2026年10月24日。

SparkyFitness 适合用来做什么？

为家庭成员免费记录饮食和训练数据，无需订阅付费应用。 在家用服务器或私有云上存放个人健康数据。 将多个穿戴设备和食品数据库的数据集中到一处管理。

SparkyFitness 怎么安装和运行？

创建项目文件夹: mkdir sparkyfitness && cd sparkyfitness 下载 docker-compose.yml: curl -L -o docker-compose.yml https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/docker-compose.prod.yml 使用安全密钥填写 .env 文件（使用环境变量生成器或替换占位符） 启动应用，并在 http://localhost:3004 打开: docker compose pull && docker compose up -d

在哪里获取 SparkyFitness？

源代码和安装说明在 GitHub 上：https://github.com/CodeWithCJ/SparkyFitness