openGym家庭健身房方案完整指南：用自有器械过滤训练动作-平芜编程栈

openGym家庭健身房方案完整指南：用自有器械过滤训练动作

【免费下载链接】openGymSelf-hosted gym & body-weight tracker — plan routines, log workouts (supersets, warm-ups, cardio), see which muscles are trained, fatigued or detrained, import from FitNotes/Strong/Hevy, passkey login. Your data, your server.项目地址: https://gitcode.com/GitHub_Trending/op/openGym

openGym 是一款自托管的健身房与体重训练记录工具，适合家庭健身房用户：规划每周训练、记录每组动作（超级组、热身、有氧）、查看肌肉训练/疲劳/恢复状态，并支持 FitNotes、Strong、Hevy 数据导入与 passkey 登录。其中最贴心的一个设计，就是用你自有器械过滤训练动作——库里 1,324 个动作，只显示你家里真的能做的。数据在你自己的服务器上，无订阅、无广告、无遥测。

家庭健身房为什么需要"器械过滤"

家庭健身房最常见的尴尬是：跟着 App 排好的计划，打开动作库却发现——"杠铃划船要卧推架，我家没有"。

openGym 的做法是把"你有啥器械"当成一个**设备档案（equipment profile）**来管理，整个过滤逻辑非常轻：

关闭过滤（默认）或没有选中档案时，所有动作全部可见——过滤是纯增量能力，永远不会把你的动作库藏空；
体重类动作（俯卧撑、引体向上等）永远可用，任何档案都不会把它过滤掉，见 equipment.js 中的说明；
档案只是本地/同步的普通数据，不需要服务端做任何改动。

一键创建"家庭健身房"器械档案

🏠 操作步骤非常简单：

打开设置（Settings），找到"按器械过滤"（Filter by equipment）；
点"添加器械档案"，起个名字，比如"家庭健身房"；
按使用频次排序勾选你拥有的器械：哑铃、壶铃、弹力带、引体向上杆、杠铃……

这个面板在 Settings.jsx 中实现，档案数量与已选器械类型会实时显示在每一行上，还可以创建多个档案——比如"家"和"健身房"各一份，随时切换。

动作库只显示你家能练的动作

在动作库（Library）页面，选中档案后会看到顶部提示"显示家庭健身房里有的动作"，并配一个"显示全部器械"的开关，临时想看看其他动作时不会走死胡同（见 Library.jsx）。

按部位浏览时，器械过滤会自动保留，所以"胸 + 你家的器械"组合搜索永远不会返回空结果。

💡 多设备使用也没问题：手机记一组、平板看计划，两端数据合并而不是互相覆盖，同步细节可参考 sync 架构说明与 MOBILE.md。

排计划时自动体检：哪些动作"超纲"了

编辑训练计划时，openGym 会自动统计：这条计划里有多少动作超出了你当前档案的器械范围，并在每个缺器械的动作上给出明显标记（见 RoutineEdit.jsx 中的 missingCount 逻辑）。这样你在把"健身房计划"改造为"家庭版"时，一眼就能看到还差哪几项要替换。

家庭训练的其他加分项

🏋️ 面向家庭场景，openGym 还有几个实用细节：

徒手动作懂"没有负重"：记录次数即可，想加负重再挂上深蹲腰带数据；
杠铃片计算基于你拥有的杠铃片推算，而不是默认健身房配置；
渐进规则（线性、Greyskull、双重渐进）按例行或按动作配置，卡住会自动触发减载周；
肌肉地图三种模式：容量去哪了、哪里还在恢复、哪块肌肉已经"掉级"（detrain）；
体重曲线对照目标线，体重是家庭健身房最该盯的指标；
可选AI 教练：默认关闭，开启后用你自己的 provider key 运行在你的服务器上，每条修改都要你批准，详见 AI_COACH.md。

快速自部署：一条命令跑起来

部署只需要 Docker（含 Compose）。官方文档给出了完整的 HTTPS 与多用户配置，推荐按 SELF_HOSTING.md 操作；部署后执行docker compose up即可启动，数据存放在实例旁的./data文件夹，备份这一份文件夹就备份了一切。常见疑问（成本、数据归属、多人共用一个实例等）都可以在 FAQ.md 中快速查到。