Xiaomi EV Mate 社区维护 · 当前发布版本 v1.1.8

Xiaomi EV Mate 支持哪些车型和部署环境

一句话结论: Xiaomi EV Mate 支持小米汽车全系车型接入和数据同步,并支持 Docker 部署到 Linux 服务器、家庭服务器或 NAS;不同车型可同步的字段和派生指标以小米接口返回结果及当前版本实现为准。

车型支持应该如何理解?

项目支持小米汽车全系车型接入,不以 SU7、YU7 或其他固定车型作为车辆同步的唯一范围。车型是否能返回某个具体字段,取决于小米接口和当前版本实现。

范围 当前说明
小米汽车全系车型 支持车辆接入和数据同步,具体字段以同步结果为准
新发布车型 支持接入;车型专属字段和派生指标以当前接口返回及版本实现为准

车型接入支持小米汽车全系车型。车型名称匹配采用准确型号或准确别名,不按相似名称猜测电池容量;如果某车型的电池容量尚未进入维护清单,车辆仍可接入和同步,但电池容量相关计算可能为空。不要把项目中的车型映射文件当成小米汽车官方车型目录。

如果要查询官方车型、价格、配置和最新技术信息,请前往小米汽车官方网站

支持哪些部署环境?

Xiaomi EV Mate 通过 Docker 运行,常见部署环境包括:

  • Ubuntu、Debian、CentOS、Rocky Linux、Fedora 等 Linux 服务器。
  • 绿联 NAS 等支持 Docker 的 NAS。
  • 极空间等支持 Docker 的家庭存储设备。
  • 个人云主机或家庭服务器。

官方部署方式包含 Linux 一键安装脚本和 Docker Compose 手动部署。需要固定版本、调整端口或自行维护服务编排时,建议使用 Docker Compose。

支持哪些手机账号配置方式?

  • 小米手机:如果已经登录小米汽车 App,可优先尝试二维码登录和自动获取设备信息。
  • iPhone:通常使用手动配置,准备 EUIdeviceId
  • 非小米安卓手机:通常使用二维码登录,并按提示手动填写 deviceId

账号配置涉及敏感信息。请只在可信网络中操作,不要公开分享 EUIdeviceId、Token 或账号截图。完整步骤请阅读小米账号配置指南

哪些能力不应被误解?

Xiaomi EV Mate 是数据同步、查询、统计和通知工具,不是小米汽车官方 App,也不是官方售后诊断系统。全系车型均支持接入,但实时状态、行程、充电和能耗数据依赖接口返回及同步完整性;不同车型、版本和字段可能存在差异。

项目也不建议把服务直接暴露在公网。部署时应使用强密码、限制网络访问、保护 config 目录和备份口令,并定期检查版本更新。

从哪里开始?

  1. 阅读快速开始
  2. 根据设备选择Linux 安装绿联 NAS 安装极空间安装
  3. 查看更新日志,确认当前版本的功能和升级注意事项。

当前门户发布版本:v1.1.8。本文复核日期:2026-09-17。