基于 Django 的开源自托管健身、饮食与体重记录工具,提供 REST API 和移动端应用。
- Star
- 13,728
- Fork
- 1,711
- 未关闭 Issue
- 220
- 最近提交
- 24小时前
这是什么?
openGym 是一款可自托管的健身记录工具。你可以按周几安排训练,也可以使用 A/B/C 轮换模式;训练时会根据上次记录自动填充重量,并在组间计时休息,同时记录体重。统计页面提供预估 1RM、显示近期训练量、恢复与未训练肌群的肌肉图、全年训练热力图和进度照片。
前端基于 React 与 Vite,由 nginx 提供服务;后端是 Node API,数据以 JSON 文件形式存放。通过一条 Docker Compose 命令即可部署,登录使用 Passkey。应用可安装为 PWA,支持离线使用,并通过基于版本号的合并机制在多设备间同步。可从 FitNotes、Strong、Hevy 和 Apple Health 导入历史数据,也能整体导出为一个 JSON 文件。
可选功能默认关闭,包括使用自有模型服务密钥生成训练计划的 AI 教练,以及供助手类应用只读查询训练记录的 MCP 服务。项目提供 Android APK,采用 AGPL-3.0 许可证。
核心功能
- 01支持按周安排训练或 A/B/C 轮换,训练时自动填充上次的重量。
- 02支持超级组、热身组、递减组、计时动作和有氧记录。
- 03提供线性、双重与三重递进等进阶规则,并显示预估 1RM 和肌群训练量。
- 04使用 Passkey 登录,多设备按用户同步,可作为 PWA 离线使用。
- 05可从 FitNotes、Strong、Hevy 和 Apple Health 导入数据,并整体导出为 JSON。
- 06通过 Docker Compose 部署,数据保存在本地 ./data 目录。
适用场景
- 在不把训练数据交给订阅服务的前提下记录个人训练日志。
- 把 FitNotes、Strong 或 Hevy 的历史记录迁移到自托管实例。
- 在家用服务器或 NAS 上为个人或家庭搭建健身记录工具。
- 在健身房使用 Android 应用或 PWA 离线记录每组训练。
快速上手
- 1
克隆仓库
git clone https://github.com/DuarteSantos8/openGym - 2
进入项目文件夹
cd openGym - 3
复制示例环境配置文件
cp .env.example .env - 4
使用 Docker Compose 启动应用,然后打开 http://localhost:8080
docker compose up -d
使用前须知
- 要在手机上使用通行密钥,需要为域名配置 HTTPS,这需要额外的设置。
- Android 版 APK 不在 Play 商店发布,iPhone 用户需要自行托管或使用 Xcode 构建。
标签
常见问题
- openGym 是什么?
- 一款可自托管的健身与体重记录工具,用于规划训练计划、记录每组数据,数据保存在自己的服务器上。 openGym 是一款可自托管的健身记录工具。你可以按周几安排训练,也可以使用 A/B/C 轮换模式;训练时会根据上次记录自动填充重量,并在组间计时休息,同时记录体重。统计页面提供预估 1RM、显示近期训练量、恢复与未训练肌群的肌肉图、全年训练热力图和进度照片。
- openGym 可以免费使用吗?用的什么许可证?
- openGym 以 AGPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
- openGym 还在维护吗?
- 活跃维护中。openGym 最近一次提交是在 2026年10月19日。
- openGym 适合用来做什么?
- 在不把训练数据交给订阅服务的前提下记录个人训练日志。 把 FitNotes、Strong 或 Hevy 的历史记录迁移到自托管实例。 在家用服务器或 NAS 上为个人或家庭搭建健身记录工具。 在健身房使用 Android 应用或 PWA 离线记录每组训练。
- openGym 怎么安装和运行?
- 克隆仓库: git clone https://github.com/DuarteSantos8/openGym 进入项目文件夹: cd openGym 复制示例环境配置文件: cp .env.example .env 使用 Docker Compose 启动应用,然后打开 http://localhost:8080: docker compose up -d
- 在哪里获取 openGym?
- 源代码和安装说明在 GitHub 上:https://github.com/DuarteSantos8/openGym
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
以全屏动态歌词动画为核心的音乐播放器,支持网易云、QQ、酷狗、Navidrome 和本地音乐库。
开源、可自托管的任务与家务管理应用,支持群组协作、周期性任务和多渠道提醒。
一款自托管的健身记录服务,可同步 Strava、Garmin Connect 活动,并导入 GPX/TCX/FIT 文件,数据保存在自己的服务器上。
开源的浏览器端设计编辑器,可制作海报、社交图文、幻灯片等,支持 Docker 自托管。
一款可自托管、兼容 Toggl API 的时间追踪工具,可与 Toggl 之间迁移数据。