tsubus/fitbit-steps

镜像概述

本Docker镜像用于运行与Fitbit API交互的步数管理应用，帮助用户根据工作day和周末设置不同的步数目标及活动时段（含用餐、高强度步行等），支持自定义配置和容器化部署。

核心功能

• 连接Fitbit API获取用户步数数据（需完成OAuth 2.0授权）
• 区分工作day与周末，设置不同的步数最小/最大值
• 配置用餐时段（午餐、晚餐）及时间浮动范围
• 配置工作day/周末的活动起止时间及浮动范围
• 可选配置高强度步行活动的时段及浮动范围
• 首次运行自动生成配置文件，支持后续自定义调整

使用场景

适用于Fitbit用户，用于自动化跟踪每日步数目标，或整合到个人健康管理流程中，通过自定义时段设置优化活动安排。

配置说明

应用首次运行后会在挂载的配置目录生成config.yaml文件，可调整以下关键参数：

• 通用选项: LUNCH_START（午餐开始时间）、LUNCH_END（午餐结束时间）、MEAL_VARIANCE（用餐时间浮动分钟数）
• 工作day设置: WORKDAY_STEPS_MINIMUM（工作day最小步数）、WORKDAY_START（工作day活动开始时间）
• 周末设置: WEEKEND_STEPS_MAXIMUM（周末最大步数）、WEEKEND_END（周末活动结束时间）
• 高强度活动: WORKDAY_INTENSIVE_START（工作day高强度活动开始时间）（可选配置）

Docker部署示例

创建容器

bash
docker create \
  --name=fitbit-steps \
  -e PUID=你的Linux用户ID \
  -e PGID=你的Linux组ID \
  -e TZ=Asia/Shanghai \
  -e UMASK_SET=077 \
  -e CLIENT_ID=Fitbit应用Client ID \
  -e CLIENT_SECRET=Fitbit应用Client Secret \
  -e ONETIME_CODE=首次授权临时代码 \
  -v /本地配置路径:/config \
  --restart always \
  tsubus/fitbit-steps

启动容器

bash
docker start fitbit-steps

首次运行注意事项

首次运行需提供ONETIME_CODE（从Fitbit授权流程获取的临时代码），代码有效期较短，请及时使用。