teslamate:基于 Elixir 与 Postgres 的特斯拉数据记录项目

A self-hosted data logger for your Tesla 🚘 [main maintainer=@JakobLichterfeld]

Branch19Tags105
This repository is empty

TeslaMate

License OpenSSF Best Practices CI Publish Docker images Coverage current version docker image size docker pulls

一款功能强大的自托管特斯拉数据记录器。

  • 使用 Elixir 编写
  • 数据存储在 Postgres 数据库中
  • 通过 Grafana 进行数据可视化与分析
  • 车辆数据发布至本地 MQTT 代理服务器

⚠️ 安全警告

Caution

仅使用官方版本

为保护您免受恶意分支、恶意软件和数据盗窃的侵害,请确保仅从官方渠道获取 TeslaMate:

我们已收到报告,有欺诈性网站和非官方移动应用(例如 App Store 上的应用)使用 TeslaMate 名称分发经过修改的有害版本。如果您使用的是其他来源的版本,您的特斯拉账户凭据和车辆数据可能会面临风险。

文档

文档可在 https://docs.teslamate.org 查看

功能特性

常规功能

  • 高精度驾驶数据记录
  • 无额外电量消耗:车辆将尽快进入休眠状态
  • 自动地址查询
  • 轻松集成到 Home Assistant(通过 MQTT)
  • 轻松集成到 Node-Red 和 Telegram(通过 MQTT)
  • 地理围栏功能,可创建自定义位置
  • 支持每个 Tesla 账户关联多辆车辆
  • 充电成本跟踪
  • 可从 TeslaFi 和 tesla-apiscraper 导入数据
  • 可自定义主题模式(浅色、深色或系统默认)

仪表盘

点击以下链接可查看捆绑仪表盘的示例截图。

截图

抢先了解 TeslaMate 的界面和内置仪表盘。更多截图请参见文档

Web 界面

驾驶详情

电池健康状况

许可协议

TeslaMate 采用 GNU Affero General Public License v3.0 (AGPLv3) 许可协议。

本许可协议旨在确保 TeslaMate 始终为所有人免费开放。使用、修改或基于本项目进行开发,即表示您同意以下条款:

  • 互惠共享(Copyleft):如果您修改 TeslaMate 或将其整合到其他项目中,您必须将您版本的完整源代码以相同的 AGPLv3 许可协议发布。
  • 源代码的普遍可访问性:无论您如何向他人提供软件——无论是作为可下载应用程序(例如在应用商店中)、预打包镜像分发,还是通过网络服务(SaaS)提供其功能访问——此要求均适用。
  • 禁止闭源衍生作品:我们不允许在闭源商业产品中使用 TeslaMate 或其组件。如果您的软件与 TeslaMate 交互或依赖于它,则必须是开源的。如果您基于本项目进行开发,我们期望您能回馈社区。

完整的法律条款,请参阅LICENSE文件。

核心要求:

  • Copyleft:如果您修改 TeslaMate 并进行分发(例如作为应用程序、二进制文件或软件包)或将其作为网络服务(SaaS)提供,您必须将修改后的源代码以相同的 AGPLv3 许可协议向所有用户开放。
  • 禁止“封闭”分支:本许可协议确保商业实体或第三方所做的改进对整个社区保持开放。
  • 署名:您必须保留所有原始版权声明和许可信息的完整性。

商标政策:TeslaMate 名称和徽标的使用受我们的商标政策管辖。

贡献:所有贡献者必须签署我们的贡献者许可协议。首次提交 PR 时,cla-assistant.io 会自动处理此流程,耗时不长。我们为何需要此协议? 它保证 TeslaMate 将永远保持自由软件(AGPL-3.0)的性质,并允许teslamate-org对许可协议违规行为采取法律行动以保护项目。

星级历史

Star History Chart

致谢

  • 初始作者:Adrian Kumpf
  • 贡献者列表:
  • TeslaMate 贡献者