openGym:把训练计划、锻炼记录和身体数据留在自己的服务器
一分钟看懂
openGym 是一款可自托管的健身与体重记录应用。它把训练计划、动作记录、热身、有氧、超级组和身体指标放在一个界面中,并通过肌肉图展示近期训练与疲劳状态。数据默认保存在自己的服务器上,而不是依赖订阅式云服务。
你可以用它做什么
- 编排训练计划并在锻炼时逐组记录重量、次数和完成情况。
- 组合超级组、热身和有氧项目,查看训练涉及的肌群。
- 从 FitNotes、Strong 或 Hevy 导入既有记录。
- 记录体重等身体数据,并在多种语言界面中查看历史。
- 通过可选的 AI 教练或只读本地 MCP,让兼容工具分析自己的训练记录。
主要能力
- 提供自托管网页应用、Android 安装包以及可作为 PWA 使用的移动界面。
- 支持通行密钥登录;手机端使用时通常需要 HTTPS 和可访问域名。
- 数据以 JSON 形式保存在挂载的数据目录中,方便备份和迁移。
- 默认不调用大模型;启用 AI 教练时由用户提供对应服务商密钥。
- 不包含广告、订阅和遥测,核心数据处理由自托管实例完成。
适合哪些人
适合希望掌控健身数据、愿意维护 Docker 服务的个人、家庭或小型训练群体,也适合想把多款健身应用记录迁到统一系统的用户。没有服务器维护经验、希望由供应商全托管的人需要评估部署成本。
怎么开始使用
官方推荐使用 Docker Compose:克隆仓库、复制环境变量示例,再拉取并启动容器;默认可通过服务器的 8080 端口访问。正式使用前应设置 HTTPS、域名和认证配置,并定期备份 ./data 目录。需要 AI 教练时,再单独配置自己的模型服务密钥。
使用前需要知道
通行密钥在手机和跨设备场景通常依赖正确的 HTTPS 与域名配置。可选 AI 功能会把相应请求发送给用户选择的模型服务商,隐私与费用取决于该服务商。项目采用 AGPLv3;如果修改后通过网络向他人提供服务,需要按许可证要求提供对应源代码。项目也说明部分动作媒体的权利存在争议,媒体不随仓库分发,而是在首次启动时下载。