ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

openGym的3种使用方式详解:浏览器演示、Android APK与自托管实例完整选型指南

openGym的3种使用方式详解:浏览器演示、Android APK与自托管实例完整选型指南 openGym的3种使用方式详解浏览器演示、Android APK与自托管实例完整选型指南【免费下载链接】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/openGymopenGym 是一款自托管健身房与体重追踪器self-hosted gym body-weight tracker开源项目规划训练计划、记录每一次组数与体重、查看哪些肌肉被练到、疲劳或退化数据完全归你所有。openGym 提供 3 种使用方式——浏览器演示、Android 独立 APK、自托管实例三者的上手成本、数据存储位置和多设备同步能力差异很大。本文带你快速看懂区别并选出最适合自己的方式。openGym 三种使用方式一键对比 浏览器演示 独立 APK 自托管实例上手时间0 分钟约 5 分钟约 10 分钟是否需要账号否否本地模式是Passkey 登录数据存在哪示例数据/当前浏览器手机本地文件你服务器上的./data文件夹多设备同步❌可选可连接自己的服务器✅ 自动同步 冲突合并提醒方式浏览器通知原生系统通知Web Push适合谁先试用、看看功能单台手机离线使用长期使用、想要真正拥有数据方式一浏览器演示——零安装先试用 openGymopenGym 的在线演示就是完整的真实应用加载了示例数据不是阉割版1324 个带动画演示的动作库、按肌肉群浏览的人体图、引导式训练、组间休息计时、PR 检测……全部可以点着玩。怎么开始访问 openGym 官网进入在线演示页面无需注册、无需下载直接体验一周训练计划的排布和记录流程如果不喜欢演示数据也可以用游客模式继续数据只保存在你当前的浏览器里局限性演示里的数据是别人的示例数据你练得再多也不会同步到任何设备游客模式数据也只存在那一个浏览器中换台电脑就看不到了。所以它最适合作为试驾环节而不是长期使用方案。方式二Android 独立 APK——无账号、数据留在手机上如果你只用一台安卓手机又想要一个原生 App 的体验可以侧载官方签名 APK故意不上 Play Store没有商店账号、没有审核规则、没有年费挡在开源应用和用户之间。每个构建版本都附带.sha256校验文件App 还会自动检查更新。本地模式的特点 无登录界面、无同步、无遥测——手机本身就是账号 数据存为 App 私有目录下的opengym-state.json每次修改都会落盘这是对 iOS WebView 存储可能被系统清空的防护Android 同样适用 用原生本地通知做训练提醒组间休息倒计时直接显示在通知栏全程不需要后端 备份通过系统分享面板导出而不是浏览器下载进阶APK 也能连你自己的服务器。这不是另一个版本而是同一个 App 的一种模式。因为 App 内的 WebView 域名和真实服务器不匹配无法使用 Passkey所以它用配对码方式连接在已登录的浏览器里打开 设置 → Pair the mobile app 生成一次性配对码5 分钟有效在 App 里输入服务器地址和配对码即可完成。配对你的服务器后手机离线时改动也会暂存本地网络恢复后自动补传。 完整的手机端行为说明连接状态、离线策略、备份文件位置等见 docs/MOBILE.md。⚠️ iPhone 用户注意Apple 不允许 App Store 之外的安装方式建议自托管后从 Safari 把 PWA 加到主屏幕或用 Xcode 把原生 App 构建到自己的设备上。方式三自托管实例——你的数据你的服务器这是 openGym 的默认形态也是最能体现Your data, your server理念的方式两个小容器web api加一个数据文件夹一次docker compose up就跑起来。自托管实例 5 分钟部署步骤前提装好 Docker 与 Compose 插件。git clone https://gitcode.com/GitHub_Trending/op/openGym cd openGym cp .env.example .env docker compose pull # 拉取预构建镜像amd64 arm64 docker compose up -d打开http://localhost:8080点Create profile用 PasskeyFace ID / 指纹 / 密码管理器创建档案即可。首次启动会下载约 140 MB 的动作图片/GIF 素材之后无需再下。架构上很简单frontend/是 React Vite 构建的静态界面api/是几乎零依赖的纯node:http服务web/容器用 nginx 统一提供服务并代理/api保证整个应用跑在同一个源上——这是 Passkey 的硬性要求。数据全部以 JSON 形式存放在主机的./data目录下备份这个文件夹就等于备份了全部。HTTP API 规范见 api/openapi.yaml编排文件见 docker-compose.yml。Passkey 登录的关键前提HTTPS浏览器规定 Passkey 只能走 HTTPSlocalhost除外。所以本机访问http://localhost:8080完全可用手机通过http://局域网IP:8080访问❌ 无法弹出 Passkey想让手机正常使用自托管实例需要一个真实的 HTTPS 域名在.env里改两行即可RP_IDgym.example.com ORIGINhttps://gym.example.com反向代理选 Cloudflare Tunnel不开放端口、Caddy自动签发证书、Traefik 或 nginx 均可。完整步骤、多用户管理、活动日志、备份与通知配置都写在 docs/SELF_HOSTING.md局域网内不出公网的 HTTPS 方案见 docs/SELF_HOSTING_HTTPS.md跑在 Kubernetes 里见 docs/SELF_HOSTING_KUBERNETES.md。多设备同步怎么保证不丢数据每个档案的数据是带版本号revision的单一文档。设备保存时会带上它上次看到的版本号如果期间另一台设备写过服务器返回 409 冲突并附上最新文档设备合并本地改动后重试——两台设备同时编辑是合并而不是互相覆盖。未上传的改动在断网、登出时都不会被丢弃App 会显示离线横幅恢复连接后自动补传。三种 openGym 使用方式怎么选只是好奇、想先看看→ 浏览器演示0 成本体验全部核心功能只有一台安卓手机想要离线原生 App→ 侧载独立 APK无账号、数据不出手机原生通知提醒休息多设备同步、家人共用、想真正拥有自己的训练数据→ 自托管实例Docker 一键部署Passkey 登录备份只需拷一个文件夹推荐组合路径先浏览器演示熟悉界面 →docker compose up搭自己的实例 → 再在 APK 里配对到同一服务器手机和电脑数据自动同步一步都不浪费常见问题导入 FitNotes/Strong/Hevy 历史数据、多用户邀请、通知设置等可以先查 docs/FAQ.md训练逻辑源码在 frontend/src/lib/ 下纯函数配单元测试欢迎围观。总结openGym 的三种使用方式覆盖了从试试到长期拥有的完整光谱浏览器演示零门槛、Android APK 单机独立、自托管实例数据主权。三者共用同一套代码功能完全一致你可以从任意一种起步随时平滑升级到更适合自己的那一档——数据始终在你自己的手里。【免费下载链接】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创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表