Volkswagen Connect 手动安装与避坑指南:不用HACS也能远程控车
Volkswagen Connect 手动安装与避坑指南:不用HACS也能远程控车
Volkswagen Connect(仓库名 homeassistant-volkswagencarnet)是 Home Assistant 的自定义组件,让你远程查看和控制大众汽车:锁车、空调、续航、位置、充电状态,官方 App 能做的它基本都能做。HACS 不是唯一入口——手动安装同样简单。这篇指南带你完成手动安装,并避开最常见的 5 个坑。
它能干什么?🚗
组件连接大众 VW Connect 服务(目前仅支持欧盟市场车辆),覆盖 Golf、Passat、Tiguan、e-Golf 以及 ID 系列等车型,需要车辆绑定的 VW 在线订阅。装好后,Home Assistant 会自动创建一整套实体:
| 类型 | 功能 |
|---|---|
| 📊 传感器 | 续航里程、电池电量、充电进度、上次行程能耗 |
| 🔒 锁 | 远程上锁/解锁 |
| ❄️ 空调 | 远程开空调/暖风 |
| 📍 设备追踪器 | 车辆实时位置 |
| 🔁 开关 | 远程开启充电、打开后备箱等 |
核心逻辑集中在 custom_components/volkswagencarnet/ 目录,各平台实体的开关定义在 const.py 的 COMPONENTS 中。
安装前的准备工作
- 确认车辆是欧盟区销售,且 VW Connect 服务在网页端能正常登录、能看到车况;
- 准备好你的 VW Connect 账号和密码(不是 ID. 车机的登录信息);
- 了解车辆的 VIN 码(配置流程中会列出让你选,一般用不到手写);
- 如果要用锁车等功能,准备好 S-PIN 数字密码。
⚠️ 重要提示:大众曾多次封锁第三方认证接口,README 中注明当前认证机制可能处于被封锁状态。安装前请先在浏览器登录 myvolkswagen 官网确认服务可用,避免组件"看起来没装好"其实是上游问题。
手动安装步骤(3 种方式任选)
方式一:下载官方 zip 包(推荐)⭐
这是最省心的手动方式,官方打包的发布包已内置依赖声明,Home Assistant 能自动找到依赖:
- 从项目的 Releases 页面下载最新版
volkswagencarnet.zip; - 把压缩内容中的
custom_components文件夹解压复制到 Home Assistant 配置目录下的<config directory>/custom_components/中; - 重启 Home Assistant;
- 进入 设置 → 设备与服务 → 集成,点击 + 添加集成,搜索 Volkswagen Connect。
方式二:源码 + 手动装依赖
如果不喜欢 zip 包,可以用源码或 git 分支,但需要自己安装依赖(见 requirements.txt,当前锁定 volkswagencarnet==5.5.1):
git clone https://gitcode.com/gh_mirrors/ho/homeassistant-volkswagencarnet
pip install -r requirements.txt
然后把 custom_components/ 目录复制到 Home Assistant 配置目录并重启。注意:只有官方打包的 zip 会自动处理依赖,源码方式漏装依赖是最常见的"装完搜不到集成"的原因。
方式三:配合 HACS 的 zip_release 模式
查看 hacs.json 可知该项目开启了 zip_release,HACS 安装时下载的就是与方式一相同的发布包,所以手动与自动安装本质上走的是同一条路——这也是为什么手动方式完全可靠的。
配置流程逐项讲解
添加集成后跟着向导走即可,表单字段定义在 config_flow.py。各选项说明:
| 选项 | 必填 | 说明 |
|---|---|---|
| Name | 否 | 自定义车名,默认显示 VIN |
| Username / Password | 是 | VW Connect 账号密码 |
| Region | 是 | 车辆销售国家,默认 DE |
| Mutable | 否 | 开启才可远程控制,关闭则只读数据 |
| S-PIN | 否 | 锁车/解锁等部分功能需要 |
| 距离单位 | 否 | km(默认)、英里、斯堪的纳维亚 mil |
| 传感器更新间隔 | 否 | 默认 5 分钟,范围 0-60;0 表示仅手动刷新 |
登录成功后,组件会列出账号下的车辆,选中 VIN,所有可用实体会自动创建,无需手动挑选。配置完成后可通过"Scan Interval"数字实体随时调整刷新频率。
必知:API 调用配额与更新间隔
这是新手最容易踩的大坑:VW API 每天限 480 次调用。默认 5 分钟间隔约消耗 288 次/天,只剩 192 次给官方 App 和其他应用——如果你平时也用手机里的 VW App,建议把更新间隔调到 10 分钟:进入集成 → Configure → 修改 Sensors update interval (minutes)。
另外组件还内置了出发计划服务(update_schedule),可远程设置 ID 系列的空调出发定时器、充电计划等,字段定义见 services.yaml。
常见问题排查清单 🛠️
- 登录失败 / 一直转圈:先在浏览器里登录 myvolkswagen 官网验证账号与服务是否正常。需要接受 EULA(用户协议)时,先去官网点一次同意,组件会触发 reauth 重新认证流程(见 init.py 中
async_login的报错提示)。 - 搜不到 Volkswagen Connect:检查
custom_components/volkswagencarnet路径层级是否正确、依赖是否安装、是否已重启。 - 实体显示不可用:该组件完全依赖 VW Connect 云端,车机离线或云端故障时实体不可用属正常现象,组件可靠性与上游服务一致。
- 非欧盟车辆:目前只验证过欧盟账户,北美等地区未验证,暂不保证可用。
- 频繁掉线:多为认证接口被封锁或 EULA 到期,按 README 提示跟踪官方 issue 的动态即可。
写在最后
手动安装 Volkswagen Connect 组件没有想象中复杂:下载 zip → 丢进 custom_components → 重启 → 搜索添加集成,四步搞定,还能顺便规避 API 配额、EULA、reauth 三大坑。装好后,锁车、空调、续航监控、位置追踪就都进了你的 Home Assistant。
想了解完整功能与更新日志,可参阅项目 README.md。