openGym:可自托管的开源健身与体重追踪器,手机与手表都能练
摘要
openGym 是 AGPL-3.0 开源的健身房与体重追踪器:App Store(iPhone/Apple Watch)与 Android APK,亦可 Docker 自托管;5600+ 带动画动作、肌群热力、Strong/Hevy 导入,可选 AI 教练与 MCP。
本文目录
openGym是 DuarteSantos8开源的健身房与体重追踪应用:可在 App Store安装 iPhone/iPad与 Apple Watch,也可下载 Android APK;也能用 Docker自托管,或仅在手机本地使用、不必连服务器。仓库描述与官网 opengym.ch强调:规划训练日、记录组次、查看肌群热力、从 Strong/Hevy/FitNotes导入历史,数据放在你自己的文件夹里。技术栈以 JavaScript、React、Vite为主,协议为 AGPL-3.0。本文整理时 GitHub公开星标约17720、fork约2300(以页面实时数为准)。README写明动作库「超过5600」个带动画示范的动作;路线图 v1.4.0进一步写到5632个——下文统一以官方文档口径表述,不沿用社媒夸张写法。

图片来源:openGym 官方 GitHub README hero
它解决什么问题
主流健身 App往往把训练记录锁在云端账号里:停订就丢历史、换机要重新订阅,还可能夹广告与遥测。想自己备份、换工具或长期对照体重与力量曲线时,用户只能导出 CSV再手工拼。自托管方案又常缺手机体验:网页能记账,手表不能点组、离线不稳,导入 Strong/Hevy也很费劲。
openGym的定位是「像现代 App,但数据在你手里」。同一套前端可装成 Capacitor手机应用,也能 `docker compose up` 跑在自己的机器上;Passkey(Face ID/指纹)登录,支持离线与多端字段级合并同步。健身房里要安静界面、休息计时、杠铃片数换算;家里要周计划、肌群恢复视图、体重目标线——这些都落在同一产品里,而不是再绑一个订阅墙。可选的 AI教练与 MCP服务默认关闭,用自己的模型密钥时才启用,每次改计划都要你批准。

图片来源:openGym 官方仓库 assets/screenshots
它能做什么
- 计划与动作库:按工作日排程,或用 A/B/C轮转;内置 Push/Pull/Legs、上下肢、全身、5×5等可编辑起步计划。动作库按官方 README为 超过5600 个带动画示范的动作(路线图写 v1.4.0更新至 5632),可按肌群身体图与器械筛选;支持超级组、热身、递减组、休息停顿、计时动作与有氧,以及自建动作(本地剥除照片定位后再上传)。
- 训练现场:今日课自动开练、重量预填上次、组间休息计时、PR检测;可选 RIR/RPE;杠铃/EZ/陷阱杠/史密斯片数计算;单侧次数、屏幕常亮、嘈杂健身房闪屏提醒;机器占用时可一键换备用动作并保留组次数。
- 进度与肌群热力:线性、Greyskull LP、双/三进程等进阶规则;预估1RM曲线、结构平衡比例、全年活动热力;肌群图三种模式——容量去向、仍在恢复、长期未练;体重对照目标线与进度照片前后滑杆;可事后改记录并重算成绩。
- 账户与数据主权:Passkey多端同步,冲突按字段合并;可从 FitNotes、Strong、Hevy(CSV或 API)与 Apple Health体重导入,整包 JSON或表格导出;计划可分享小文件或打印 PDF;约20种语言(含繁体中文与阿语 RTL)。
- 手机与手表:App Store覆盖 iPhone/iPad与 Apple Watch(表冠确认组次、腕上 RPE/RIR、全屏休息倒计时、组内心率);Android提供 Standard/Plus/HD三档 APK(动画分辨率与体积不同,约315–760 MB);桌面小部件与 Live Activity可在锁屏记一组。
- 自托管与可选 AI:Docker Compose一键拉起(amd64/arm64预构建镜像);浏览器演示站 opengym.ch/demo。可选 AI教练(自备 Anthropic/OpenAI/Gemini/兼容端点或 Ollama,改计划需人工批准)与本地 MCP服务(如 Claude Desktop查历史、口述记训练;MCP不进默认 Docker构建)。
典型路径:想先试,打开官网演示;想手机练,装 App Store或 APK可单机;想全家/多设备,按自托管文档配 HTTPS与 Passkey域名。安装、导入与教练开关细节以仓库 docs为准。

图片来源:openGym 官方仓库 assets/screenshots
有什么好处
- 数据与订阅解耦:无强制云账号、无广告与遥测宣传口径;备份 `./data` 就等于备份全部计划与训练史,Passkey私钥留在本机安全硬件。
- 计划—现场—复盘一条线:周计划、身体图热力、进阶规则与1RM/体重曲线连在一起,减少在多个商业 App之间来回导出。
- 真能带进健身房:手表、锁屏小组件、片数计算、备用动作与安静 UI,针对真实训练场景,而不是只做网页日记。
- 开源可改、可选 AI:AGPL-3.0;教练与 MCP默认关闭,密钥与批准权在你手里,适合已经自建模型网关的人。
- 迁移友好:官方支持从 Strong/Hevy/FitNotes迁入,降低「换工具就从零开始」的成本。
对注重隐私或长期力量训练记录的人,自托管 + 手机单机双模式尤其有用:出差只带手机也能记,回家再与家里的实例同步。社区有 Discord、Discussions与较密的发版节奏(约一两周一次),功能边界以 CHANGELOG与 ROADMAP为准。

图片来源:openGym 官方仓库 assets/screenshots
适合谁
适合想摆脱订阅制健身 App、又需要完整计划与现场记录的训练者;适合已有 NAS/家用服务器、希望用 Docker自托管健康数据的人;也适合从 Strong/Hevy/FitNotes迁出、需要导入与导出的用户,以及想在 Apple Watch上点组、或用自备大模型做可选 AI教练/MCP的折腾者与开发者。
若你只需要极简计次、不在乎肌群热力与进阶规则,可能显得功能偏多;若必须上 Google Play正式架(仓库写明仍在准备中)或 Wear OS(路线图后续版本),请对照当前发行说明。训练建议不能替代专业教练或医疗意见;AI教练每次改动需你确认。官网 https://opengym.ch 、演示 https://opengym.ch/demo/ 与 GitHub仓库 DuarteSantos8/openGym为权威来源,本文只做开源发现介绍,不替代官方文档。