热门搜索:
iainbullock/tesla_ble_mqtt
iainbullock
通过蓝牙低能耗(BLE)经由MQTT向特斯拉汽车发送命令并读取状态，绕过Fleet API限制，无需依赖API，支持定期获取车辆状态信息，可部署在Home Assistant或独立设备（如树莓派）上。
3 次收藏下载次数: 0状态：社区镜像维护者：iainbullock仓库类型：镜像最近更新：9 个月前
让 AI 帮你使用轩辕镜像？ · 展开查看说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Tesla BLE MQTT Docker 镜像文档
镜像概述和主要用途
Tesla BLE MQTT Docker镜像通过蓝牙低能耗(BLE)技术，实现经由MQTT协议与特斯拉汽车通信，支持发送命令和读取车辆状态。该镜像v0.5.0版本提升了蓝牙稳定性，支持定期获取车辆状态信息（传感器及其他实体），当车辆在家时无需依赖Fleet API。可部署在Home Assistant(HA)系统或独立设备（如树莓派）上，建议设备放置在靠近停车位置处。
核心功能和特性
- BLE通信：基于
teslamotors/vehicle-command项目实现蓝牙通信，绕过Fleet API速率限制，不依赖官方API - MQTT集成：通过MQTT协议实现命令发送与状态读取，支持Home Assistant自动发现实体
- 自动轮询：v0.4.3及以上版本支持自动轮询车辆状态，可通过开关控制轮询启用/禁用，通过间隔参数设置轮询频率（30-3600秒，需为30的倍数）
- 状态类别排除：可通过环境变量
NO_POLL_SECTIONS排除特定状态类别（如charge、climate等），加快轮询速度 - 强制更新按钮：提供多种强制更新按钮，包括"强制更新全部"、分类别强制更新及"强制更新环境"（尊重
NO_POLL_SECTIONS配置） - 状态更新控制：通过
IMMEDIATE_UPDATE环境变量控制命令发送后状态主题是否立即更新 - 配置持久化：轮询开关和间隔设置存储在MQTT服务器（带保留标志），容器更新后仍可保留
使用场景和适用范围
适用设备
- Home Assistant系统
- 独立设备（如树莓派3及以上，需内置蓝牙功能）
硬件要求
- 蓝牙通信可靠性取决于硬件类型和与车辆的距离
- 推荐硬件：树莓派3及以上（内置蓝牙）
- 最大推荐距离：3米（车辆与设备间需视线清晰）
前提条件
- 已安装MQTT broker（可在Home Assistant中或独立部署）
- 若Home Assistant已使用MQTT集成，相关实体将被自动发现
详细使用方法和配置说明
运行选项
1. Tesla BLE MQTT Docker容器
可部署在任意设备上，安装说明参见https://github.com/tesla-local-control/tesla_ble_mqtt_docker/blob/main/INSTALL.md
2. Tesla Local Control Add-on
Home Assistant插件，需安装在HA实例上，相关仓库：https://github.com/tesla-local-control/tesla-local-control-addon
环境变量配置
| 环境变量 | 说明 | 默认值 |
|---|---|---|
NO_POLL_SECTIONS | 空格分隔的状态类别列表，指定需排除的轮询类别（可选值：charge, climate, tire-pressure, closures, drive） | 无 |
IMMEDIATE_UPDATE | 命令发送后是否立即更新状态主题 | true |
轮询配置
- 轮询开关：启用/禁用指定车辆的轮询功能
- 轮询间隔：设置轮询频率（秒），范围30-3600，必须为30的倍数，推荐最小值660秒（防止过度耗电）
注意：轮询仅在车辆唤醒时执行，不会主动唤醒车辆；若轮询间隔≥660秒，车辆可能在下次轮询前进入睡眠状态
强制更新按钮
- Force Update All：唤醒车辆并更新所有实体
- 分类强制更新按钮：唤醒车辆并更新特定类别实体（如charge、climate等）
- Force Update Env：唤醒车辆并更新实体，尊重
NO_POLL_SECTIONS配置
首次安装配置
- 设置轮询开关和轮询间隔实体
- 根据需求配置
NO_POLL_SECTIONS和IMMEDIATE_UPDATE环境变量 - 配置将存储在MQTT服务器，容器更新后自动保留
更新和开发版本
更新至新版本或使用开发版本的说明参见https://github.com/tesla-local-control/tesla_ble_mqtt_docker/blob/main/UPDATING.md
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 tesla_ble_mqtt 镜像标签
docker pull docker.xuanyuan.run/iainbullock/tesla_ble_mqtt:<标签>
DockerHub 原生拉取命令
docker pull iainbullock/tesla_ble_mqtt:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"