teslamate-org/teslamate

GitHub: teslamate-org/teslamate

一款自托管的特斯拉车辆数据记录与可视化分析平台,让车主在本地采集并掌控驾驶、充电及电池健康等全维度数据。

Stars: 8519 | Forks: 964

# TeslaMate [![许可证](https://img.shields.io/badge/license-AGPL--3.0-green.svg)](https://github.com/teslamate-org/teslamate/blob/main/LICENSE) [![OpenSSF 最佳实践](https://www.bestpractices.dev/projects/10859/badge)](https://www.bestpractices.dev/projects/10859) [![CI](https://static.pigsec.cn/wp-content/uploads/repos/2026/06/ca010dbc7a174200.svg)](https://github.com/teslamate-org/teslamate/actions/workflows/devops.yml) [![发布 Docker 镜像](https://static.pigsec.cn/wp-content/uploads/repos/2026/06/2ceef34f25174205.svg)](https://github.com/teslamate-org/teslamate/actions/workflows/buildx.yml) [![覆盖率](https://coveralls.io/repos/github/teslamate-org/teslamate/badge.svg?branch=main)](https://coveralls.io/github/teslamate-org/teslamate?branch=main) [![当前版本](https://img.shields.io/docker/v/teslamate/teslamate/latest)](https://hub.docker.com/r/teslamate/teslamate) [![Docker 镜像大小](https://img.shields.io/docker/image-size/teslamate/teslamate/latest)](https://hub.docker.com/r/teslamate/teslamate) [![Docker 拉取次数](https://img.shields.io/docker/pulls/teslamate/teslamate?color=%23099cec)](https://hub.docker.com/r/teslamate/teslamate) 一个功能强大、可自行托管的 Tesla 数据记录器。 - 使用 **[Elixir](https://elixir-lang.org/)** 编写 - 数据存储在 **Postgres** 数据库中 - 使用 **Grafana** 进行可视化和数据分析 - 车辆数据发布到本地的 **[MQTT](https://en.wikipedia.org/wiki/MQTT)** Broker ## ⚠️ 安全警告 为了保护您免受恶意分支、恶意软件和数据窃取的侵害,请确保您仅从官方渠道获取 TeslaMate: - 官方代码库:[https://github.com/teslamate-org/teslamate](https://github.com/teslamate-org/teslamate) - 官方文档:[https://docs.teslamate.org](https://docs.teslamate.org/) 我们收到过关于欺骗性网站和非官方移动应用(例如在 App Store 上)使用 TeslaMate 名称分发修改版或有害版本的报告。如果您使用的是来自其他来源的版本,您的 Tesla 账户凭证和车辆数据可能面临风险。 ## 文档 文档可在 [https://docs.teslamate.org](https://docs.teslamate.org/) 获取 ## 功能 ### 常规 - 高精度的驾驶数据记录 - 没有额外的吸血鬼耗电:汽车会尽快进入睡眠状态 - 自动地址查找 - 轻松集成到 Home Assistant(通过 MQTT) - 轻松集成到 Node-Red 和 Telegram(通过 MQTT) - 地理围栏功能,可创建自定义位置 - 支持每个 Tesla 账户关联多辆车 - 充电成本跟踪 - 支持从 TeslaFi 和 tesla-apiscraper 导入 - 可自定义的主题模式(浅色、深色或系统默认) ### 仪表板 点击下方链接即可查看内置仪表板的示例截图。 - [电池健康](https://docs.teslamate.org/docs/screenshots/#battery-health) - [电量级别](https://docs.teslamate.org/docs/screenshots/#charge-level) - [充电(增加 / 消耗的电量)](https://docs.teslamate.org/docs/screenshots#charges) - [充电详情](https://docs.teslamate.org/docs/screenshots#charge-details) - [充电统计](https://docs.teslamate.org/docs/screenshots#charging-stats) - [数据库信息](https://docs.teslamate.org/docs/screenshots/#database-information) - [驾驶统计](https://docs.teslamate.org/docs/screenshots#drive-stats) - [驾驶(距离 / 消耗的电量(净))](https://docs.teslamate.org/docs/screenshots/#drives) - [驾驶详情](https://docs.teslamate.org/docs/screenshots/#drive-details) - [效率(能耗(净 / 总))](https://docs.teslamate.org/docs/screenshots#efficiency) - [位置(地址)](https://docs.teslamate.org/docs/screenshots/#location-addresses) - [里程](https://docs.teslamate.org/docs/screenshots/#mileage) - [概述](https://docs.teslamate.org/docs/screenshots/#overview) - [预计续航(电池衰减)](https://docs.teslamate.org/docs/screenshots#projected-range) - [状态(查看您的车辆何时在线或睡眠)](https://docs.teslamate.org/docs/screenshots#states) - [统计数据](https://docs.teslamate.org/docs/screenshots/#statistics) - [时间线](https://docs.teslamate.org/docs/screenshots/#timeline) - [行程](https://docs.teslamate.org/docs/screenshots/#trip) - [更新(已安装更新的历史记录)](https://docs.teslamate.org/docs/screenshots#updates) - [吸血鬼耗电](https://docs.teslamate.org/docs/screenshots#vampire-drain) - [访问过(终身驾驶地图)](https://docs.teslamate.org/docs/screenshots/#visited-lifetime-driving-map) ## 截图 抢先一瞥 TeslaMate 界面和内置仪表板。请查看[文档](https://docs.teslamate.org/docs/screenshots)获取更多截图。 ![Web 界面](/website/static/screenshots/web_interface.png) ![驾驶详情](/website/static/screenshots/drive.png) ![电池健康](/website/static/screenshots/battery-health.png) ## 许可证 TeslaMate 采用 **GNU Affero General Public License v3.0 (AGPLv3)** 授权。 此许可证旨在确保 TeslaMate 始终对所有人保持免费和开放。通过使用、修改或基于此项目进行开发,即表示您同意以下条款: - 互惠共享(Copyleft):如果您修改了 TeslaMate 或将其整合到另一个项目中,您必须以相同的 AGPLv3 许可证发布您版本的完整源代码。 - 源代码的普遍访问权:无论您以何种方式向他人提供该软件——无论是作为可下载的应用程序(例如在 App Store 中)、作为预打包的镜像,还是通过网络服务(SaaS)提供对其功能的访问,此要求均适用。 - 不允许闭源衍生作品:我们不允许在闭源商业产品中使用 TeslaMate 或其组件。如果您的软件与 TeslaMate 交互或依赖于它,则它必须是开源的。如果您基于此项目进行开发,我们期望您能回馈社区。 有关完整的法律条款,请参阅 [LICENSE](https://github.com/teslamate-org/teslamate/blob/main/LICENSE) 文件。 关键要求: - Copyleft:如果您修改了 TeslaMate 并将其分发(例如作为应用程序、二进制文件或软件包),或者通过网络将其作为服务提供(SaaS),您必须根据相同的 AGPLv3 许可证向所有用户提供修改后的源代码。 - 不允许“闭源”分支:此许可证确保商业实体或第三方所做的改进对整个社区保持开放。 - 署名:您必须保持所有原始版权声明和许可证信息完整无损。 **商标政策**:TeslaMate 名称和徽标的使用受我们的[商标政策](https://github.com/teslamate-org/teslamate/blob/main/TRADEMARK.md)管辖。 **贡献:** 所有贡献者必须签署我们的[贡献者许可协议](https://github.com/teslamate-org/legal/blob/main/CLA.md)。这将在首次提交 PR 时通过 cla-assistant.io 自动处理,不会花费很长时间。**我们为什么需要这个?** 它保证 TeslaMate 将**永远是自由软件**(AGPL-3.0),并允许 [teslamate-org](https://github.com/teslamate-org) 在法律上保护该项目免受许可证违规行为的侵害。 ## Star 历史 Star History Chart ## 致谢 - 初始作者:Adrian Kumpf - 贡献者列表: - [![TeslaMate 贡献者](https://contrib.rocks/image?repo=teslamate-org/teslamate)](https://github.com/teslamate-org/teslamate/graphs/contributors)
标签:Elixir, Grafana, PostgreSQL, Tesla, 数据记录, 测试用例, 物联网, 请求拦截