teslamate-org / teslamate

TeslaMate is a powerful, self-hosted data logger for your Tesla. Written in Elixir, data is stored in a Postgres database, visualization and data analysis are handled with Grafana, and vehicle data is published to a local MQTT Broker. TeslaMate 是一款功能强大的特斯拉自托管数据记录器。它使用 Elixir 编写，数据存储在 Postgres 数据库中，通过 Grafana 进行可视化和数据分析，并将车辆数据发布到本地 MQTT 代理。

⚠️ Security Warning: Use Official Versions Only To protect yourself from malicious forks, malware, and data theft, please ensure you only obtain TeslaMate from the official source: Official Repository: https://github.com/teslamate-org/teslamate Official Documentation: https://docs.teslamate.org We have received reports of deceptive websites and unofficial mobile apps (e.g. on the App Store) using the TeslaMate name to distribute modified or harmful versions. If you are using a version from another source, your Tesla account credentials and vehicle data may be at risk. ⚠️ 安全警告：请仅使用官方版本 为了保护您免受恶意分支、恶意软件和数据窃取的侵害，请确保您仅从官方渠道获取 TeslaMate： 官方仓库：https://github.com/teslamate-org/teslamate 官方文档：https://docs.teslamate.org 我们已收到关于欺诈性网站和非官方移动应用（例如 App Store 中的应用）冒用 TeslaMate 名称分发修改版或有害版本的报告。如果您正在使用来自其他来源的版本，您的特斯拉账户凭据和车辆数据可能会面临风险。

Documentation The documentation is available at https://docs.teslamate.org 文档 文档地址：https://docs.teslamate.org

Features General: High precision drive data recording; No additional vampire drain: the car will fall asleep as soon as possible; Automatic address lookup; Easy integration into Home Assistant (via MQTT); Easy integration into Node-Red & Telegram (via MQTT); Geo-fencing feature to create custom locations; Supports multiple vehicles per Tesla Account; Charge cost tracking; Import from TeslaFi and tesla-apiscraper; Customizable theme mode (light, dark, or system default). 功能 常规： 高精度驾驶数据记录；无额外“吸血”耗电：车辆会尽可能快地进入休眠状态；自动地址查询；可轻松集成至 Home Assistant（通过 MQTT）；可轻松集成至 Node-Red 和 Telegram（通过 MQTT）；地理围栏功能，可创建自定义位置；支持每个特斯拉账户管理多辆车；充电成本追踪；支持从 TeslaFi 和 tesla-apiscraper 导入数据；可自定义主题模式（浅色、深色或系统默认）。

Dashboards Sample screenshots of bundled dashboards can be seen by clicking the links below. Battery Health, Charge Level, Charges (Energy added / used), Charge Details, Charging Stats, Database Information, Drive Stats, Drives (Distance / Energy consumed (net)), Drive Details, Efficiency (Consumption (net / gross)), Locations (addresses), Mileage Overview, Projected Range (battery degradation), States (see when your car was online or asleep), Statistics, Timeline, Trip Updates (History of installed updates), Vampire Drain, Visited (Lifetime driving map). 仪表盘 点击下方链接可查看内置仪表盘的示例截图。 电池健康度、充电电量、充电记录（增加/使用的能量）、充电详情、充电统计、数据库信息、驾驶统计、行程（距离/消耗的净能量）、驾驶详情、能效（净/总消耗）、位置（地址）、里程概览、预计续航（电池衰减）、状态（查看车辆何时在线或休眠）、统计数据、时间轴、行程更新（已安装更新的历史记录）、“吸血”耗电、足迹（终身驾驶地图）。

Screenshots Sneak peak into TeslaMate interface and bundled dashboards. See the docs for additional screenshots. 截图 TeslaMate 界面和内置仪表盘预览。更多截图请参阅文档。

License TeslaMate is licensed under the GNU Affero General Public License v3.0 (AGPLv3). This license is designed to ensure that TeslaMate remains free and open for everyone. By using, modifying, or building upon this project, you agree to the following: 许可协议 TeslaMate 采用 GNU Affero 通用公共许可证 v3.0 (AGPLv3) 授权。该许可证旨在确保 TeslaMate 对所有人保持免费和开源。通过使用、修改或基于此项目进行开发，即表示您同意以下条款：

Reciprocal Sharing (Copyleft): If you modify TeslaMate or incorporate it into another project, you must release the entire source code of your version under the same AGPLv3 license. Universal Access to Source: This requirement applies regardless of how you provide the software to others—whether you distribute it as a downloadable application (e.g., in an App Store), as a pre-packaged image, or provide access to its functionality via a network service (SaaS). No Closed-Source Derivatives: We do not permit the use of TeslaMate or its components in closed-source commercial products. If your software interacts with or relies on TeslaMate, it must be open-source. If you build upon this project, you are expected to contribute back to the community. For the full legal terms, please refer to the LICENSE file. 互惠共享（Copyleft）： 如果您修改了 TeslaMate 或将其整合到另一个项目中，您必须在相同的 AGPLv3 许可证下发布您版本的全部源代码。 源代码的普遍访问权： 无论您以何种方式向他人提供软件，此要求均适用——无论是作为可下载应用程序（例如在 App Store 中）分发、作为预打包镜像分发，还是通过网络服务（SaaS）提供其功能访问。 禁止闭源衍生品： 我们不允许在闭源商业产品中使用 TeslaMate 或其组件。如果您的软件与 TeslaMate 交互或依赖于它，则该软件必须开源。如果您基于此项目进行开发，我们期望您能回馈社区。有关完整的法律条款，请参阅 LICENSE 文件。

Key Requirements: Copyleft: If you modify TeslaMate and distribute it (e.g., as an app, binary, or package) or offer it as a service over a network (SaaS), you must make your modified source code available to all users under the same AGPLv3 license. No “Closed” Forks: This license ensures that improvements made by commercial entities or third parties remain open to the entire community. Attribution: You must keep all original copyright notices and license information intact. Trademark Policy: The use of the TeslaMate name and logo is governed by our Trademark Policy. Contributions: All contributors must sign our Contributor License Agreement. This is handled via cla-assistant.io automatically on first PR and does not take long. Why do we need this? It guarantees that TeslaMate will always remain Free Software (AGPL-3.0) and allows the teslamate-org to legally defend the project against license violations. 关键要求： Copyleft： 如果您修改了 TeslaMate 并进行分发（例如作为应用程序、二进制文件或软件包），或通过网络提供服务（SaaS），则必须在相同的 AGPLv3 许可证下向所有用户提供修改后的源代码。 禁止“闭源”分支： 此许可证确保商业实体或第三方所做的改进对整个社区保持开放。 署名： 您必须保留所有原始版权声明和许可信息。 商标政策： TeslaMate 名称和徽标的使用受我们的商标政策约束。 贡献： 所有贡献者必须签署我们的贡献者许可协议。这会在首次提交 PR 时通过 cla-assistant.io 自动处理，过程非常快捷。 为什么需要这些？ 这保证了 TeslaMate 将始终保持为自由软件（AGPL-3.0），并允许 teslamate-org 在法律上捍卫该项目，防止许可证违规行为。

Star History Credits Initial Author: Adrian Kumpf List of Contributors: Star History（星标历史） 致谢 初始作者：Adrian Kumpf 贡献者名单：