常见问题
部署成功后，登录报错“网络错误”？
解决方案：
- 确认后端服务启动成功：请确认名为
xiaomiev-mate的后端服务正在运行。 - 确保容器名称配置正确：请确认后端容器的
container_name属性值被设定为xiaomiev-mate，且该容器与前端容器处于同一个 docker network 网络中。
为什么建议私有化部署？
车辆、行程和账号相关数据比较敏感，私有化部署能减少数据外泄风险。
config 目录有什么用，可以删除吗？
答： 不能只保留 pgdata 而删除 config。其中的 config/.secrets/field-keyring.json 用于解密已加密的敏感配置，config/backup 用于保存自动备份文件；升级、迁移或备份时应与数据库一并保留。
数据备份会同时备份加密密钥吗？
答： 会。手动和自动生成的 .xmbak 都包含数据库与字段加密密钥环，并由恢复口令整体加密。请将备份文件与恢复口令分开、安全保存。
如何迁移到新服务器或 NAS？
答： 在旧服务使用管理员账号进入“个人中心 → 数据备份”，创建并下载 .xmbak，同时记好恢复口令。新环境部署完成后，在同一页面上传备份并确认恢复；备份会带上数据库、加密密钥和账号信息。恢复会覆盖新环境现有数据，完成后需要重启服务。
提示“小米账号在其他设备上登录”怎么办？
如果看到“你的小米账号****，在其他设备上登录。如非本人操作，请及时修改密码”，说明小米账号发生了新的设备登录。若不是本人操作，请先通过小米官方渠道修改密码并检查账号安全；若是本人更换或重新登录设备，系统中保存的设备 ID 可能需要更新。
- 使用小米手机时，在“个人中心 → 登录小米账号”重新获取当前设备信息。
- 使用 iPhone 或其他安卓设备时，按小米账号配置指南重新获取当前小米汽车 App 对应的
deviceId；不要继续使用旧设备的 ID。 - 在账号配置中更新设备 ID 并保存，再按页面提示重新扫码登录或验证 Token。仍无法登录时，请确认小米汽车 App 当前登录的是同一小米账号。
Xiaomi EV Mate 检查配置失败怎么办？
- 请确认抓包字段是否完整
- 检查设备 ID 是否正确
Xiaomi EV Mate 无法拉取车辆怎么办？
- 确认小米账号信息已保存并完成扫码登录
内网 HTTP 无法使用远程查看，怎么办？
请选择以下一种方式访问远程查看：
- 在 NAS 本机浏览器访问：使用
http://localhost:18080或http://127.0.0.1:18080。 - 已配置反向代理：通过你自己的 HTTPS 域名访问，并将反向代理指向
NAS_IP:18080。 - 使用 NAS 远程访问：优先使用 NAS 自带远程访问提供的 HTTPS 地址访问。大多数 NAS 均提供此能力。
localhost和127.0.0.1只指向当前打开浏览器的设备。因此，只有在 NAS 本机浏览器中才能访问 NAS 服务；电脑、手机或平板访问 NAS 时，请使用 HTTPS 域名或 NAS 远程访问地址。
镜像拉取失败怎么办？
如果部署时出现镜像拉取超时、失败或 429，可以将 Docker Compose 中的镜像地址改为 Xiaomi EV Mate 镜像代理：
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
问题反馈或需求反馈：
- 欢迎提交 Issue 或 可以发送邮件到
[email protected]