iainbullock/tesla_http_proxy

Tesla HTTP Proxy Docker 镜像文档

镜像概述和主要用途

Tesla HTTP Proxy Docker镜像是基于llamafilm/tesla-http-proxy-addon项目的独立Docker实现，提供特斯拉官方HTTP Proxy服务，支持现代特斯拉车辆的Fleet API请求。该镜像通过Flask Web服务器处理初始授权流程并存储刷新令牌，完成后启动Go编写的Proxy服务。适用于Home Assistant Docker版等不支持Add-Ons的环境，可与alandtse/tesla自定义集成配合，实现特斯拉车辆的远程控制与状态监控。

核心功能和特性

• 授权流程管理：处理特斯拉OAuth授权流程，生成并存储访问令牌及刷新令牌
• 密钥对生成：自动创建特斯拉车辆命令所需的公钥/私钥对，并完成车辆端安装
• Proxy服务运行：部署特斯拉官方HTTP Proxy（Go语言实现），转发Fleet API请求
• 灵活配置：支持通过config.sh文件覆盖环境变量配置，适应不同网络环境
• Home Assistant集成：无缝对接Home Assistant自定义集成，支持车队API代理模式

使用场景和适用范围

• Home Assistant Docker版用户需要集成特斯拉车辆控制功能
• 需通过Fleet API与特斯拉车辆进行通信的智能家居场景
• 绕过Home Assistant Add-Ons限制，采用独立容器部署的用户
• 需要稳定管理特斯拉API授权令牌及车辆密钥的场景

详细使用方法和配置说明

前提条件

• 已配置支持SSL的Web服务器（如Nginx），确保公网可访问的FQDN
• 特斯拉账户及开发者账户
• Docker和Docker Compose环境
• Home Assistant已安装HACS（用于添加自定义集成）

安装与部署步骤

1. 环境准备

• Web服务器配置：确保FQDN可解析并接收SSL连接，公钥文件（com.tesla.3p.public-key.pem）需通过互联网访问
• 目录创建：在Home Assistant的/config目录下创建tesla_http_proxy文件夹：

  bash
  mkdir -p /config/tesla_http_proxy
  

2. 获取Docker镜像

可通过以下两种方式获取：

• Docker Hub拉取（推荐）：

  bash
  docker pull iainbullock/tesla_http_proxy
  

• 源码构建：

  bash
  git clone https://github.com/iainbullock/tesla-http-proxy-docker.git
  cd tesla-http-proxy-docker
  docker build -t iainbullock/tesla_http_proxy .
  

3. Docker Compose配置

创建docker-compose.yml文件，根据实际环境调整参数：

yaml
version: '3'
services:
  tesla_http_proxy:
    image: iainbullock/tesla_http_proxy
    volumes:
      - ./data:/data  # 存储配置、令牌和密钥
      - /config/tesla_http_proxy:/config/tesla_http_proxy  # 与HA共享证书
    ports:
      - "4430:4430"  # 代理服务端口
    environment:
      - PROXY_HOST=your.hostname  # 主机名，需在HA和容器中解析
      - PROXY_PORT=4430
      - FQDN=your.public.fqdn  # 公网可访问的域名
    restart: no  # 首次配置时设为no，完成后改为unless-stopped

4. 初始化配置

• 启动容器初始化：

  bash
  docker-compose up -d
  

  首次运行将初始化文件并退出，需修改配置后重启

• 编辑配置文件： 编辑宿主机/data/config.sh（/data为挂载卷），设置关键参数：

  bash
  # 示例配置
  PROXY_HOST="macmini.home"       # 不可为IP，需在HA和容器中解析
  PROXY_PORT=4430
  FQDN="tesla.example.com"        # 公网FQDN
  OPTIONS_COMPLETE=1              # 设为1表示配置完成
  

5. 完成授权与密钥配置

• 重启容器：

  bash
  docker-compose restart
  

  容器将启动Flask服务处理授权流程

• 浏览器配置步骤： 在浏览器中访问FQDN，进入"Tesla HTTP Proxy setup"页面，按以下顺序操作：

  1. 生成OAuth令牌：点击"1. Generate OAuth token"，登录特斯拉账户并授权，完成后显示"Authorization complete"

  2. 测试公钥端点：点击"2. Test public key endpoint"，下载公钥文件，确保Web服务器可通过公网访问此文件（路径：com.tesla.3p.public-key.pem）

  3. 注册合作伙伴账户：点击"3. Register Partner account"，生成合作伙伴令牌，通过日志确认成功（示例日志：[16:14:02] main:INFO: Generating Partner Authentication Token ）

  4. 车辆密钥安装：点击"4. Enrol private key into your vehicle"，扫描QR码并在特斯拉App中批准，完成密钥安装

  5. 点击"Shutdown Flask Server"关闭Flask，Proxy服务将继续运行

• 设置自动重启：确认Proxy运行正常后，修改docker-compose.yml中restart: unless-stopped，执行docker-compose up -d应用更改

Home Assistant自定义集成配置

1. 安装集成

通过HACS添加alandtse/tesla自定义集成，启动配置流程。

2. 配置集成参数

• 在配置对话框中选择"Use Fleet API Proxy"
• 输入特斯拉开发者账户***
• 从/data/refresh_token文件获取刷新令牌并输入（注意：刷新令牌单次有效，过期需重新生成）
• 输入Proxy URL（格式：https://your.hostname:4430，不可为IP）
• 输入SSL证书路径：/config/tesla_http_proxy/selfsigned.pem

3. 验证与测试

• 配置成功后将显示车辆名称，点击"Finish"完成集成
• 测试控制功能（如解锁车门、开启空调），若失败检查：
  • 刷新令牌是否过期
  • 公钥文件是否可被特斯拉访问
  • Proxy URL主机名解析是否正常

故障排除

• 刷新令牌过期：重新执行OAuth授权流程生成新令牌
• SSL证书错误：确保使用主机名而非IP，且主机名在HA和Proxy容器中均可解析
• 公钥访问失败：检查Web服务器配置，确保公钥文件可通过FQDN访问
• 容器启动失败：检查/data/config.sh中OPTIONS_COMPLETE是否设为1，配置参数是否正确