SparkyFitness - MyFitnessPal 的自架替代方案

SparkyFitness 是一套全面的健身追蹤與管理應用程式，設計用於協助使用者監控營養、運動及身體數據。它提供每日進度追蹤、目標設定及詳細報告工具，助你維持健康生活方式。

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

✨ 功能

🍎 營養追蹤

• 記錄您的每日餐點
• 建立並管理自訂食物和分類
• 透過互動式圖表檢視摘要並分析趨勢

💪 運動紀錄

• 記錄您的運動活動
• 瀏覽並搜尋完整的運動資料庫
• 追蹤健身進展

💧 飲水攝取監控

• 追蹤每日飲水目標
• 簡單快速地記錄飲水量

📏 身體測量

• 記錄身體指標（例如體重、腰圍、手臂）
• 新增自訂測量類型
• 以圖表視覺化進展

🎯 目標設定

• 設定並管理健身與營養目標
• 長期追蹤進度

🗓️ 每日簽到

• 監控每日活動
• 透過習慣追蹤保持一致

🤖 AI 營養教練（SparkyAI）

• 透過聊天記錄食物、運動、身體數據及步數
• 上傳食物圖片自動記錄餐點
• 包含聊天紀錄及個人化指導

🔒 使用者驗證與個人檔案

• 安全登入系統
• 切換使用者個人檔案
• 支援家庭存取與管理

📊 全面性報告

• 產生營養與身體指標摘要
• 追蹤數週或數月的長期趨勢

🎨 可自訂主題

• 切換明亮與深色模式
• 以極簡、無干擾介面設計

需要協助嗎？

• 加入 Discord

https://discord.gg/vcnMT5cPEA

• 在討論區發文

� 快速開始

幾分鐘內即可啟動 SparkyFitness：

# 1. Create a new folder
mkdir sparkyfitness && cd sparkyfitness
2. Download Docker files only
curl -o docker-compose.yml https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/docker-compose.prod.yml
curl -o .env https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/.env.example
3. (Optional) Edit .env to customize your setup
e.g., update database credentials, ports, etc.
if you require Gamrin integration, uncomment Garmin section from compose file.
4. Start the app
docker compose pull && docker compose up -d
Access application at http://localhost:8080

📖 文件說明

完整的安裝指南、開發設置及使用說明，請參閱我們的詳細文件：

👉 SparkyFitness 文件網站

快速連結

• 🚀 新手入門 - 開發及正式環境的完整設置指南
• 🐳 Docker 指南 - Docker 部署與設定
• 🔧 開發流程 - 開發人員指南與貢獻流程
• 📊 功能總覽 - 完整功能文件
• 🏗️ 架構設計 - 技術架構與設計
• 請參閱 Wiki 以取得範例環境設置和行動應用程式配置。

星標歷史

翻譯

程式庫活動

貢獻者

⚠️ 已知問題 / 測試版功能 ⚠️

以下功能目前為測試版，可能尚未經過充分測試。請預期可能出現錯誤或功能不完整：

• AI 聊天機器人
• 多用戶支援
• 家人與朋友存取
• Apple Health 資料整合

本應用程式正在密集開發中。由於 Supabase 正在遷移至 PostgreSQL，可能有些功能無法如預期運作。直到應用程式穩定前，可能會引入重大變更（BREAKING CHANGES）。 每次新版本發佈時，可能需要修改 Docker／環境變數。因此，不建議使用 Watchtower 或類似應用程式自動升級。請閱讀發佈說明以了解任何重大變更（BREAKING CHANGES）。

--- Tranlated By Open Ai Tx | Last indexed: 2026-01-01 ---