openGym启动后30秒自检：docker compose ps与/api/health健康检查完整指南

openGym启动后30秒自检docker compose ps与/api/health健康检查完整指南【免费下载链接】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刚部署完 openGym 自托管健身与体重追踪服务怎么确认它真的活了别急着打开浏览器——花 30 秒执行两条命令docker compose ps看容器状态/api/health健康检查接口看 API 是否真正响应。这篇教程带你快速完成 openGym 部署后的健康检查避开新手最常踩的几个坑。为什么要先做健康检查openGym 是一个开源的自托管self-hosted健身记录应用计划训练动作、记录超组/热身/有氧、查看肌肉疲劳度还支持从 FitNotes / Strong / Hevy 导入数据。它由两个核心容器加一个数据目录组成见 docs/SELF_HOSTING.md容器作用启动后状态media一次性下载 ~140 MB 的动作图片/GIF下载完成后正常退出Exited 0apiNode 编写的后端 API、通配密钥登录Up持续运行webnginx 托管前端并反代/api→apiUp持续运行⚠️ 新手常见误会看到media显示Exited (0)以为出错了。其实它是干完活就下班的一次性任务退出码 0 代表成功。三个服务如何协作可以参考项目自带的部署架构图docker compose ps30 秒看懂容器状态在项目根目录执行docker compose ps理想的输出长这样NAME STATUS opengym-api-1 Up opengym-media-1 Exited (0) opengym-web-1 Up核对清单对应 docker-compose.yml 中的三个服务定义api与web都是Up—— 核心服务在线。media是Exited (0)—— 图片素材下载任务已成功结束。若web反复出现Restarting多半是端口冲突默认对外端口是8080WEB_PORT见 docker-compose.yml改一个不冲突的即可。首次启动media会下载约 140 MB 素材web需等它完成才启动docker-compose.yml 中配置了service_completed_successfully依赖所以第一次up慢一点是正常的。/api/health确认 API 真的在响应容器Up只代表进程活着不代表 API 能正确应答。打开终端执行健康检查curl http://localhost:8080/api/health健康时的返回端口被改过就换成你的WEB_PORT{ok:true,users:1}ok: true—— 服务器正常运行这就是健康检查的金标准。users—— 当前实例上的注册账号数。刚部署完是0创建第一个账户后变为1。这个接口的定义在 api/openapi.yaml实现只有一行、始终公开无需登录见 api/server.js。为什么值得查它走的是完整链路你的请求 → webnginx→ 反代 → api。如果 curl 失败但docker compose ps一切正常问题多半出在反代转发或端口映射上而不是 API 本身。服务正常后手机、笔记本与服务器之间的数据同步就会按这套协议进行含冲突合并时序如下检查不通过按这个顺序排查现象可能原因处理curl 连接被拒绝web 未就绪 / 端口不对docker compose logs -f web查看 nginx 启动日志api反复重启.env配置错误确认执行过cp .env.example .env页面能打开但图片缺失media下载未完成等media出现Exited (0)后再刷新完全不知道错在哪通用手段docker compose logs -f实时跟踪日志详细排查思路可查阅 docs/SELF_HOSTING.md 的 Troubleshooting 章节。把健康检查变成习惯部署完成后建议养成两个小习惯重启/更新后先查健康升级镜像执行docker compose pull docker compose up -d后同样跑一遍docker compose pscurl /api/health两秒确认无损。定期备份./data/健康检查证明服务在线但数据在./data/目录用户、通配密钥、训练记录官方建议打包备份tar czf opengym-backup-$(date %F).tar.gz data/详见 docs/SELF_HOSTING.md 的 Backups 章节。总结成一句话docker compose ps看容器/api/health看接口{ok:true}到手30 秒自检完成️【免费下载链接】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），仅供参考