Xiaomi EV Mate

常见问题

部署成功后，登录报错“网络错误”？

解决方案：

  1. 确认后端服务启动成功：请确认名为 xiaomiev-mate 的后端服务正在运行。
  2. 确保容器名称配置正确：请确认后端容器的 container_name 属性值被设定为 xiaomiev-mate，且该容器与前端容器处于同一个 docker network 网络中。

为什么建议私有化部署？

车辆、行程和账号相关数据比较敏感，私有化部署能减少数据外泄风险。

`config` 目录有什么用，可以删除吗？

**答：**不能只保留 pgdata 而删除 config。其中的 config/.secrets/field-keyring.json 用于解密已加密的敏感配置，config/backup 用于保存自动备份文件；升级、迁移或备份时应与数据库一并保留。

数据备份会同时备份加密密钥吗？

**答：**会。手动和自动生成的 .xmbak 都包含数据库与字段加密密钥环，并由恢复口令整体加密。请将备份文件与恢复口令分开、安全保存。

如何迁移到新服务器或 NAS？

**答：**在旧服务使用管理员账号进入“个人中心 → 数据备份”，创建并下载 .xmbak，同时记好恢复口令。新环境部署完成后，在同一页面上传备份并确认恢复；备份会带上数据库、加密密钥和账号信息。恢复会覆盖新环境现有数据，完成后需要重启服务。

检查配置失败?

  • 请确认抓包字段是否完整
  • 检查设备 ID 是否正确

无法拉取车辆?

  • 确认小米账号信息已保存并完成扫码登录

镜像拉取失败怎么办？

如果部署时出现镜像拉取超时、失败或 429，可以将 Docker Compose 中的镜像地址改为 Xiaomi EV Mate 镜像代理：

yaml 
image: docker.xiaomievmate.com/postgres:15-alpine
image: docker.xiaomievmate.com/ponyix/xiaomiev-mate:backend-latest
image: docker.xiaomievmate.com/ponyix/xiaomiev-mate:web-latest

代理仅支持以上三个 Xiaomi EV Mate 部署所需镜像：PostgreSQL、后端和前端镜像，不能作为通用 Docker 镜像代理使用。如果使用固定版本，请保留原有 tag，例如将后端镜像改为 docker.xiaomievmate.com/ponyix/xiaomiev-mate:backend-v1.0.x。

完整的 Compose 配置和替换位置，请参阅部署指南。

"获取设备"按钮提示不支持：

  • 自动获取设备仅支持小米手机，其他安卓设备或 iOS 需通过抓包获取设备 ID

问题反馈或需求反馈：