← 返回项目库

特斯拉行车数据系统|中文本地预览

TeslaMate 是一套自托管的特斯拉行车数据记录与分析系统,覆盖行程、能耗、充电、电池健康和位置围栏。

本交付保留上游 Elixir/Phoenix TeslaMate、Docker、Postgres、MQTT 与 Grafana 生产链路,并新增无需外部服务即可独立启动的中文本地预览适配器。预览页用版本化演示数据先验收车辆总览、行程详情、充电分析、电池趋势、位置围栏和设置流程,页面持续标注本地预览与演示数据。

真实界面

项目截图

共 6 张

车辆总览
行程记录
充电分析
电池健康
位置围栏
系统设置

Capabilities

核心功能

高精度记录特斯拉行程、里程、速度和能耗数据
行程记录与平均能耗趋势分析
充电会话、补充电量与充电费用跟踪
电池健康度、预计续航和长期衰减趋势展示
位置地址与自定义地理围栏管理
支持多车辆,并通过 MQTT 对接 Home Assistant、Node-RED 等扩展
中文本地预览覆盖总览、行程、充电、电池、围栏和设置六个核心流程

适用场景

车主在家庭服务器或 NAS 上持续保存并回看自己的行车数据
通过充电费用与电池趋势了解长期用车成本和续航变化
使用位置围栏与 MQTT 将车辆状态接入家庭自动化
在未准备真实外部服务时,先用本地预览验收中文界面与业务流程

适合谁

希望自托管保存特斯拉行车数据的车主、家庭服务器用户、开发者与小型运维团队。

商业化思路

AGPL-3.0 开源软件交付,以及中文本地化、部署、数据迁移和运维服务。

你会拿到什么

  • 完整 TeslaMate Elixir/Phoenix 源码、Docker 配置与原有生产链路
  • 中文本地预览 Web 适配器、依赖无关运行服务器与确定性构建检查
  • AGPL-3.0 LICENSE、中文 README、6 张运行 UI 证据与验证记录

部署流程

  1. 1本地预览:在仓库根目录执行 python3 commercial-demo/demo_server.py --host 127.0.0.1 --port 23273,然后访问 http://127.0.0.1:23273/。
  2. 2完整部署:按 README 与上游文档准备 Docker Compose、Postgres、MQTT、Grafana 和特斯拉官方 API 凭证,再启动原有 TeslaMate 服务。
  3. 3真实接入:完成凭证、数据库、遥测与可视化联调后,再将本地预览数据替换为真实车辆数据;本窗口未代替用户完成账号接入。

真实验证结果

已通过确定性构建、HTTP 健康/摘要/刷新接口、浏览器功能烟测和 1440x900 浏览器 UI 证据;6 个截图来自同一运行会话,包含车辆总览、行程详情弹窗、充电分析、电池健康、位置围栏表单和系统设置。

部署前须知

本地预览使用有界演示数据,不连接 Tesla API、Postgres、MQTT 或 Grafana,也不执行真实车辆控制、数据库写入或通知发送;完整 Phoenix 生产链路需要 Elixir/OTP、Docker、外部服务与特斯拉凭证,本窗口未做真实账号接入和远程采集联调。

部署难度

较高

最低配置

中文本地预览仅需 Python 3.9+;完整 TeslaMate 部署需要可长期在线的 Docker/Docker Compose 环境、Postgres、MQTT、Grafana 和特斯拉官方 API 访问凭证。

开源许可证

GNU Affero General Public License v3.0 (AGPLv3)

最后验证

2026-09-02

技术栈

ElixirPhoenix LiveViewPostgresMQTTGrafanaDocker ComposePython local preview adapterHTML/CSS/JavaScript

授权说明

上游仓库包含 LICENSE,本源码包保留原许可证与版权声明。AGPLv3 允许在许可证条件下修改、运行和再分发,但对网络服务提供相应源代码;本窗口新增中文 PO 翻译、README 说明和 commercial-demo 本地预览适配器,修改内容已在交付说明中披露。上游来源:https://www.gitcc.com/ortea/teslamate-cn.git。

Release notes

版本记录

1 个已发布版本

vcn-c3137032ca3d 当前推荐

新增中文本地预览适配器,覆盖车辆总览、行程记录、充电分析、电池健康、位置围栏和系统设置六个流程;增加可操作的刷新、行程详情、新建围栏、设置保存和车辆切换,并补齐 zh_Hans 核心 PO 翻译。

部署要求:本地预览需要 Python 3.9+;完整 TeslaMate 生产链路需要按 README 准备 Elixir/OTP、Docker Compose、Postgres、MQTT、Grafana 和特斯拉官方 API 凭证。

已知问题:演示模式只提供版本化本地数据,不代表真实车辆、数据库、遥测或远程控制已经接通;完整生产联调需要用户按上游文档继续配置。

登录后领取