openGym首次启动全流程：从克隆仓库到创建第一个Passkey档案

openGym首次启动全流程从克隆仓库到创建第一个Passkey档案【免费下载链接】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的家庭健身房训练与体重记录应用制定每周计划、记录每一次组数、查看肌肉训练状态还支持从 FitNotes/Strong/Hevy 导入历史数据。全文用不到 10 分钟带你完成openGym 自托管部署克隆仓库、Docker 一键启动、打开浏览器、创建第一个Passkey 档案Face ID / 指纹登录数据完全存放在你自己的服务器上。一键启动 openGym克隆仓库并拉起 Docker 容器唯一前提是安装好 Docker 及其 Compose 插件无需 Node、无需数据库。git clone https://gitcode.com/GitHub_Trending/op/openGym cd openGym cp .env.example .env docker compose pull # 拉取预构建镜像想从源码构建可跳过此步 docker compose up -d这 5 行命令背后docker-compose.yml 编排了 3 个角色容器职责media一次性下载约 140 MB 的动作示范图片/GIF 到./media/apiNode 后端负责 Passkey 认证WebAuthn与 JSON 数据存储webnginx 托管前端并把/api代理到后端保证整个应用处于同一域名下——这是 Passkey 的硬性要求验证服务是否健康docker compose ps curl http://localhost:8080/api/health # 应返回 {ok:true,...}看到两个容器均为running、健康检查通过openGym 就已在http://localhost:8080上运行。首次启动会先下载动作媒体库稍慢属正常现象。创建你的第一个 Passkey 档案无需密码打开http://localhost:8080你会看到登录页三个入口Sign in with passkey用 Passkey 登录——已有档案时使用Create new profile创建新档案——新手点这个Continue without account游客模式数据仅存本机浏览器点击Create new profile后流程如下给档案起一个名字最长 40 字符如阿哲点击Create passkey浏览器会弹出系统生物识别窗口——在手机上就是 Face ID / Touch ID / 指纹在 Windows 上是 Windows Hello在 Mac 上是 Touch ID确认成功后立即进入应用界面提示Welcome, {你的名字}。Passkey 和传统密码的区别私钥永远只保存在你的设备安全硬件或密码管理器iCloud 钥匙串、Google 密码管理器等里服务器只存公钥见 .env.example 中RP_NAMEopenGym的提示文案。因此 openGym 默认没有密码也无法被钓鱼或撞库。如果你的实例配置了邀请码INVITE_ONLY1创建档案时还需要填入管理员发放的邀请码默认实例是开放注册的无需此步。登录后你的数据放在哪里一切都在主机的./data目录中备份时打包这一个文件夹即可详细备份说明见 docs/SELF_HOSTING.md文件内容db.json档案列表与公开 Passkey 数据state-user.json每个用户的计划、训练记录、体重与设置audit.log管理员活动日志默认开启secret会话 Cookie 签名密钥登录成功后应用会自动把本机已有的游客数据合并进新档案Profile created — data from this device moved into it。之后在手机与电脑间同步时每台设备保存时会带上自己最后看到的版本号若期间另一台设备写过数据服务器会返回冲突并让设备合并后重试——多设备互不覆盖原理图如下⚠️关于手机访问浏览器只允许在 HTTPS或localhost下使用 Passkey所以手机不能通过http://局域网IP:8080登录。想在手机上用 Passkey需要给实例配置一个 HTTPS 域名Caddy、Cloudflare Tunnel、nginx 均可文档 docs/SELF_HOSTING.md 有逐项教程临时方案是先用游客模式或在局域网设置PASSWORD_LOGIN1开启密码登录。首次启动常见问题排查速查现象解决方法8080 端口被占用在.env中改为WEB_PORT9090同步更新ORIGIN手机上看不到 Passkey 弹窗你访问的是http://或 IP 地址请配置 HTTPS 域名登录报 verification failedRP_ID/ORIGIN与地址栏 URL 不匹配见下表动作图片/GIF 没下载docker compose logs media查看重跑docker compose up -d修改.env不生效docker compose restart不会重读.env请用docker compose up -dRP_ID与ORIGIN的格式是新手最常踩的坑变量正确写法错误写法RP_IDgym.example.com纯主机名https://gym.example.com、带端口、带斜杠ORIGINhttps://gym.example.com带协议裸域名、带末尾斜杠本地体验localhost保持 .env.example 的默认值即可RP_IDlocalhost、ORIGINhttp://localhost:8080。更多问题可查阅 docs/FAQ.md完整的部署、多用户、通知与更新指南见 docs/SELF_HOSTING.md。总结至此你已经走完openGym 首次启动的完整闭环克隆仓库 →docker compose up -d一键拉起 → 浏览器创建 Passkey 档案 → 数据落地./data。接下来可以试试从 FitNotes/Strong/Hevy 导入历史数据docs/DATA_IMPORTS.md、加载 Push/Pull/Legs 等四个模板计划或把应用添加到主屏幕变成类原生体验docs/MOBILE.md。你的训练你的数据你的服务器。️【免费下载链接】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），仅供参考