teslamate-org/teslamate
GitHub: teslamate-org/teslamate
一款自托管的特斯拉车辆数据记录与可视化分析平台,让车主在本地采集并掌控驾驶、充电及电池健康等全维度数据。
Stars: 8519 | Forks: 964
# TeslaMate
[](https://github.com/teslamate-org/teslamate/blob/main/LICENSE)
[](https://www.bestpractices.dev/projects/10859)
[](https://github.com/teslamate-org/teslamate/actions/workflows/devops.yml)
[](https://github.com/teslamate-org/teslamate/actions/workflows/buildx.yml)
[](https://coveralls.io/github/teslamate-org/teslamate?branch=main)
[](https://hub.docker.com/r/teslamate/teslamate)
[](https://hub.docker.com/r/teslamate/teslamate)
[](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)获取更多截图。



## 许可证
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 历史
## 致谢
- 初始作者:Adrian Kumpf
- 贡献者列表:
- [](https://github.com/teslamate-org/teslamate/graphs/contributors)
标签:Elixir, Grafana, PostgreSQL, Tesla, 数据记录, 测试用例, 物联网, 请求拦截