折腾篇:openGym —— 一个 docker compose up 起来的健身记录,数据全留在自己硬盘

折腾篇:openGym —— 一个 docker compose up 起来的健身记录,数据全留在自己硬盘

项目地址:https://github.com/DuarteSantos8/openGym | 许可:AGPL-3.0(动作素材另算) | Star:约 2.3 万(22,924,2026-11-20 查询) | 最新版本:v1.4.5(2026-11-14 发布)

先说结论:如果你受够了把训练数据存在别人的服务器上、随时可能被订阅卡住,openGym 是目前自托管健身记录里完成度最高的一档。 它不是玩具:5600 多个动作库、进步规则、肌肉分布图、Apple Watch 与 Wear OS 双端、passkey 登录、离线 PWA 都齐了,而且 docker compose up -d 一条命令就能跑起来。

但它也有几个必须先看清的前提:动作图片和动画是第三方版权素材、并不随 AGPL 一起开放;手机上要用 passkey 同步必须给自己配 HTTPS 和域名;Google Play 版还在封闭测试,Android 目前主要靠 APK。这几点决定了它适合谁——文末单独列。

一、它跟 Keep、Strong 最根本的区别:数据是一个你能拷走的文件夹

多数健身 App 的数据活在开发者服务器上:账号在云端,历史在云端,公司一关或者一改收费策略,你的训练记录就跟着没。openGym 反过来——它跑在你自己的机器上,所有东西落在宿主机的 ./data 目录, backup 就是把这个目录打包:

文件 装的是什么
db.json 用户档案与 passkey 公钥
state-<user>.json 每个人的训练计划、训练记录、体重、设置
db.json.bak 上一份完好的 db.json,主文件坏了自动回退
audit.log 登录与管理操作日志(默认不记 IP)
secret 会话 Cookie 的签名密钥

这套设计带来两个很实际的好处。第一,导出就是复制文件,不需要在 App 里点「导出-上传-下载」;第二,它支持从 Strong、Hevy、FitNotes(CSV 或 API key)以及 Apple Health 的体重导出导入,换过来不用从零开始记。数据想再搬走时,也能整体导出成一个 JSON,或者把训练和身体数据导成 CSV 表格。

提醒一句:passkey 的私钥永远不离开你的设备安全芯片或密码管理器,服务器只存公钥。这意味着别人的服务器拿不到你的生物识别信息,但也意味着 RP_ID 和 ORIGIN 配错就登不上——这是这个项目 issue 区最常见的问题。

二、训练这条链它做得很细:计划 → 记录 → 进步 → 肌肉分布

openGym 的周计划页,可切换固定周计划与轮换模式

计划:一周七天排训练,动作库 5600 多个,每个动作带动画演示,能按器械筛选、在身体图上按肌肉浏览。内置四套入门计划(推/拉/腿、上/下肢、全身、5×5),加载后就是普通可编辑的常规计划,不是只读模板。不想按星期走,也可以用 A/B/C 轮换——下一次训练就是「还没做过的下一个」,周末打乱了也不影响。超级组、热身组、递减组、保持时间(平板支撑、悬垂、农夫行走)、按时间计的有氧,都能排。

记录:当天训练自动开始,重量从上一次自动带入,组间休息计时器在跑,新纪录(PR)当场识别。每组可以单独设次数、重量、RIR/RPE 努力程度;左滑删除(带撤销)、右滑复制;器械被占了,预设的替代动作一键换上并保留这组次数。杠铃片重量会按你各自的健身房配置算——你有几个场馆,就能各自维护一套杠铃片、哑铃和器械配重,手机走进哪个馆就切到哪个。

训练记录界面:重量、次数、RIR 与休息计时器同屏

进步:这是我认为它最像「正经训练工具」的部分。每条计划或每个动作可以单独设进步规则——线性加重、Greyskull LP、在可见次数区间里双重递进、三重递进(先次数、再组数、再重量),或者单纯加时间。每条目标都会解释为什么是这个数,少做的次数不会自动加重,卡住会触发减载周(deload)。另有估算 1RM 曲线、结构平衡比例(Poliquin / Thibaudeau / ATG)和整年的活动热力图。

统计页:总训练量、连续周数、体重曲线与动作等级

肌肉分布:三种模式看同一张肌肉图——练去的容量落在哪、哪些还在恢复、哪些根本没练到。这个视图比单纯记「今天卧推 4 组」有用得多,能直接看出自己是不是一直在练胸和二头。

三、装起来到底有多简单,以及架构长什么样

1
2
3
4
5
git clone https://github.com/DuarteSantos8/openGym
cd openGym
cp .env.example .env
docker compose pull
docker compose up -d

打开 http://localhost:8080,点 Create profile 就能用。动作动画已经打进镜像,不用另外下载,宿主机也不需装 Node。镜像同时发到 ghcr.io 和 GitLab Registry,amd64 / arm64 都有;想从源码构建就跳过 pull 改跑 --build。

架构:浏览器/PWA 经 HTTPS 到 nginx,nginx 转发 /api 给 Node,数据落到 ./data 的 JSON 文件

架构很克制:前端是 React 19 + Vite,构建成静态文件;API 是一个 node:http 服务,只依赖 @simplewebauthn/server、web-push 和 undici 三个包;nginx 把页面和 /api 收在同一个 origin 下——passkey 要求同 origin,这一点是刻意设计的。训练逻辑(进步规则、1RM、历史回读)是纯函数,旁边就放着单元测试。

同步机制值得单独说:每个档案的数据是一份带版本号的文档,设备保存时带上自己上次看到的版本;如果期间别人写过,服务器拒绝并返回当前文档,设备合并后重试。每处改动都带自己的时间戳,细到单个设置项或计划字段,合并时保留最新的那次编辑,删除也保持删除。断网或退出登录不会丢掉还没同步的内容,离线时 App 会显示横幅。

四、手机和手表不是附赠品,是同一套系统的另一半

同一套代码用 Capacitor 打包成手机 App,可以完全脱离服务器单机用(数据只留手机、不用账号),也可以连上你的服务器同步。获取方式按设备分:

平台 怎么装 备注
浏览器 opengym.ch 的 Live demo 真实 App 加示例数据,装之前可先试
自托管 Web docker compose up -d 后访问 8080 可加到主屏幕当 PWA,离线可用
iPhone / iPad App Store(含 Apple Watch App) 全球区上架
Android 最新 release 的签名 APK,或官网下载 分 Standard / Plus / HD 三种体积
Google Play 封闭测试中 需加入测试组并报名,满 14 天后开放
Wear OS 手表 随 Play 测试发放的 Beta 暂未正式发布

Android APK 的三个版本差别在于动作动画的分辨率:Standard(180 px,约 315 MB)、Plus(240 px,约 424 MB)、HD(360 px,约 760 MB)。APK 自带 .sha256 校验文件,和 Play 版共用同一个签名密钥,可以在两者之间切换而不丢数据。

手表端在 v1.4.5 刚做过一次大改:Apple Watch 与 Wear OS 统一了设计,数字表冠转动调重量/次数,整屏休息倒计时、每组心率、锁定按钮防误触都齐了,还能在表盘上放复杂功能。手表和手机上的组是联动的——在 iPhone 上勾掉一组,手表会自动跳到下一组;手机上暂停的休息计时,手表上也会停住。

五、开箱就有,但默认关着的两样东西

项目把一些「容易被人说是噱头」的功能默认关掉,这点我认可:

  • AI 教练:默认关闭,打开后能起草一周计划、根据你实际记录提调整建议、回答训练问题,但每一处改动都要你确认。它跑在你自己的服务器或手机上,用你自己的 key(Anthropic / OpenAI / Gemini / 任何 OpenAI 兼容端点,包括 Ollama)。默认安装里没有任何 AI 调用,不需要 API key。
  • MCP 服务:让 Claude Desktop 这类助手查询训练历史、把口述的训练记进去,本地运行,不在 Docker 镜像里。

另外有个叫 Modules 的开关,能在设置里把 Body、Health、Motivation、Coach、节日主题等整块功能关掉,界面里彻底消失,但数据一条不删。只想「记录训练」的人可以把它砍成极简版。

项目自述里坦白说大量代码、测试和文档是用 Claude Code 起草的,但由人决定和发布,训练逻辑有单元测试、CI 跑三套测试。这段放在 README 里,算是把话说在前面了。

六、已知的坑,以及适合谁 / 不适合谁

动作素材不是 AGPL 的。 openGym 自己的代码是 AGPL-3.0,但动作图片和动画版权归 Gym visual(© Aliaksandr Makatserchyk),授权范围仅限在 openGym 里使用:仓库和自托管服务器上是 180 px,更大尺寸只在 App 包里。非商业 fork 可以原样保留并带上声明,其他用途得自己去 gymvisual.com 买授权。想基于它做商业产品的人,这一条比 AGPL 本身更要命。

AGPL 的网络传染性。 你改了代码并作为网络服务提供给别人,就必须把改过的版本也按 AGPL 开源。自己家用无所谓,拿来二次开发做 SaaS 要先想清楚。

远程用 passkey 必须配 HTTPS。 本机 localhost 玩没问题,但要从手机连、要用 passkey,就得有域名 + HTTPS,并在 .env 里把 RP_ID 和 ORIGIN 配成一致。项目文档给了 Cloudflare Tunnel、Caddy、Traefik、nginx 的教程,也有局域网 HTTPS 和 Mac + Tailscale 的专门指南——这说明它不是「开箱就能手机连」,得动点手。

Android 与手表的成熟度有差。 Google Play 版仍在封闭测试(需要 12 名测试者满 14 天),Wear OS 版还是 Beta。只想从正规商店稳定更新的人,现在会有点别扭。

适合谁:想彻底掌控自己训练数据、有台 NAS 或常开小主机、愿意花半小时配 Docker 和 HTTPS、认真做力量训练并需要进步规则与肌肉分布的人;以及 iPhone + Apple Watch 用户,这端的完成度目前最高。

不适合谁:只想随手记几组、不想碰服务器和域名配置的人(浏览器 demo 或普通健身 App 更省事);想拿它做商业健身产品又不打算处理动作素材授权和 AGPL 的人;只认 Google Play 稳定版、不装 APK 的纯 Android 用户。

版本节奏是每 1 到 2 周一个 release,v1.4.5 在 2026-11-14 发布,重点在全平台手表重设计、Garmin 接入、循环训练、实时小组件、可真正执行动作的 Coach、教练与场馆、OIDC 和社区动作库。它是那种「你部署一次,然后隔两周就发现多了点东西」的项目——这也是自托管最舒服的状态。


折腾篇:openGym —— 一个 docker compose up 起来的健身记录,数据全留在自己硬盘
https://blog.luluvip.cn/2026/11/20/折腾篇-openGym-自托管健身记录/
作者
Sagit.
发布于
2026年11月20日
许可协议