Volkswagen Connect 手动安装与避坑指南:不用HACS也能远程控车

原创2026-11-01 18:37:261,666 阅读

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 中。

安装前的准备工作

  1. 确认车辆是欧盟区销售,且 VW Connect 服务在网页端能正常登录、能看到车况;
  2. 准备好你的 VW Connect 账号和密码(不是 ID. 车机的登录信息);
  3. 了解车辆的 VIN 码(配置流程中会列出让你选,一般用不到手写);
  4. 如果要用锁车等功能,准备好 S-PIN 数字密码。

⚠️ 重要提示:大众曾多次封锁第三方认证接口,README 中注明当前认证机制可能处于被封锁状态。安装前请先在浏览器登录 myvolkswagen 官网确认服务可用,避免组件"看起来没装好"其实是上游问题。

手动安装步骤(3 种方式任选)

方式一:下载官方 zip 包(推荐)⭐

这是最省心的手动方式,官方打包的发布包已内置依赖声明,Home Assistant 能自动找到依赖:

  1. 从项目的 Releases 页面下载最新版 volkswagencarnet.zip;
  2. 把压缩内容中的 custom_components 文件夹解压复制到 Home Assistant 配置目录下的 <config directory>/custom_components/ 中;
  3. 重启 Home Assistant;
  4. 进入 设置 → 设备与服务 → 集成,点击 + 添加集成,搜索 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。

登录后查看全文
homeassistant-volkswagencarnet