
介绍
AGPL-3.0,JavaScript(前端 React 19 + Vite,后端纯 node:http),两万三千星。一句话:把 Strong、Hevy 那类每月订阅的健身记录 App,换成一台自己的小服务器。【练了几年才发现,训练数据是长期资产,交给订阅制 App 等于把几年的进步押在别人的定价上】
部署很干脆:clone、cp .env.example .env、docker compose pull、docker compose up -d,浏览器开 http://localhost:8080 建个 profile 就开始记录。镜像有 amd64 和 arm64,健康检查 curl http://localhost:8080/api/health 会回 {"ok":true}。
数据是怎么存的?没有数据库,全部是 ./data 下的 JSON:db.json 存用户和公钥,state-<user>.json 存计划、训练、体重、设置,还有 audit.log、cookie 签名密钥、推送的 vapid 密钥。也就是说备份就是打包一个目录,迁移就是拷走一个目录——比"导出 CSV 再祈祷"踏实。
同步也做得很认真:每个 profile 一个文档加服务端 revision,设备带着上次 revision 提交,冲突就回 409 和当前文档,客户端逐字段合并(细到单条设置、单个计划字段)再重试,删除也留删除标记。这套思路值得抄。
功能上不虚那些付费 App:动作库 5632 个,每个带 180px 动画,约 80MB 直接打进 web 镜像,首启不用下载;训练引擎有线性、Greyskull LP、双重渐进、三重渐进、加时间;估算 1RM 曲线、Structural Balance;肌肉热力图能在"容量去向/还在恢复/久未训练"三种模式间切;能导入 FitNotes、Strong、Hevy 和 Apple Health 的体重记录。
登录全用 passkey,还能同时开密码登录、OIDC、邀请码。手机端是同一套 Capacitor 代码,Apple Watch 也有 App,安卓 APK 分三档(Standard 约 315MB、Plus 约 424MB、HD 约 760MB)。
坑得提前说:passkey 绑的是精确主机名,只认 HTTPS 或 http://localhost,手机用 http://局域网IP:8080 是弹不出 passkey 的,想要手机端顺利用必须给它一个真域名;RP_ID 只能填裸主机名、ORIGIN 带协议不能带尾斜杠,改这两项会让已有 passkey 全部失效;改完 .env 要 up -d 而不是 restart,因为 restart 不重读环境变量;反代默认 1MiB 的 body 上限得放到 5MiB 以上,也别再叠一层 CORS 头,不然手机配对会莫名失败。
另外它标的是 26 种语言,明确列了繁体中文,没写简体;动作素材另有一份授权,只允许在这个项目里用。
特征
🏋️ 5632 个动作带动画,直接打包进镜像不用下载
🐳 两个容器起步,docker compose up -d 就完事
🗂️ 全 JSON 存储,备份/迁移就是拷 ./data 目录
🔄 revision + 409 逐字段合并,多设备同步不丢数据
🔑 passkey 登录,可选密码、OIDC、邀请码
📈 1RM 曲线、Structural Balance、肌肉热力图
📥 导入 FitNotes / Strong / Hevy / Apple Health
📱 Capacitor 一套代码出 iOS、Watch、安卓三档 APK
🤖 可选 AI coach,自带 key 跑在自己服务器或手机上
🌐 26 种语言,模块开关能整块关掉功能而不删数据