W

wger

6.0k stars·隐私保护·已提供 SHA-256 校验码,下载后可自行核对文件完整性

免费开源的运动与健身管理器,支持自托管、自定义训练计划、饮食记录和进度跟踪。

智能下载

前往项目主页

该项目暂未提供安装包,请直接访问源代码仓库

自己掌控数据的全能健身管家

核心功能

  • 自定义训练计划:自由组合动作,支持自动重量递增规则
  • 饮食与营养跟踪:通过Open Food Facts数据库记录热量和营养
  • 进度照片墙:拍照对比身材变化,记录成长
  • 内置动作百科:图文详解数百个健身动作,社区持续贡献
  • 跨平台应用:提供Android/iOS/桌面版(Flutter),支持F-Droid和Flathub

避坑指南

  • •自托管部署需要基础Linux/Docker知识;建议定期备份数据库和媒体文件;使用Open Food Facts API时注意请求频率限制;首次加载可能需要下载大量数据(如图片);移动端App需要连接自托管实例或使用官方wger.de服务(需联网)。

适用场景

  • 个人健身爱好者:无广告、无追踪,自由记录训练和饮食
  • 私人教练:为学员制定计划,查看进度照片和数据
  • 小型健身房:自托管管理会员训练记录和体重变化

详细介绍

wger(发音ˈvɛɡɐ)是一款免费开源的健身与运动管理工具。你可以创建自定义训练计划(支持自动加重进阶)、跟踪饮食方案和身体数据、通过Open Food Facts数据库记录热量,并上传进度照片。内置动作库百科、多用户支持和基础的健身房管理功能。支持通过Docker自托管,拥有官方Android和iOS客户端,社区贡献了多语言翻译。强大的REST API方便第三方集成和自动化。遵循AGPL-3.0开源许可。

常见问题与排障 (1)

故障排除
为什么 wger API 会忽略 /api/v2/exercise/ 上的 ?name= 或 ?term= 过滤参数,并返回完整的运动动作目录?

这是 Django REST Framework / django-filter 的默认行为:未知的查询参数会被静默忽略而非被拒绝,因此像 ?name= 或 ?term= 这样不受支持的过滤条件会返回整个未过滤的列表(而且第一个结果会误导性地始终是同一个动作)。要按名称搜索动作,请使用受支持的参数:GET /api/v2/exerciseinfo/?name__search=leg%20press&language__code=en。请注意,旧的 /api/v2/exercise/search/ 端点已在 wger 2.5 中移除(参见 2.5 版本发布说明),现在会返回 404。如果你要集成 LLM 代理或脚本,请将其指向官方的 wger MCP 服务器(github.com/wger-project/mcp-server),或使用 Python API 客户端(github.com/wger-project/api-client),该客户端由 OpenAPI 规范生成,会针对白名单校验参数,使不受支持的过滤条件直接报错而不是被忽略。

来源 Issue #2538

标签

fitnessworkoutnutritionself-hostedopen-sourceREST APIcross-platform

快速上手

1

下载安装包

点击上方按钮下载对应系统的安装包

2

安装软件

双击下载的安装程序,按提示完成安装

3

步骤1:确保安装Docker和Docker Compose

4

步骤2:下载官方docker-compose.yml文件(https://github.com/wger-project/docker)

5

步骤3:在终端运行 docker compose up -d

安装指引
  1. 步骤1:确保安装Docker和Docker Compose
  2. 步骤2:下载官方docker-compose.yml文件(https://github.com/wger-project/docker)
  3. 步骤3:在终端运行 docker compose up -d
文件完整性

暂未获取到校验码

该项目暂未在 GitHub Release 页面提供 SHA-256 校验码

SHA256 校验码

暂无校验码

建议从 GitHub Releases 页面直接下载,并自行核对文件完整性

本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件,未做任何修改。你可以通过 GitHub Releases 页面自行验证。

运维指引

卸载说明

停止容器并删除数据:在docker-compose.yml所在目录运行 docker compose down -v,然后删除相关文件夹即可。如果通过官方实例使用,无需卸载,直接删除账号或不再访问即可。

无额外依赖

下载后即可直接使用,无需安装其他运行环境

项目信息
开源协议AGPL-3.0
最后更新2026-10-21 00:47:27
GitHub 仓库官方网站

遇到问题?查看下方 FAQ

1 FAQ

相似推荐