SparkyFitness
SparkyFitness:專為家庭打造。AI 驅動。一起追蹤飲食、健身、水分與健康。
SparkyFitness 是什麼?
SparkyFitness 是一款專為家庭設計、由人工智慧驅動的健康管理工具。讓家庭成員能共同追蹤飲食、健身活動、水分攝取與整體健康狀況。
SparkyFitness 概覽
這是什麼
SparkyFitness 是一個自架、隱私優先的健身追蹤平台,可作為 MyFitnessPal、Flo、Hevy、Shotsy 等應用程式的替代方案。它包含後端伺服器、網頁前端、iOS 與 Android 原生應用程式,以及 Apple Watch 與 Wear OS 的配套應用程式。平台將健康資料儲存在您控制的基礎設施上,不依賴第三方服務。
主要功能
- 追蹤營養、運動、水分、睡眠、禁食、情緒與身體測量數據
- 設定目標與每日簽到
- Apple Watch 與 Wear OS 應用程式:支援目標、水分、體重、禁食、藥物、運動與錶面複雜功能
- 互動式圖表與長期報告
- 多使用者個人檔案與家庭存取(含細緻權限)
- 淺色與深色主題;支援 OIDC、TOTP、Passkey、MFA 等
使用情境
SparkyFitness 專為個人與家庭設計,讓您能在一個地方追蹤多種健康與健身面向(如營養、運動、睡眠與水分),同時完全掌控自己的資料。它適合重視隱私的自架環境,並可取代多個付費訂閱服務。
快速開始
bash# 1. 建立新資料夾mkdir sparkyfitness && cd sparkyfitness# 2. 下載 docker-compose.ymlcurl -L -o docker-compose.yml https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/docker-compose.prod.yml# 3. 設定 .env 設定檔(選擇一種方式):# 選項 A(建議):在瀏覽器中一鍵產生自訂 .env 與安全金鑰:# 👉 https://codewithcj.github.io/SparkyFitness/install/env-generator# 選項 B:最小範本 — 5 個值,其餘使用預設值# docker-compose 已套用。適用於大多數自架安裝。curl -L -o .env https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/.env.simple.example# 選項 C:完整參考 — 每個支援的變數都已註解並附上預設值。# 若需 SSO、SMTP、外部資料庫或反向代理,請從此開始。# curl -L -o .env https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/.env.example# 4. 取代預留位置(若使用選項 A 則跳過 — 產生器已填入)。# 伺服器在保留預設值時拒絕啟動,資料庫也會使用公開密碼初始化。# SPARKY_FITNESS_DB_PASSWORD 任何強密碼# SPARKY_FITNESS_API_ENCRYPTION_KEY openssl rand -hex 32 (64 個十六進位字元)# BETTER_AUTH_SECRET openssl rand -base64 32 (44 個字元)# SPARKY_FITNESS_FRONTEND_URL 您將用來開啟應用程式的網址# 5. 啟動應用程式docker compose pull && docker compose up -d# 在 http://localhost:3004 存取應用程式
授權與價格
元資料中未聲明授權(NOASSERTION)。README 指出 SparkyFitness 是原始碼可取得(source-available)而非開源,授權為非商業用途,商業使用需取得許可。元資料中的定價類型標示為 open_source,但 README 澄清並非開源。未提供具體價格;專案描述為對整個家庭免費。
內容整理自該專案公開的 README 與儲存庫資訊。