ghcr.io/wjsall/teslamate-chinese-dashboards:candidate-37121301350

TeslaMate 全中文版 Grafana 仪表盘

目录

• 你是谁？怎么走？
• ⚡ 升级到最新版
• 📸 效果预览
• 🎯 特点
• 📊 汉化成果
• 📚 使用文档
• 📁 包含的仪表盘
• 🚀 快速开始
• 🔧 故障排除
• 📦 镜像信息
• 🇨🇳 中国大陆用户专项配置
• 🔒 SQL 远程拉取的信任模型
• 🛠️ 系统要求
• 📚 相关链接
• 👏 贡献者
• 🤝 贡献指南
• 📄 License
• 🙏 致谢
• 💬 问题反馈
• 💰 支持项目

面向中国 Tesla 车主的 TeslaMate 数据可视化方案 — 46 个深度汉化仪表盘 + 国内地图源 + 分时电价 + Docker 一键部署。

和官方原版的差异：

• 🌏 国内可用 — 9 个地图面板支持高德/谷歌切换，自动 GCJ-02 坐标纠偏（轨迹精准贴合道路）
• ⚡ 分时电价系统 — 为收藏点（Geofence，数据库中称地理围栏）配置峰平谷电价 + 充电桩性价比榜 + 重算历史充电（v1.5.0+）
• 📊 13 个原创分析仪表盘 — 年度驾驶报告 / 省***分析 / 充电健康管理 / ⚡ 行车 vs 停车耗电（月度）/ 出行规律分析 / 动能回收分析 / 驾驶评分 / 胎压 / 多车对比等
• 🆕 2 个上游精选移植（v1.7.0）— 回本分析（电车比油车几年回本）/ 速度温度热力图
• 🇨🇳 本地化优化 — Docker Hub 镜像直拉无墙、PostgreSQL 与 Grafana 版本跟齐官方
• ✅ 开箱即用 — 执行 bash simple-deploy.sh 即可在 5 分钟内完成安装，自动检测云主机并进行安全加固。

English speakers: this is a localization for Chinese-speaking Tesla owners. For the original project see https://github.com/teslamate-org/teslamate.

---

你是谁？怎么走？

---

⚡ 升级到最新版

升级前请先按照 数据库备份与恢复 完成全量备份。之后仅根据你的原始安装方式执行对应升级路径，不要交叉混用 A、B、C 三类方法。

方法 A — 一键脚本用户

curl -fsSL https://raw.githubusercontent.com/wjsall/teslamate-chinese-dashboards/main/simple-deploy.sh | bash

脚本会识别现有安装环境并自动进入升级模式：拉取镜像、更新四组 SQL 对象、检查 volkovlabs-form-panel 插件并重启 Grafana；不会重置 ENCRYPTION_KEY 或其他原有配置。镜像与 SQL 默认锁定为同一个最新正式版本（可通过 TARGET_REF 切换发布通道，详见 SQL 远程拉取的信任模型）。关于安装或升级时的自动备份选项（含密钥 / 不含密钥 / 不启用备份，以及群晖 DSM 相关设置），请参考 定期自动备份数据库。

方法 B — git clone 用户

cd teslamate-chinese-dashboards
bash scripts/upgrade.sh

脚本会依次执行 git pull、PostgreSQL 环境检测、四组 SQL 对象更新、Grafana 插件校验和 Grafana 重启；支持重复执行，不会清空现有数据。

方法 C — 自定义 Compose / Watchtower 用户

docker compose pull && docker compose up -d

该命令仅执行镜像更新。若新版本涉及 SQL 变更，请再执行唯一的 四个 SQL 安装文件修复循环；它会自动探测 database 容器，任意文件执行失败都会立即终止流程，完成后自动重启 Grafana。Watchtower 同样仅替换镜像，因此也需要补充执行该步骤。纯仪表盘版本（例如 v1.7.10）仅更新镜像即可。

[!NOTE] 如果你的 Compose 配置将仪表盘目录挂载进了容器（例如 ./…/dashboards/zh-cn:/dashboards），仅更新镜像不会更新仪表盘内容：容器读取的是挂载目录中的旧文件，不会显示新增页面，且不会抛出任何报错。这种场景下，升级后需要将挂载目录内的 JSON 文件同步为新版本内容（使用 git clone 方式部署的用户执行 git pull 即可），目录对应关系为 zh-cn/ → /dashboards、internal/ → /dashboards_internal，完成后重启 Grafana 即可。远程 SQL 的版本锁定与信任边界详见 SQL 远程拉取的信任模型。

方法 D — 从官方 TeslaMate 迁移

curl -fsSLO https://raw.githubusercontent.com/wjsall/teslamate-chinese-dashboards/main/migrate-from-official.sh
bash migrate-from-official.sh

migrate-from-official.sh 是唯一官方推荐的正常迁移入口。它会预先检查 Docker daemon 与 Compose CLI（v1/v2）环境，查找 docker-compose.yml / compose.yml 配置文件，以 600 权限备份包含 ENCRYPTION_KEY 的配置，之后替换 Grafana 镜像、探测 database 容器并安装四组 SQL 对象；迁移过程中 TeslaMate、PostgreSQL、MQTT 和车辆数据均不会被改动。镜像与 SQL 默认锁定为同一个最新正式版本（可通过 TARGET_REF 切换发布通道，规则与 simple-deploy.sh 一致）。脚本执行结束后会输出可直接使用的 cp + $DC up -d 回滚命令。

如果你曾手动修改过仪表盘，迁移前请先在 Grafana 中进入「仪表盘 → ⋮ → Export」导出 JSON 文件；迁移流程会加载本项目的对应版本。仅当脚本无法正常运行时，才可使用 手动迁移兜底方案。

分时电价为可选功能，升级完成后请参照 快速入门的分时电价配置 进行操作。该功能内置城市模板、交互式向导、历史回算和回滚入口；未完成配置时，费用面板会继续沿用原有的 cp.cost 字段数据。升级故障与完全回滚方案参见 分时电价升级排错 / 回滚。v1.6.6 版本修复了旧版恢复流程缺失 DROP SCHEMA private 与 CREATE EXTENSION cube 导致的 Token 解密失败问题，相关背景说明与当前标准操作流程参见 数据库备份与恢复。

---

🚗 基于 https://github.com/teslamate-org/teslamate 项目开发的 Grafana 仪表盘汉化版本

📖 原版文档地址: [***]

🙏 早期汉化工作参考自 GitHub 用户 https://github.com/dhuar 的私有镜像 ccr.ccs.tencentyun.com/dhuar/grafana:latest，在此特别致谢

📸 效果预览

🌡️ v1.6.0 新增：天气-能耗关联

国内特斯拉车主最关心的「冬季实际掉电水平」量化展示版本 — 温度区间能耗曲线柱图配色从冷蓝渐变至热红，可直观呈现「16°C 能耗最低 / 38°C 能耗最高」的 U 型规律，同时支持月度双轴对比与季节维度对比。

⚡ v1.5.0 重磅功能：分时电价系统 + 充电桩性价比榜

「⚡ 分时电价配置」 — 24 小时电价柱图自动配色（绿色=谷段 / 黄色=平段 / 橙色=峰段），配套配置审计功能，所有写操作提交前会弹出二次确认；其中「全局默认」规则会应用到未关联收藏点、位置信息缺失的充电记录。

「🏆 充电桩性价比榜」 — 按单位电价（¥/度）对充电点排序（家充自动套用分时电价、第三方充电点使用原始电价），支持 30 天电价涨跌对比，配套充电桩分布地图；统计维度按收藏点聚合，同名地点不会被错误合并。

🌏 v1.4.2 重磅功能：地图源一键切换 + 自动 GCJ-02 坐标纠偏

仪表盘顶部下拉框可快速切换 6 种瓦片源（OSM / 高德 / 高德卫星 / 谷歌 / 谷歌卫星 / Carto）。选择高德或谷歌路网时，PostgreSQL 函数会自动完成 WGS-84 到 GCJ-02 的坐标转换，车辆轨迹可精准贴合实际道路。

🆕 原创分析仪表盘

年度驾驶报告 — 自动动态生成年份维度数据并跟随所选年份更新，汇总里程、充电、能耗、常去地点 TOP10 统计，自动排除未完成的记录。

省*分析** — 采用「行驶能耗 × 同期平均电价」的能量匹配口径估算用电成本，并与同级别燃油车做使用成本对比；缺少电价数据时面板显示 No data。

充电健康管理 — 包含充电习惯评分、SOC 分布统计、充电次数趋势；仅统计已完成且充电量 ≥1 kWh 的有效充电记录。

「⚡ 行车 vs 停车耗电（月度）」 — 统计每月行车电耗与停车耗电，并进一步拆分醒着状态与休眠状态下的停车耗电；该停车耗电口径不等同于哨兵模式耗电。

出行规律分析 — 支持时段分布、工作日 vs 周末出行差异、温度与能耗关联等维度统计。

动能回收分析 — 可对比不同固件版本下的回收率、每日/每周回收能量数值，以及温度对动能回收的影响。

多车对比 — 对名下所有车辆的里程、能耗、费用、电池健康数据做横向对比，自动适配车辆数量无需手动调整。

续航退化分析 — 包含满电续航趋势、线性回归退化率计算、月度统计、数据质量监控功能。

驾驶评分 — 从效率、平稳度、速度、回收四个维度评分，支持判定驾驶风格，配套行程明细与全量数据汇总。

---

核心仪表盘

---

🎯 特点

• ✅ 开箱即用 - 无需注册 Docker Hub 账号，直接挂载即可使用
• ✅ 一键安装 - 提供多种安装方式，5 分钟即可完成部署
• ✅ 持续更新 - 通过 git pull 即可获取最新汉化内容
• ✅ 深度汉化 - 覆盖 46 个仪表盘，包含 13 个全新原创分析图表
• 🌏 地图源一键切换（独有功能） - 在 9 个包含地图的仪表盘顶部新增 OSM / 高德 / 高德卫星 / 谷歌 / 谷歌卫星 / Carto 下拉选择框，可秒级切换，自动完成 GCJ-02 坐标纠偏（v1.4.2+ 版本支持）
• 国内用户无需手动修改 SQL，海外华人用户也可正常使用谷歌中文路网
• ✅ 完整适配 TeslaMate 4.3 - 同步官方仪表盘更新，已通过 TeslaMate v4.3.0 数据库结构验证（本项目镜像内置 Grafana 13.2.2）

📊 汉化成果

46 个仪表盘已完成深度汉化，持续优化迭代中，开箱即可正常使用！ 🎉

📚 使用文档

我们为你准备了五份详细的使用指南：

新手推荐阅读顺序：先阅读「新手向导」→ 「功能地图」→「场景速查手册」→「数据指标手册」

📁 包含的仪表盘

46 个仪表盘 按主题归类到电池、充电、驾驶、位置、车辆状态、原创分析、系统信息等分类下。完整功能列表与字段映射关系请参考 → DASHBOARD_MAP.md

• 新增：历史温度 — 可查看车内、车外、充电期间和每日环境温度范围，用于回溯温度变化情况。

🚀 快速开始

安装流程仅在 QUICKSTART 文档中维护，本 README 不再重复罗列对应命令。请根据你的实际场景跳转至对应章节查看详细指引。

中国大陆镜像拉取失败时，直接走 故障排查中的镜像修复；不要在多份安装文档间复制镜像源配置。

🔧 故障排除

完整故障排查手册 → TROUBLESHOOTING.md（覆盖部署 / 仪表盘显示 / 数据 / Tesla 授权 / 升级 / 中国大陆专项等常见问题）

📦 镜像信息

三种 tag 语义不同，装之前先分清楚：

（latest 曾经被 main 分支的每次 push 覆盖，v1.8.4 之前的镜像存在 latest 与正式版 tag digest 不一致的情况；这个问题已在 CI 配置里修正，latest 现在只在打正式 tag 时更新。）

一键脚本 / 迁移脚本默认走这样的组合：镜像写 latest（docker compose pull 之后能持续跟着新版本走，不会停在安装时的版本），SQL / 配套脚本锁定安装当下自动解析出的最新正式 Release 具体版本号（如 v1.8.4），保证这次装的 SQL 一定和这次装的镜像内容匹配；也可以用 TARGET_REF 显式切通道（钉死到指定版本，或切到 main 滚动通道），详见 SQL 远程拉取的信任模型。

🇨🇳 中国大陆用户专项配置

TeslaMate 3.0 起，国内账号通常什么都不用改。登录方式是粘贴 Access Token / Refresh Token（推荐用 https://github.com/adriankumpf/tesla_auth/releases 获取，由 TeslaMate 主作者维护，跨平台），TeslaMate 会从 token 自动识别中国区，所有 API/streaming 请求自动走 *.cloud.tesla.cn。详见 QUICKSTART.md 第四步。

镜像拉取慢或失败时，直接按 中国大陆镜像修复 选择 Docker Hub、镜像代理、网络代理或离线导入；可复用配置仅在该修复锚点维护。

[!WARNING] 国内用户高频踩坑：行程列表地址列空

TeslaMate 的反向地理编码使用 OpenStreetMap Nominatim，国内访问时常超时，导致大量行驶记录的 start_address_id 为 NULL，行程列表地址列为空。修复方法是新增一行 NOMINATIM_PROXY 环境变量（仅代理 Nominatim 流量，不影响 Tesla API）：

services:
  teslamate:
    environment:
      - TZ=Asia/Shanghai
      # 国内用户强烈推荐：让 Nominatim 反查走代理（仅支持 HTTP，只需一行，详见下方链接）
      # - NOMINATIM_PROXY=http://你的代理IP:7890
      # 仅当你使用自建 Fleet API 网关 / 反向代理时才需要配置：
      # - TESLA_API_HOST=https://your-proxy.example.com
      # - TESLA_WSS_HOST=wss://your-proxy.example.com

NOMINATIM_PROXY 完整说明、排错命令及代理地址填写指引：TROUBLESHOOTING.md「Nominatim 国内反查超时」。

完整环境变量参考：TeslaMate 官方文档

🔒 SQL 远程拉取的信任模型

升级路径会从 GitHub 拉取四个 SQL 安装文件并交给 psql 执行。simple-deploy.sh / migrate-from-official.sh 内置 TARGET_REF 开关，默认自动解析最新正式 Release，让镜像 tag 和 SQL 版本锁定在同一个 ref 下（不会出现"正式版镜像 + main 分支未发布 SQL"的不匹配组合）；也支持通过 TARGET_REF=v1.8.4 锁定到指定版本，或用 TARGET_REF=main 切换到滚动构建通道。

脚本在确定版本号之后，还会下载并运行该正式版本的同名脚本，确保安装逻辑、SQL、镜像三者来自同一次发布；如果你想先审阅脚本再运行，可执行 TESLAMATE_CN_PINNED=1 bash simple-deploy.sh 跳过这步自动拉取更新脚本的流程。

三条通道详情、优先级规则、版本号解析失败的处理方案、传输安全与维护者风险说明，以及第三方/自建镜像的信任边界见 故障排查手册：SQL 远程拉取的信任模型。

🛠️ 系统要求

• Docker 20.10+
• Docker Compose 2.0+
• PostgreSQL 技术最低版本为 16，官方推荐 18（官方默认使用 postgres:18-trixie）
• PG 15 已经支持三参数 date_trunc(text, timestamptz, text)；本项目要求 PG 16 的原因是用到了四参数 generate_series(timestamptz, timestamptz, interval, timezone)。
• 只有当报错函数签名明确指向该四参数 generate_series 时，才按 TROUBLESHOOTING.md「PostgreSQL 大版本升级」 规划升级；不要仅因 date_trunc 报错就升级。
• 内存: 2GB+
• 磁盘: 10GB+

支持系统：

• ✅ Linux（Ubuntu/CentOS/Debian 等）
• ✅ macOS（Intel/Apple Silicon）
• ✅ Windows（WSL2）
• ✅ 树莓派 ARM64（64 位系统） —— TeslaMate v4.0 起已停止 ARMv7（32 位）支持，老旧树莓派（Pi 3/4 搭载 32 位系统）需要刷入 64 位系统才能升级到 v4.0+

📚 相关链接

原版项目

• GitHub: https://github.com/teslamate-org/teslamate
• 官方文档: [***]
• 原版 Grafana 仪表盘: https://github.com/teslamate-org/teslamate/tree/master/grafana/dashboards

帮助文档

• 安装指南: [***]
• 常见问题: [***]
• 升级指南: [***]
• 环境变量: [***]

本汉化项目

• GitHub: https://github.com/wjsall/teslamate-chinese-dashboards
• 问题反馈: https://github.com/wjsall/teslamate-chinese-dashboards/issues
• 中文文档: https://github.com/wjsall/teslamate-chinese-dashboards

👏 贡献者

感谢以下贡献者的辛勤付出：

主要贡献者

• https://github.com/wjsall - 项目发起人、主要汉化工作
• 社区贡献者 - 翻译校对、建议反馈

🤝 贡献指南

欢迎提交 Issue 和 PR 来改进汉化质量！问题报告、翻译流程、术语表、翻译原则、禁止事项、本地测试、验证清单和 PR 格式均以 CONTRIBUTING.md 为准。

📄 许可证

MIT License - 与 TeslaMate 项目保持一致

🙏 致谢

• 原始汉化: wjsall
• 整理优化: Claude AI
• 验证测试: 自动化脚本
• 原始项目: https://github.com/teslamate-org/teslamate
• 英文仪表盘参考: https://github.com/jheredianet — https://github.com/jheredianet/Teslamate-CustomGrafanaDashboards，部分面板实现逻辑参考自其原版设计

💬 问题反馈

• 请先运行 诊断脚本 或复制 AI 安全排障提示，仅附上脱敏后的最小有效信息。
• GitHub Issues: https://github.com/wjsall/teslamate-chinese-dashboards/issues

---

如果本项目对你有帮助，请给个 ⭐ Star！

---

💰 支持项目

项目由个人利用业余时间维护。你能提供的最有价值的支持就是点个 ⭐ Star、https://github.com/wjsall/teslamate-chinese-dashboards/issues，加入 *** 群 帮助其他车主顺利完成安装。

谢谢你 ❤️