thisisarpanghosh/fitbit-report-app

Fitbit健康报告生成器 Docker镜像

镜像概述

本Docker镜像旨在帮助Fitbit用户无需订阅高级会员，通过用户访问令牌（User Access Token）授权，生成包含活动、睡眠、心率等健康数据的详细报告。镜像简化了健康数据获取流程，让普通用户也能便捷获取并导出健康分析报告。

核心功能

• 无需高级订阅：无需开通Fitbit Premium，即可生成健康报告
• 用户访问令牌授权：通过Fitbit用户访问令牌安全获取数据，无需共享账号密码
• 多维度健康数据：支持生成活动（步数、卡路里消耗）、睡眠（睡眠时长、睡眠阶段）、心率（静息心率、心率区间）等多维度报告
• 灵活报告导出：支持导出PDF、CSV、JSON等多种格式，便于数据存档和分析

使用场景

• 普通Fitbit用户：无需订阅高级会员，获取详细健康数据报告
• 健康管理爱好者：定期生成健康报告，跟踪长期健康趋势
• 个人健康记录需求者：导出标准化健康数据，整合至个人健康档案

使用方法

Docker 运行命令

通过以下命令快速启动容器，生成健康报告：

bash
docker run -d \
  --name fitbit-report-generator \
  -e USER_ACCESS_TOKEN="your_fitbit_user_access_token" \
  -e REPORT_TYPE="activity,sleep" \
  -e TIME_RANGE="7d" \
  -e EXPORT_FORMAT="pdf" \
  -v /local/path/to/save/reports:/app/reports \
  fitbit-report-generator:latest

Docker Compose 配置

创建docker-compose.yml文件，配置如下：

yaml
version: '3'
services:
  fitbit-report:
    image: fitbit-report-generator:latest
    container_name: fitbit-report-generator
    environment:
      - USER_ACCESS_TOKEN=your_fitbit_user_access_token
      - REPORT_TYPE=activity,sleep,heart_rate
      - TIME_RANGE=30d
      - EXPORT_FORMAT=csv
    volumes:
      - ./reports:/app/reports
    restart: on-failure

启动容器：docker-compose up -d

配置说明

环境变量

注意事项

• 用户访问令牌获取：需通过Fitbit开发者平台（dev.fitbit.com）创建应用，获取用户访问令牌（需用户授权）
• 令牌有效期：Fitbit用户访问令牌通常有效期为8小时，长期使用需定期更新令牌
• 数据范围限制：受Fitbit API限制，单次报告时间范围建议不超过30天，避免请求失败

报告内容

生成的健康报告通常包含以下数据（具体取决于REPORT_TYPE配置）：

• 活动报告：每日步数、活动时长、卡路里消耗、活跃时间分布
• 睡眠报告：睡眠总时长、深度睡眠/浅度睡眠/REM睡眠占比、入睡/醒来时间
• 心率报告：静息心率、平均心率、心率区间分布（脂肪燃烧/有氧/极限）