sebbo2002/fitness-first-ical-proxy Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

fitnessfirst-ical-proxy Docker镜像文档

镜像概述和主要用途

该Docker镜像是一个轻量级代理工具，专门用于从fitnessfirst.de网站获取健身课程 schedule，并将其转换为iCal（.ics）日历格式，方便用户通过日历应用（如Google Calendar、Apple Calendar、Outlook等）订阅和查看课程安排。

核心功能和特性

• 数据抓取：自动从fitnessfirst.de获取指定健身房的最新课程 schedule，确保数据时效性
• 格式转换：将原始课程数据（如课程名称、时间、地点、教练等信息）标准化为iCal（.ics）格式，兼容主流日历应用
• 订阅支持：提供HTTP端点，用户可直接通过日历应用订阅生成的iCal链接，实现课程安排自动同步
• 轻量级设计：镜像体积小巧，运行时资源占用低，适合在个人服务器、NAS或容器平台中长期部署运行

使用场景和适用范围

使用场景

• 个人用户：希望将fitnessfirst的健身课程安排整合到日常日历中，避免手动查询网站或错过课程
• 健身爱好者：通过日历应用接收课程时间提醒，结合个人日程规划锻炼安排
• 多设备同步：通过iCal订阅实现课程表在手机、电脑、平板等多设备间自动同步

适用范围

• 用户需拥有fitnessfirst.de账号（部分课程信息可能需要登录权限，具体取决于网站限制）
• 兼容所有支持iCal（.ics）订阅的日历应用，包括但不限于Google Calendar、Apple Calendar、Microsoft Outlook、Thunderbird等
• 适合个人或小型团队部署，无需复杂的服务器环境

详细使用方法和配置说明

前提条件

• 已安装Docker Engine（20.10+版本推荐）
• 了解目标健身房在fitnessfirst.de的位置ID（可从网站URL或页面源码中获取，通常为数字，如location=1234）

基本部署示例

Docker Run命令

bash
docker run -d \
  --name fitnessfirst-ical-proxy \
  -p 8080:8080 \
  -e FITNESSFIRST_LOCATION=1234 \  # 替换为实际的fitnessfirst位置ID
  -e REFRESH_INTERVAL=30 \          # 可选，数据刷新间隔（分钟），默认30
  [镜像名称]:[标签]                 # 替换为实际的Docker镜像名称和标签

参数说明

访问和订阅

1. 容器启动后，通过以下URL访问iCal日历文件：
   http://[服务器IP或域名]:[PORT]/calendar.ics
   示例：http://localhost:8080/calendar.ics

2. 打开日历应用（如Google Calendar），选择“添加订阅”或“从URL添加”，粘贴上述链接并保存。

3. 日历应用将定期同步课程数据（同步频率取决于日历应用设置，通常每1-24小时一次）。

注意事项

• 确保容器可访问互联网，以便正常从fitnessfirst.de获取数据
• 若课程数据无法获取，可能是位置ID错误或网站结构变更，建议检查位置ID或更新镜像版本
• 部分地区的fitnessfirst.de可能需要登录认证，此时需额外配置Cookie或认证信息（具体取决于镜像实现）