Repolode
DuarteSantos8

DuarteSantos8/openGym

一款可自托管的健身与体重记录工具,用于规划训练计划、记录每组数据,数据保存在自己的服务器上。

可替代:StrongHevyFitNotes

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. 1

    克隆仓库

    git clone https://github.com/DuarteSantos8/openGym
  2. 2

    进入项目文件夹

    cd openGym
  3. 3

    复制示例环境配置文件

    cp .env.example .env
  4. 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 数据每日更新。

相关项目