源码系统概览
文章正文
TeslaMate 是一款开源的特斯拉行车数据系统源码，由车主自托管运行，持续采集行程、能耗、充电与电池健康数据，是特斯拉车主的私有行车日志平台。
项目由 TeslaMate 社区团队维护，采用 AGPL-3.0 许可证，当前版本 v4.2.0，最后更新 2026 年，更新日志随版本发布并标注升级注意事项。
源码简介
系统通过官方接口持续采集车辆遥测数据，存储在本地数据库，配合可视化仪表盘展示行程里程、能耗与速度曲线。
充电会话记录功率曲线与费用统计，长期跟踪电池健康度与续航变化，支持多车辆管理与驾驶行为统计。
中文本地化版本覆盖仪表盘文案与设置页面，预置的多个仪表盘开箱即用，数据采集频率与保留策略可调。
和官方应用及第三方服务对比 vs Teslascope，TeslaMate 的本地数据主权是最大区别。
| 对比维度 | TeslaMate | Teslascope |
|---|---|---|
| 数据存储 | 本地数据库，车主完全自持 | 第三方云端存储 |
| 统计深度 | 充电功率曲线与电池健康度 | 基础行程统计 |
| 多车支持 | 原生支持多车辆管理 | 需升级套餐 |
| 许可证 | AGPL-3.0 开源协议 | 商业服务 |
关注电池健康与能耗细节、不放心把账号交给第三方的车主，TeslaMate 值得长期部署运行。
欢迎感兴趣的开发者到 GitHub 仓库 star 和 fork 参与贡献。
适用场景
- 特斯拉车主自建行车日志，长期跟踪电池健康度。
- 家庭多辆车统一管理充电与能耗统计。
- 分析快充功率曲线，评估充电桩实际输出。
- 对比不同季节真实续航，生成用车成本报表。
技术栈与运行环境
技术栈为 Elixir 语言后端加 PostgreSQL 时序数据，前端采用 Leaflet 地图与 Grafana 仪表盘，当前版本 v4.2.0。
要求一台可长期在线的设备运行 Docker Compose 编排，含数据库与可视化面板，首次同步车辆数据需要一些时间。
功能亮点
- 行程记录含里程、能耗与速度区间分布。
- 充电会话功率曲线与费用统计。
- 电池健康度与续航长期趋势跟踪。
- 家充与超充占比、总电费等充电统计。
- 多车辆管理与驾驶行为统计。
- 预置多个 Grafana 可视化仪表盘。
技术架构与部署指南
安装与部署提示
使用官方 Docker Compose 配置启动全部服务，在配置中填入特斯拉账号访问凭证，等待车辆数据接入。
打开可视化面板查看预置仪表盘，按需调整数据采集频率与保留策略，凭证失效时按文档更新令牌。
项目最后更新 2026 年，v4.2.0 更新日志包含车型适配与仪表盘改进，升级前备份数据库。
截图与演示说明
上图为 TeslaMate 行车数据系统的 Web 管理端，地图显示车辆实时位置，右侧为充电状态卡片。
仪表盘页提供行程、充电、能耗与电池健康等多组视图，充电页可查看每次会话的功率曲线，界面已汉化。
TeslaMate 的行程页可按时间范围筛选每次出行记录，电池页展示充电深度与退化趋势，数据全部保存在本地数据库中。
常见问题
问：TeslaMate 是什么工具？
TeslaMate 是一款开源的特斯拉行车数据记录系统，自托管持续采集车辆遥测数据，提供行程、能耗、充电与电池健康度的可视化统计。
问：TeslaMate 源码怎么下载部署？
从本页下载源码包解压后，使用官方 Docker Compose 启动服务，填入特斯拉账号访问凭证即可开始采集数据。
问：和 Teslascope 对比有什么区别？
与 Teslascope 对比，TeslaMate 数据存储在本地、无需订阅且支持多车管理，账号凭证不经第三方。
问：TeslaMate 免费吗？
项目采用 AGPL-3.0 许可证开源，自部署免费，修改后对外提供网络服务需按协议开源修改内容。
安全风险提示
该项目为 Elixir 技术栈，对 8 个命中的配置与脚本文件做了高风险函数扫描，未发现 webshell、后门或加密混淆文件。
特斯拉账号访问凭证保存在环境变量中务必妥善保管，服务建议仅在内网运行，反代与认证按官方文档加固，数据库定期备份。
下载说明
本页提供 TeslaMate 特斯拉行车数据系统的完整源码打包下载，含后端、前端与全部编排文件，适合车主自托管长期运行。
压缩包为原始仓库文件，下载后解压按部署提示操作即可，后续版本可通过官方更新日志跟进。
GitHub项目开源地址：https://github.com/teslamate-org/teslamate
