Skip to content

Latest commit

 

History

History
244 lines (172 loc) · 14.4 KB

README_vi.md

File metadata and controls

244 lines (172 loc) · 14.4 KB

English · 简体中文 · 繁體中文 · 日本語 · 한국어 · हिन्दी · ไทย · Français · Deutsch · Español · Italiano · Русский · Português (Brasil) · Nederlands · Polski · العربية · فارسی · Türkçe · Tiếng Việt · Bahasa Indonesia

SparkyFitness

Một giải pháp thay thế tự lưu trữ (self-hosted), đặt quyền riêng tư lên hàng đầu cho MyFitnessPal, Flo, Hevy, Shotsy và nhiều ứng dụng khác. Theo dõi dinh dưỡng, tập luyện, chỉ số cơ thể và dữ liệu sức khỏe trong khi vẫn toàn quyền kiểm soát dữ liệu của bạn. hình ảnh

SparkyFitness là một nền tảng theo dõi thể chất tự lưu trữ, bao gồm:

  • Một máy chủ backend (API + lưu trữ dữ liệu)
  • Một giao diện frontend trên nền web
  • Ứng dụng di động gốc cho iOS và Android

Nền tảng lưu trữ và quản lý dữ liệu sức khỏe trên hạ tầng do bạn kiểm soát, không phụ thuộc vào dịch vụ của bên thứ ba.

Tính năng chính

  • Theo dõi dinh dưỡng, tập luyện, lượng nước uống, giấc ngủ, nhịn ăn, tâm trạng và số đo cơ thể
  • Đặt mục tiêu và check-in hằng ngày
  • Biểu đồ tương tác và báo cáo dài hạn
  • Nhiều hồ sơ người dùng và quyền truy cập cho gia đình
  • Giao diện sáng và tối
  • OIDC, TOTP, Passkey, MFA, v.v.

So sánh SparkyFitness

SparkyFitness là phần mềm công khai mã nguồn (source-available), không phải mã nguồn mở — giấy phép chỉ cho phép sử dụng phi thương mại và cần được cấp phép đối với mục đích thương mại.

Hầu hết các ứng dụng chỉ làm một việc. Một ứng dụng dinh dưỡng tốt có giá 40–100 USD mỗi năm; để có đủ mọi thứ mà SparkyFitness cung cấp, bạn cần ba hoặc bốn gói đăng ký cho mỗi người, và vẫn không có một báo cáo chung nào cho tất cả. SparkyFitness làm được điều đó trong một ứng dụng duy nhất, miễn phí, cho cả gia đình.

Giá niêm yết tại Mỹ, ngày 14/08/2026. Chi tiết chi phí đầy đủ →

SparkyFitness wger MyFitnessPal Cronometer Hevy Zero Flo Garmin Connect Google Health
Tự lưu trữ, dữ liệu vẫn thuộc về bạn ⭐ ✅ ❌ ❌ ❌ ❌ ❌ ❌ ❌
Không đăng ký, không quảng cáo ✅ ✅ ❌ 🟡 🟡 ❌ ❌ ✅ 🟡
Dinh dưỡng, sức mạnh, giấc ngủ, nhịn ăn, chu kỳ và thuốc ở cùng một nơi* ⭐ 🟡 🟡 🟡 ❌ ❌ ❌ 🟡 🟡
Toàn bộ lịch sử và báo cáo theo khoảng thời gian tùy chọn ✅ miễn phí 🟡 💰 💰 💰 💰 💰 ✅ 💰
Đồng bộ thiết bị đeo và nền tảng sức khỏe ✅ 8+ dịch vụ ❌ ✅ ⭐ ✅ 🟡 🟡 🟡 ✅
Chia sẻ gia đình với phân quyền chi tiết ⭐ 7 quyền ❌ ❌ 🟡 ❌ ❌ ❌ 🟡 🟡
Nhập CSV và xuất dữ liệu miễn phí ✅ 🟡 💰 ✅ ✅ 🟡 🟡 🟡 ❌
Máy chủ MCP + dùng LLM của riêng bạn ⭐ 🟡 ❌ ❌ ❌ ❌ ❌ ❌ ❌

⭐ nổi bật  •  ✅ được hỗ trợ  •  🟡 một phần  •  💰 chỉ gói trả phí  •  ❌ không hỗ trợ

* Các giai đoạn giấc ngủ, HRV và đường huyết được nhập từ đồng hồ, điện thoại hoặc máy đo của bạn. SparkyFitness lưu trữ, phân tích và vẽ biểu đồ cho chúng chứ không tự đo.

Bảng này do chính dự án được so sánh viết, vì vậy hãy đọc với tinh thần đó. Đã được kiểm tra vào ngày 14/08/2026 dựa trên tài liệu chính thức, kho mã nguồn và trang cửa hàng ứng dụng; một số thông tin có thể đã lỗi thời. Nếu một ô nào đó sai hoặc không công bằng với dự án khác, hãy mở một issue — những đính chính khiến SparkyFitness trông kém hơn cũng được hoan nghênh như nhau.

Xem bảng so sánh đầy đủ → — 17 ứng dụng thuộc các nhóm tự lưu trữ, dinh dưỡng, chuyên biệt và hệ sinh thái thiết bị, cùng những điểm mà mỗi ứng dụng vượt trội hơn chúng tôi.

Tích hợp sức khỏe và thiết bị

SparkyFitness có thể đồng bộ dữ liệu từ nhiều nền tảng sức khỏe và thể chất:

  • Apple Health (iOS)
  • Google Health Connect (Android)
  • Google Health API
  • Fitbit
  • Garmin Connect
  • Withings
  • Polar Flow
  • Oura
  • Hevy
  • OpenFoodFacts
  • USDA
  • Fatsecret
  • Nutritionix
  • Mealie
  • Tandoor
  • Strava (đã thử nghiệm một phần)
  • COROS
  • Norish
  • Yazio (dùng API không chính thức)
  • Swiss Food Database
  • Canadian Nutrient File (Health Canada)
  • Swedish Food Agency (Livsmedelsverket)
  • Free Exercise DB (Github)
  • Wger

Các tích hợp tự động đồng bộ dữ liệu hoạt động như số bước, buổi tập và giấc ngủ, cùng với các chỉ số sức khỏe như cân nặng và số đo cơ thể, về máy chủ SparkyFitness của bạn.

Tính năng AI tùy chọn (Beta)

SparkyAI cung cấp giao diện trò chuyện để ghi lại dữ liệu và xem lại tiến độ.

  • Ghi lại thức ăn, bài tập, chỉ số cơ thể và số bước qua trò chuyện
  • Tải lên ảnh món ăn để tự động ghi lại bữa ăn
  • Lưu lịch sử trò chuyện để hỏi tiếp

Lưu ý: Các tính năng AI hiện đang trong giai đoạn beta.

Cài đặt

Chọn một trong hai cách để chạy SparkyFitness:

1. Tự lưu trữ

Khởi chạy máy chủ SparkyFitness chỉ trong vài phút bằng Docker Compose:

# 1. Tạo một thư mục mới
mkdir sparkyfitness && cd sparkyfitness

# 2. Tải xuống docker-compose.yml
curl -L -o docker-compose.yml https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/docker-compose.prod.yml

# 3. Thiết lập cấu hình .env của bạn (Chọn một tùy chọn):
# Tùy chọn A (Khuyên dùng): Tạo .env tùy chỉnh với khóa bảo mật chỉ bằng 1 cú nhấp trong trình duyệt:
# 👉 https://codewithcj.github.io/SparkyFitness/install/env-generator

# Tùy chọn B: Mẫu tối giản — 5 giá trị, mọi thứ khác dùng giá trị mặc định
# mà docker-compose đã áp dụng sẵn. Phù hợp với hầu hết các bản cài đặt tự lưu trữ.
curl -L -o .env https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/.env.simple.example

# Tùy chọn C: Tham chiếu đầy đủ — mọi biến được hỗ trợ, đều được chú thích kèm
# giá trị mặc định. Bắt đầu từ đây nếu dùng SSO, SMTP, cơ sở dữ liệu ngoài hoặc reverse proxy.
# curl -L -o .env https://raw.githubusercontent.com/CodeWithCJ/SparkyFitness/main/docker/.env.example

# 4. Thay thế các giá trị giữ chỗ (bỏ qua nếu bạn dùng Tùy chọn A — trình tạo
# đã điền sẵn). Máy chủ sẽ từ chối khởi động nếu chúng vẫn để nguyên,
# vì nếu không cơ sở dữ liệu sẽ được khởi tạo với một mật khẩu đã công khai.
#   SPARKY_FITNESS_DB_PASSWORD        một mật khẩu mạnh bất kỳ
#   SPARKY_FITNESS_API_ENCRYPTION_KEY openssl rand -hex 32     (64 ký tự hex)
#   BETTER_AUTH_SECRET                openssl rand -base64 32  (44 ký tự)
#   SPARKY_FITNESS_FRONTEND_URL       URL mà bạn sẽ dùng để mở ứng dụng

# 5. Khởi động ứng dụng
docker compose pull && docker compose up -d

# Truy cập ứng dụng tại http://localhost:3004

Lưu ý: Để biết đầy đủ các tùy chọn cấu hình, reverse proxy và các phương thức cài đặt khác, hãy truy cập Trang tài liệu.

2. Đám mây (dành cho người dùng không chuyên kỹ thuật)

Nếu bạn không phải người dùng kỹ thuật và không muốn chạy SparkyFitness trên máy chủ của riêng mình, bạn có thể triển khai một phiên bản được lưu trữ trên đám mây thông qua một trong các nhà cung cấp sau.

Chạy trên PikaPods
Triển khai với Zenith

Lưu ý: Đây là các dịch vụ độc lập của bên thứ ba. Chúng tôi khuyến khích bạn tìm hiểu các tính năng của từng nhà cung cấp để chọn ra dịch vụ phù hợp nhất với nhu cầu của mình.

🎥 Video hướng dẫn

Xem video

Video hướng dẫn nhanh 2 phút về cách cài đặt SparkyFitness (ứng dụng theo dõi thể chất tự lưu trữ).

Tài liệu

Để xem hướng dẫn cài đặt đầy đủ, các tùy chọn cấu hình và tài liệu phát triển, vui lòng truy cập Trang tài liệu của chúng tôi.

Liên kết nhanh

Cần trợ giúp?

  • Đăng bài trong mục issues/discussions trên Github.
  • Để được phản hồi nhanh hơn và nhận trợ giúp từ các thành viên khác trong cộng đồng, Tham gia Discord của chúng tôi

Lịch sử sao

Biểu đồ lịch sử sao

Bản dịch

Bản dịch trên Weblate

Trạng thái bản dịch

Trạng thái bản dịch

Hoạt động của kho mã

Alt

Người đóng góp

Những người đóng góp cho SparkyFitness

⚠️ Vấn đề đã biết / Tính năng Beta ⚠️

SparkyFitness đang được phát triển tích cực. Các thay đổi phá vỡ tương thích có thể xảy ra giữa các bản phát hành.

  • Không khuyến khích tự động cập nhật container
  • Luôn đọc ghi chú phát hành trước khi nâng cấp

Các tính năng sau hiện đang trong giai đoạn beta và có thể chưa được kiểm thử kỹ lưỡng. Hãy lường trước khả năng có lỗi hoặc chức năng chưa hoàn chỉnh:

  • Chatbot AI
  • Quyền truy cập cho Gia đình và Bạn bè
  • Tài liệu API

Đây là bản dịch của README tiếng Anh. Nếu có bất kỳ điểm nào khác biệt, phiên bản tiếng Anh là bản tham chiếu.