tesla-fleet-api

🚗 特斯拉官方 Fleet API 车辆管家

开发榜 #30

基于 Tesla 官方 Fleet API 的完整车辆控制方案,支持远程空调预处理、充电管理、状态监控等全功能操作,通过本地签名代理确保指令安全可信。

收藏
19.3k
安装
4.4k
版本
v0.4.1
CLS 安全性认证2026-05-02
点击查看完整报告 >

使用说明

Tesla Fleet API Skill 提供了一套完整的特斯拉车辆远程控制解决方案,基于 Tesla 官方 Fleet API 构建,支持车辆数据读取与远程指令下发两大核心能力。

在核心用法方面,该技能通过 OAuth 2.0 流程完成身份认证,支持访问令牌的生命周期管理(包括刷新轮换)。用户可通过 command.py 执行丰富的车辆控制指令,涵盖空调预处理(定时启动、温度设定、座椅加热/通风)、充电管理(启停充电、设定充电限值)、车门锁控及寻车功能(鸣笛/闪灯)。对于敏感的车辆控制命令,技能集成了 Tesla 官方的 tesla-http-proxy 签名代理,通过本地 EC 私钥对指令进行加密签名,确保通信安全。同时,vehicle_data.py 支持读取电池状态、车辆位置、行驶数据、气候信息等多维度数据,并提供人类可读与原始 JSON 两种输出格式。

显著优点包括:采用官方 Fleet API,功能稳定且持续更新;本地签名架构确保私钥不出境,安全性优于纯云端方案;纯 Python 标准库实现,零第三方依赖,部署轻量;完善的输入验证机制(如充电限值 50-100% 范围检查、座位位置有效性验证)和错误处理;支持多车辆环境下的自动识别与指定操作。

潜在缺点与局限性主要体现在配置门槛较高:用户需注册 Tesla Developer 账号、申请应用凭证、注册并托管域名以完成虚拟密钥配对,还需生成并维护 EC 密钥对。此外,部分敏感操作依赖本地签名代理的持续运行,增加了运维复杂度。该技能采用单用户 OAuth 模式,不适合多用户共享场景,且访问令牌需定期刷新,长期使用需关注令牌轮换机制。

适合的目标群体包括:具备一定技术能力的特斯拉车主、智能家居自动化爱好者、车队管理开发者,以及需要通过 API 集成车辆数据到自有系统的开发者。对于无法完成域名托管或 Developer 注册的用户,该技能无法直接使用。

使用风险主要包括:私钥与 OAuth 凭证的管理风险,若泄露可能导致车辆被非法控制;配置复杂性带来的误操作风险(如错误的域名验证或证书配置);本地签名代理的单点故障风险(代理宕机将导致命令执行失败);以及网络环境要求,建议在可信网络下使用以避免中间人攻击。此外,作为个人开发者维护的项目(T3 来源),虽代码通过安全审计,但仍建议用户在使用前进行代码审查。

安全解读

核心功能

Tesla Fleet API Skill 是特斯拉官方车队API的完整封装,提供车辆远程控制、状态监控、能源管理三大核心能力。

车辆控制:支持空调启停、温度调节(驾驶员/乘客独立设置)、座椅加热/通风(9个位置分级控制)、方向盘加热、气候保持模式(爱犬/露营模式)、门锁控制、鸣笛闪灯等。

充电管理:远程启停充电、设置充电限值(50-100%范围),实时查看充电功率、已充电量、剩余时间。

预处理计划:现代化API实现定时出发预处理,支持每日/工作日/周末/自定义星期组合,以及一次性/禁用状态的灵活配置。

数据读取:可获取电池状态、室内外温度、GPS位置、行驶状态(档位/速度/功率)、门锁/车窗/里程/软件版本等完整车辆数据。

身份认证:完整OAuth 2.0流程支持,包括授权码获取、令牌刷新(自动轮换)、多区域配置(欧/美/中)、域名注册与虚拟密钥绑定。

显著优点

  • 零依赖安全架构:纯Python标准库实现,11,247行代码零第三方依赖,彻底消除供应链攻击风险
  • 官方API直连:仅连接特斯拉官方域名(fleet-api.prd.*.vn.cloud.tesla.com),无中间商或数据中转
  • 企业级安全:TLS 1.3加密通信、本地文件600权限保护、敏感配置支持环境变量注入
  • 命令签名代理:集成tesla-http-proxy实现车辆指令加密签名,满足特斯拉最新安全要求
  • 多车智能管理:自动单车辆识别,支持VIN/名称双方式指定目标车辆

潜在局限

  • 车辆离线限制:车辆休眠时需先执行wake命令唤醒,部分场景响应延迟
  • 地域依赖:需正确配置区域Base URL,中国区需独立证书链
  • 代理运维成本:命令签名代理需本地TLS证书维护,自签名证书需用户手动信任
  • 令牌手动刷新:虽支持自动刷新,但完全失效后需重新OAuth授权

适合人群

  • 特斯拉车主(Model S/3/X/Y/Cybertruck全系列)
  • 智能家居自动化爱好者(Home Assistant/Node-RED集成)
  • 车队管理运营者(多车辆批量监控)
  • 开发者(需构建特斯拉第三方应用的工程师)

常规风险提示

| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 位置隐私 | GPS坐标本地存储至places.json | 文件600权限,用户知晓后自行管理 |
| 凭证泄露 | 环境变量在多用户环境可见 | 优先使用config.json文件存储 |
| 远程误操作 | 车辆控制指令不可逆 | 建议配合车辆名称二次确认 |
| 代理私钥安全 | tesla-http-proxy TLS私钥本地存储 | 妥善保管tls-key.pem,限制读取权限 |

---

安全评级:S级(85分)| 来源可信度:T2 | 认证报告:CLS-2026-0503-TFA7

tesla-fleet-api 内容

scripts文件夹
手动下载zip · 32.6 kB
auth.pytext/plain
请选择文件