Fast-F1 F1TV 账户认证完全指南订阅鉴权流程、CLI 工具与底层实现原理【免费下载链接】Fast-F1FastF1 is a python package for accessing and analyzing Formula 1 results, schedules, timing data and telemetry项目地址: https://gitcode.com/GitHub_Trending/fa/Fast-F1本指南围绕 Fast-F1 的 F1TV 账户认证功能展开系统讲解何时需要认证、认证的完整工作流程、命令行管理工具的使用方法以及底层基于 JWT 与本地回调服务器的实现机制。读完本文你将掌握 F1TV 订阅认证的启用、查看与清除操作并能理解 Live Timing 客户端鉴权的真实调用链。F1TV 认证的使用场景只有 Live Timing 需要Fast-F1fastf1/init.py是一款用于获取和分析 F1 成绩、赛程、计时数据与遥测数据的 Python 包。根据官方文档 accounts_auth.rst 的说明需要认证的场景使用 Live Timing 客户端:ref:livetiming实时录制比赛期间数据时需要有效的 F1TV Access / Pro / Premium 订阅无需认证的场景会话结束后的所有数据成绩、遥测、排位结果等均可直接访问认证与否不影响历史数据加载。这一设计在 v3.7.0 更新日志 中有明确交代由于 Formula 1 官方逐步淘汰了旧端点新的实时计时端点不再允许未认证访问因此 Fast-F1 在 v3.7.0 起为 Live Timing 客户端加入了订阅认证支持而对绝大多数只加载赛后数据的用户该改动没有任何影响。当 Fast-F1 遇到需要认证的功能时如果检测到你尚未完成认证它会自动弹出认证引导流程无需手动预先配置。认证工作流从检测到令牌落盘的四步流程官方文档 accounts_auth.rst 将认证过程概括为以下四个步骤检查现有有效认证令牌优先复用本地已存储的令牌避免重复登录提供登录 URL若无有效令牌则输出一个需要在浏览器中打开的 F1TV 登录链接本地存储认证令牌登录成功后令牌被保存在本地供后续请求复用后续请求自动携带令牌后续的数据请求无需再次登录。上述流程在源码 fastf1/internals/f1auth.py 的get_auth_token()函数L135-L175中有完整实现其实际执行逻辑比文档描述更细致令牌加载模块级变量_subscription_token首先在内存中查找若为空则从令牌文件读取令牌验证若令牌存在会通过_verify_jwt()向 F1 官方的 JWKS 端点https://api.formula1.com/static/jwks.json拉取公钥并校验签名验证失败InvalidTokenError/PyJWTError时自动将令牌置空并提示请重新认证触发登录令牌为空或无效时调用_run_auth_server()启动本地回调服务等待登录完成令牌落盘登录成功后将令牌写入本地文件下次直接复用。浏览器扩展是登录链路的关键一环文档特别强调Fast-F1 的登录流程依赖一个浏览器扩展来完成。具体机制如下Fast-F1 启动登录时会在本机127.0.0.1随机端口起一个 HTTP 回调服务器见 f1auth.py 的_run_auth_server()并打印形如https://f1login.fastf1.dev?portport的链接若浏览器尚未安装配套扩展打开该链接会跳转到扩展下载页面扩展安装并正常工作后会重定向到成功状态页并将登录会话loginSessioncookie通过 POST 请求回传给本地回调服务器回调服务器AuthHandler.do_POSTL48-L67解析 POST 数据中的loginSession从中提取subscriptionToken并置位线程事件通知主流程认证完成。可以直接访问f1login.fastf1.dev安装或检查扩展状态安装正常会看到成功提示否则会看到扩展下载选项。认证不支持的环境官方文档在.. note::中明确声明由于登录方式的限制托管型环境与 WebAssembly 环境不支持认证典型包括Google Colab 等托管 Jupyter 环境Jupyter Lite 等基于 WebAssembly 的环境。这是因为登录流程要求浏览器扩展与本地回调服务器协作而这两者在上述环境中均无法运行。同样livetiming.rst 也复述了该限制Live Timing 客户端在上述环境不可用。令牌的存储位置与数据结构从源码f1auth.py可以确认令牌的存储约定数据目录由platformdirs.user_data_dir(fastf1, ensure_existsTrue)决定即遵循各操作系统标准的用户数据目录规范Linux 下通常在~/.local/share/fastf1Windows 下在%LOCALAPPDATA%macOS 下在~/Library/Application Support令牌文件固定命名为f1auth.json文件在导入模块时即被创建touch文件内容就是订阅令牌字符串本身写入时直接f.write(_subscription_token)见 L172-L173。依赖清单方面pyproject.toml 中与认证相关的直接依赖包括pyjwtJWT 解析与校验、platformdirs跨平台数据目录、requests拉取 JWKS与cryptographyRSA 公钥运算。令牌验证基于 JWKS 的 RS256 签名校验Fast-F1 没有简单地把令牌当作黑盒字符串直接使用而是实现了完整的 JWT 校验链路f1auth.py获取公钥_get_jwk_from_jwks_uri()从 F1 官方 JWKS 端点拉取密钥集根据令牌头部kid字段匹配对应密钥转换公钥通过RSAAlgorithm.from_jwk(jwk)将 JWK 格式转换为可用的 RSA 公钥解码验证调用jwt.decode()以RS256算法完成签名验证与解码。该验证函数支持audience、issuer、verify、options等参数扩展。在查询状态print_auth_status时则使用verifyFalse仅解码令牌用于读取exp过期时间戳、SubscriptionStatus、SubscribedProduct等字段并判断令牌是否过期。命令行接口认证的全生命周期管理官方文档给出了认证管理的 CLI 入口python -m fastf1 auth f1tv [--authenticate] [--clear] [--status]该命令的实现位于 fastf1/main.py由argparse构建auth子命令下再细分f1tv服务三个动作参数构成互斥组add_mutually_exclusive_group不能同时使用。完整说明如下参数对应源码函数作用python -m fastf1 auth f1tv --authenticateget_auth_token()手动启动认证流程检测/验证令牌必要时触发浏览器登录python -m fastf1 auth f1tv --clearclear_auth_token()删除本地存储的认证令牌内存与磁盘文件一并清除python -m fastf1 auth f1tv --statusprint_auth_status()显示当前认证状态与令牌信息不加任何动作参数时CLI 会打印auth子命令的帮助信息。--status 的典型输出基于print_auth_status()的实现L186-L210--status的输出包含三类信息Token StatusEXPIRED或Expires 时间 (UTC)依据令牌exp字段与当前时间比较Subscription Status令牌内声明的订阅状态字段Subscribed Product订阅的产品类型Access / Pro / Premium 等。未找到令牌时输出Not authenticated。令牌无效或过期时文档与源码都建议重新执行--authenticate。手动清除令牌的适用场景--clear会删除f1auth.json并清空内存令牌。当出现以下情况时适合手动清除后重新认证订阅过期或更换了 F1TV 账号令牌被判定为无效源码在验证失败时会打印 Subscription token is invalid. Please re-authenticate.希望切换到另一个 F1TV 账户获取数据。认证在 Live Timing 客户端中的实际调用链认证令牌最终服务于 Live Timing 数据录制。在 fastf1/livetiming/client.py 的SignalRClient中可以看到完整接入点构造函数L84-L90提供no_auth: bool False参数置为True时客户端将尝试不带认证连接连接建立时L158-L184options[access_token_factory]被设置为None if self._no_auth else get_auth_token即默认情况下建立 SignalR 连接时会自动调用认证流程获取令牌若令牌缺失或失效get_auth_token()会触发上文描述的浏览器登录流程登录完成后自动继续连接。需要特别说明no_authTrue的未认证连接可能只对部分场次有效或只能返回空数据/不完整数据见 client.py L76-L78 的 docstring因此正常录制仍应使用已认证连接。从源码结构看认证是信号源访问的强制环节并非可选项。常见问题与排障建议结合文档与源码汇总实践中可能遇到的问题及应对方式浏览器打开登录链接后看不到成功页多半是浏览器扩展未安装或未启用。请检查扩展安装状态或直接访问f1login.fastf1.dev获取下载选项提示 Subscription token is invalid令牌签名校验失败执行python -m fastf1 auth f1tv --clear清除后重新--authenticate提示 Sign-in successful, but token verification failed登录成功但签名验证阶段出错对应源码 L85-L89 的PyJWTError分支建议清除令牌重试在 Colab / Jupyter Lite 中使用报错环境限制所致认证与 Live Timing 在这些平台不支持请改用本机 Python 环境如本机 Jupyter Notebook / VS Code录制中断Live Timing 客户端与认证本身无关的注意事项见 livetiming.rst——连接约 2 小时后可能被服务端断开需要手动重启录制并换用新输出文件。延伸阅读Live Timing Client 文档认证的真正消费方含SignalRClient录制与数据加载完整示例认证实现源码回调服务器、JWT 校验、令牌读写全流程CLI 入口源码auth f1tv子命令的参数解析实现v3.7.0 更新日志认证功能引入背景与 Live Timing 新端点说明项目依赖声明pyjwt、platformdirs、requests等认证相关依赖版本要求。【免费下载链接】Fast-F1FastF1 is a python package for accessing and analyzing Formula 1 results, schedules, timing data and telemetry项目地址: https://gitcode.com/GitHub_Trending/fa/Fast-F1创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考