跳到主要内容

常见问题 (FAQ)

基础问题​

什么是 TeslaMate？​

TeslaMate 是一个开源的特斯拉数据记录器，它通过特斯拉的 API 收集车辆数据，并存储在本地数据库中。它提供了详细的驾驶记录、充电统计、位置追踪等功能。

Mytesla 和 TeslaMate 的关系是什么？​

Mytesla 是基于 TeslaMate 数据构建的前端应用。TeslaMate 负责数据收集和存储，Mytesla 提供了更现代化的用户界面和额外的功能。

我需要付费吗？​

  • TeslaMate：完全免费开源
  • TeslamateAPI：基于开源 teslamateapi 增强服务
  • Mytesla.cc：一次性购买
  • Tailscale：个人使用免费（20设备）
  • Cloudflare：50用户以下免费

数据存储在哪里？​

所有数据都存储在您自己的服务器上，Mytesla.cc 只是前端界面，不会存储您的车辆数据。

安装问题​

Docker 安装失败​

问题： Cannot connect to the Docker daemon

解决方案：

# 确保 Docker 服务启动
sudo systemctl start docker

# 添加用户到 docker 组
sudo usermod -aG docker $USER

# 重新登录
newgrp docker

端口被占用​

问题： bind: address already in use

解决方案：

# 查找占用端口的进程
sudo lsof -i :4000

# 修改 docker-compose.yml 中的端口
ports:
  - "14000:4000"  # 改为其他端口

数据库连接失败​

问题： could not connect to database

解决方案：

  1. 检查数据库容器状态：
   docker-compose ps database
  1. 查看数据库日志：
   docker-compose logs database
  1. 确保环境变量正确：
   docker-compose exec teslamate env | grep DATABASE

配置问题​

Tailscale 无法连接​

问题：Tailscale 状态显示离线

解决方案：

  1. 检查 Auth Key 是否正确
  2. 确保 Auth Key 设置为 "Reusable"
  3. 检查防火墙设置：
   sudo iptables -L

加密密钥错误​

问题： unable to decrypt

解决方案：

  • 确保 TM_ENCRYPTION_KEY 在所有服务中一致
  • 密钥必须是 32 个字符
  • 一旦设置不能更改

使用问题​

车辆数据不更新​

可能原因：

  1. 特斯拉 API 限制
  2. 车辆处于深度睡眠
  3. 网络连接问题

解决方案：

# 检查 TeslaMate 日志
docker-compose logs teslamate | grep -i error

# 重启服务
docker-compose restart teslamate

Grafana 无法访问​

问题：访问 /grafana 显示 404

解决方案：

  1. 检查 Grafana 配置：
   GF_SERVER_ROOT_URL=https://mytesla.example.ts.net/grafana
   GF_SERVER_SERVE_FROM_SUB_PATH=true
  1. 检查 Traefik 路由：
   - "traefik.http.routers.grafana.rule=Host(`${TS_HOSTNAME}.${TS_TAILNET_NAME}`) && PathPrefix(`/grafana`)"

是否可以公开访问？​

不建议直接暴露服务。请使用：

  • Tailscale（推荐）
  • Cloudflare Zero Trust

如何查看日志？​

# 查看所有日志
docker-compose logs

# 查看特定服务日志
docker-compose logs teslamate

# 实时查看日志
docker-compose logs -f teslamateapi

磁盘空间不足​

清理方案：

# 清理未使用的镜像
docker image prune -a

# 清理日志
docker-compose logs --no-color > logs_backup.txt
docker-compose down
docker-compose up -d

高级问题​

多车支持​

Mytesla 和 TeslaMate 都支持多辆车：

  1. 在 TeslaMate 中添加车辆
  2. API 会自动识别所有车辆
  3. 在 Mytesla 中切换车辆

容器无法启动​

  1. 检查日志：
   docker-compose logs container_name
  1. 检查资源：
   df -h  # 磁盘空间
   free -m  # 内存
  1. 重置容器：
   docker-compose rm -f container_name
   docker-compose up -d container_name

联系支持​

如果以上方案都无法解决您的问题：

提问时请提供：

  • 错误日志
  • 配置文件（隐藏敏感信息）
  • 系统环境信息
  • 重现步骤