ghcr.io/wjsall/teslamate-chinese-dashboards:sha-ae74cf9

TeslaMate 全中文版 Grafana 仪表盘

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

和官方原版的差异：

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

英文用户：这是针对中文特斯拉车主的本地化版本。原始项目请参见 https://github.com/teslamate-org/teslamate%E3%80%82

---

你是谁？怎么走？

---

⚡ 升级到 v1.6.x — 分时电价 + 性能索引（中文版独有）　点开看 4 种升级方法 ▼

v1.5.0 起的中文版独有功能：

• 🆕 「⚡ 分时电价配置」仪表盘 — 在线配置峰平谷电价 + 配置审计 + 24 小时电价分布
• 🆕 「🏆 充电桩性价比榜」仪表盘 — 按 ¥/度 排序所有充电点
• 🌡️ 「天气-能耗关联」仪表盘（v1.6.0）— 国内 #1 痛点「冬天到底掉多少电」量化版
• 🚀 positions 表性能索引（v1.6.1）— 电池健康/行程列表/能耗聚合等查询从 200ms 降到 <20ms（大数据量用户必升）
• 🔧 9 个仪表盘 60+ 处 SQL 自动适配分时电价
• 没装分时电价的用户无任何感知差异（所有面板回退到原 cp.cost）

按你当时怎么装的，选一种：

你之前怎么装的？	用哪个
没装过（全新用户）	跳到下方 快速开始
官方源（grafana 是 teslamate/grafana）	方法 D
跟 jheredianet 教程装的（手动 import dashboard JSON）	方法 D — 但先 export 你改过的 dashboard JSON 备份，迁移会用我们这一套替换
用了我们的 simple-deploy.sh	方法 A
git clone 了我们仓库	方法 B
自己写 docker-compose 套了我们镜像	方法 C

方法 A — 一键脚本用户（之前用 simple-deploy.sh 装的）

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

脚本自动检测现有安装 → 切升级模式（拉新镜像 + 装新 SQL 函数 + 重启 Grafana）。不会重置 ENCRYPTION_KEY 或配置。

方法 B — git clone 用户（之前 git clone 仓库装的）

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

自动 7 步：git pull → 检测 PG → 装地图函数 → 装分时电价 → 装性能索引（v1.6.1+）→ 检查 Grafana 插件 → 重启 Grafana。重复跑不会丢数据。

方法 C — 手动派（自己写 docker compose 套了我们镜像的）

# 1. 拉新镜像（带 volkovlabs-form-panel 插件 + 45 个仪表盘 — 该插件给「⚡ 分时电价配置」面板提供按钮交互）
docker compose pull && docker compose up -d

# 2. 装 SQL 三件套（坐标函数 + 分时电价 + 性能索引，远程 curl 不用 git clone）

# 默认用 main（跟 :latest 镜像同步）。担心仓库被劫持的话把 main 替换成具体 tag（如 v1.6.2）锁版本：
REF=main # 或 v1.6.2

# 自动找 database 容器名（你的项目目录不叫 teslamate 时容器名会不同，直接 ps 拿）
DB=$(docker compose ps -q database)
[ -z "$DB" ] && { echo "❌ database 容器没起来，先跑 docker compose up -d 再来"; exit 1; }

for f in install-coord-functions install-tou install-indexes; do
curl -fsSL "https://raw.githubusercontent.com/wjsall/teslamate-chinese-dashboards/${REF}/sql/${f}.sql" \
| docker exec -i "$DB" psql -U teslamate -d teslamate
done

# 3. 重启 Grafana
docker compose restart grafana

Watchtower 自动升镜像的用户每次升级后只需要重跑这一段就能拿到最新 SQL 改动（函数 / 索引 / TOU）。脚本是 IF NOT EXISTS / CREATE OR REPLACE，重跑零风险。详见 SQL 远程拉取的安全注意。

方法 D — 从官方源迁移（你以前是 teslamate/grafana）

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

脚本预检 docker daemon + compose CLI（v1/v2 都识别）→ 找 docker-compose.yml（含 v2 新 compose.yml）→ 备份（mode 600，含 ENCRYPTION_KEY）→ 改 grafana 镜像 → 拉新镜像 → 探测 database 容器名 → 装 SQL。TeslaMate / Postgres / MQTT 完全不动，ENCRYPTION_KEY 和数据 0 丢失。脚本结尾会打印一行 cp + $DC up -d 的回滚命令，复制粘贴即可回去。

⚠️ 在 Grafana 里手动改过 dashboard 的，先到「仪表盘 → ⋮ → Export」备份 JSON，迁移完再 Import 回来 —— 我们的镜像会用我们这一套覆盖。

配分时电价（可选，约 3 分钟）

bash scripts/tou-wizard.sh # 5 步交互式向导（git clone 用户）

或直接打开「⚡ 分时电价配置」仪表盘 →「🌆 一键导入城市模板」选你城市，配完点「🔄 重算所有历史充电」按钮把历史按分时电价重算。

升级前必读：先备份

任何升级（含 v1.6.x → v1.6.x、PG 大版本升级）前都强烈建议先做完整数据库备份：

docker compose exec -T database pg_dump -U teslamate teslamate
> backup_$(date +%Y%m%d).sql

详见 TeslaMate 官方 backup_restore + 我们的 TROUBLESHOOTING「整机迁移」。

想定期自动备份？一键安装（simple-deploy.sh）装时/升级时会让你三选一：含密钥（推荐，能独立恢复）/ 不含密钥 / 否，通用 Linux 自动写好 crontab、群晖给 DSM 步骤。脚本是 scripts/backup.sh（导出失败自动中止、绝不删除已有备份、自动保留最近 N 份），默认连含密钥的配置一起备份让备份能独立恢复（不必手抄 ENCRYPTION_KEY；备份目录请保持私密）。手动设置见 TROUBLESHOOTING.md「定期自动备份数据库」。

升级出问题？完全可逆

TeslaMate 任何表都没动，分时电价数据全在我们新建的旁路表。详见 TROUBLESHOOTING.md「v1.5.0 分时电价升级排错 / 回滚」 | *** 交流群

v1.6.6+ 升级提示

v1.6.6 修复了备份恢复跟 TeslaMate 官方流程不对齐的真 bug（缺 DROP SCHEMA private + CREATE EXTENSION cube）。如果你做过整机迁移且遇到 token 解密失败被迫重新授权过——那就是这个 bug，新版恢复流程不会再触发。详见 https://github.com/wjsall/teslamate-chinese-dashboards/releases/tag/v1.6.6%E3%80%82

---

🚗 基于 https://github.com/teslamate-org/teslamate 项目的 Grafana Dashboard 汉化版本

📖 原版文档: [***]

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

📸 效果预览

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

国内特斯拉车主 #1 痛点「冬天到底掉多少电」量化版 — 温度桶能耗曲线柱色冷蓝→热红，一眼看出「16°C 最省 / 38°C 最费」的 U 型规律 + 月度双轴 + 季节对比。

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

「⚡ 分时电价配置」 — 24 小时电价柱图自动配色（绿=谷 / 黄=平 / 橙=峰）+ 配置审计 + 5 步交互式向导

「🏆 充电桩性价比榜」 — 按 ¥/度 排序所有充电点（家充走分时电价、第三方走原价）+ 30 天涨/降价对比 + 充电桩地图

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

仪表盘顶部下拉框秒切 6 种瓦片源（OSM / 高德 / 高德卫星 / 谷歌 / 谷歌卫星 / Carto）。选高德或谷歌路网时 PostgreSQL 函数自动做 WGS-84 → GCJ-02 转换，车辆轨迹精准贴合道路。

🆕 原创分析仪表盘

年度驾驶报告 — 年度里程 / 充电 / 能耗 / 常去地点 TOP10

省*分析** — 与燃油车对比节省金额、充电时段分布、预算进度

充电健康管理 — 充电习惯评分、SOC 分布、充电次数趋势

停车掉电分析 — 掉电趋势、区间分布、最耗电停车 TOP20

出行规律分析 — 时段分布、工作日 vs 周末、温度与能耗关系

动能回收分析 — 各固件版本回收率对比、每日/每周回收能量、温度影响

多车对比 — 名下所有车辆里程/能耗/费用/电池健康横向对比，自动适配车辆数量

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

驾驶评分 — 效率/平稳/速度/回收四维度评分、驾驶风格判定、行程明细与数据汇总

---

核心仪表盘

---

🎯 特点

• ✅ 开箱即用 - 无需 Docker Hub 账号，直接挂载使用
• ✅ 一键安装 - 提供多种安装方式，5分钟完成部署
• ✅ 持续更新 - 通过 git pull 即可获取最新汉化
• ✅ 深度汉化 - 45 个 Dashboard，含12 个全新原创分析图表
• 🌏 地图源一键切换（独有） - 9 个含地图仪表盘顶部加 OSM / 高德 / 高德卫星 / 谷歌 / 谷歌卫星 / Carto 下拉框，秒切，自动 GCJ-02 坐标纠偏（v1.4.2+）
• 国内用户告别手动改 SQL，海外华人用户也能用谷歌中文路网
• ✅ 完整适配 TeslaMate 3.0 - 同步官方全部新特性，已验证兼容 Grafana 12.4.0

📊 汉化成果

🚀 快速开始

按你的场景三选一：

方法一：一键脚本（推荐 ⭐）

适合人群：第一次安装 TeslaMate 的用户、希望最快查看车辆数据的用户。

安装后可获得：

• TeslaMate http://你的IP:4000 — 粘贴 Tesla token 后开始记录数据
• Grafana http://你的IP:3000 — 45 个中文仪表盘开箱即用（行驶/充电/电池/多车/年度报告等）
• 终端会打印 3 个密码（Grafana/数据库/加密 key），请记录到密码管理器中

前提条件：

• 一台持续运行的设备（家用 NAS/云 VPS 1GB+内存/个人电脑均可）
• 终端：Linux/macOS 自带终端；Windows 需使用 WSL2 或 Git Bash
• 未安装 Docker 也可 — 脚本检测到未安装时会自动安装（适用于主流 Linux 发行版）
• Tesla 账号 + 手机已安装 https://github.com/adriankumpf/tesla_auth/releases%EF%BC%88%E7%94%A8%E4%BA%8E%E8%8E%B7%E5%8F%96 token）

执行：

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

安装后操作：

1. 在浏览器中打开 http://你的IP:4000，粘贴 Tesla access_token 和 refresh_token 绑定车辆
2. 等待几分钟数据同步（首次拉取历史数据可能较慢）
3. 在浏览器中打开 http://你的IP:3000，通过左侧导航查看「TeslaMate」分类下的所有仪表盘
4. 国内用户在「足迹地图」/「驾驶记录追踪」顶部下拉菜单中切换为「高德地图」，轨迹将精准贴合道路

遇到问题：请先查阅 TROUBLESHOOTING.md，常见安装后无法启动的原因（端口冲突/Docker 启动失败/Tesla token 被拒绝）均有说明。

方法二：替换已有原版 TeslaMate 的 Grafana 镜像

适合已在使用原版英文 TeslaMate 并希望切换为中文版的用户。需修改两处配置并清除旧数据卷：

# 原 docker-compose.yml 的 grafana service 改两处：
grafana:
image: bswlhbhmt816/teslamate-chinese-dashboards:latest # ← 改镜像（原 teslamate/grafana:latest）
environment:
- DATABASE_USER=teslamate
- DATABASE_PASS=password
- DATABASE_NAME=teslamate
- DATABASE_HOST=database
- GF_USERS_DEFAULT_LANGUAGE=zh-Hans # ← 加这一行
# ports / volumes / restart 保持原样

[!WARNING] 必须清除旧 Grafana 数据卷（不影响行车记录数据，该数据存储在独立的 teslamate-db 卷中）：

docker compose stop grafana
docker volume rm teslamate_teslamate-grafana-data
docker compose pull grafana
docker compose up -d grafana

方法三：手动挂载 Dashboard 文件（进阶）

适合需要完全控制 docker-compose.yml 的用户（如自定义部署/老版 Grafana 升级场景）。

[!IMPORTANT] 版本要求：部分仪表板使用 schemaVersion 41，需要 Grafana 12+（对应 TeslaMate Grafana 镜像 3.0.0+）。

services:
grafana:
image: teslamate/grafana:latest
volumes:
- ./teslamate-chinese-dashboards/grafana/dashboards/zh-cn:/dashboards:ro
- ./teslamate-chinese-dashboards/grafana/dashboards/internal:/dashboards_internal:ro
environment:
- GF_USERS_DEFAULT_LANGUAGE=zh-Hans

git clone https://github.com/wjsall/teslamate-chinese-dashboards.git
docker compose restart grafana

[!WARNING] internal/ 必须挂载到 /dashboards_internal/（带下划线），否则行程详情/充电详情将仍显示英文。

🇨🇳 中国大陆用户：镜像拉取失败

ghcr.io 在中国大陆访问时常超时。本项目镜像双源同步：

• ✅ Docker Hub：bswlhbhmt816/teslamate-chinese-dashboards:latest（国内访问更稳定）
• ⚠️ ghcr.io：ghcr.io/wjsall/teslamate-chinese-dashboards:latest（备用地址）

默认使用 Docker Hub（方法一的脚本已默认选择 Docker Hub，方法二/三需手动指定）。

若 Docker Hub 访问也较慢，可配置镜像代理：

sudo tee /etc/docker/daemon.json ⚠️ 以上**仅更新 Grafana 镜像和仪表盘**。若某版本改动了 SQL（如坐标函数/分时电价/索引），还需重新安装 SQL 三件套，否则分时电价/地图等面板会报错 —— 一键安装用户直接重新执行 `simple-deploy.sh`（自动进入升级模式安装 SQL），其他用户请参见上方 [升级方法 A/B/C/D](#upgrade-v16)。纯仪表盘版本（如 v1.7.9）仅需执行上述两条命令即可。

> [!WARNING] 如果更新后 Dashboard 仍显示旧版本，说明 Grafana 数据卷存在缓存残留，执行以下命令重置（车辆数据不受影响）：
>
```bash
> docker compose stop grafana
> docker volume rm teslamate_teslamate-grafana-data
> docker compose up -d grafana
>

使用挂载方式

cd teslamate-chinese-dashboards
git pull
docker compose restart grafana

支持系统：

• ✅ Linux (Ubuntu/CentOS/Debian等)
• ✅ macOS (Intel/Apple Silicon)
• ✅ Windows (WSL2)
• ✅ 树莓派 (ARM64)

📚 相关链接

原版项目

• GitHub: https://github.com/teslamate-org/teslamate
• 官方文档: https://docs.teslamate.org
• 原版 Grafana Dashboards: https://github.com/teslamate-org/teslamate/tree/master/grafana/dashboards

帮助文档

• 安装指南: https://docs.teslamate.org/docs/installation/docker
• 常见问题: https://docs.teslamate.org/docs/faq
• 升级指南: https://docs.teslamate.org/docs/upgrading
• 环境变量: https://docs.teslamate.org/docs/configuration/environment_variables

本汉化项目

• 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 - 项目发起人、主要汉化
• 社区贡献者 - 翻译校对、建议反馈

如何成为贡献者?

我们欢迎任何形式的贡献:

• 🌐 翻译改进
• 🐛 问题反馈
• 📝 文档完善
• 💡 功能建议
• ⭐ 给项目点 Star

查看贡献指南

🤝 贡献指南

欢迎提交 Issue 和 PR 改进汉化质量！

如何贡献

1. Fork 本项目
2. 修改 Dashboard JSON 文件

• 文件位置: grafana/dashboards/zh-cn/

3. 提交 PR

• 说明修改内容和原因
• 确保 JSON 格式正确

翻译规范

• 使用简体中文
• 保持专业术语准确性
• 参考特斯拉官方中文术语

📄 License

MIT License - 与 TeslaMate 项目相同

🙏 致谢

• 原始汉化: wjsall
• 整理优化: Claude AI
• 验证测试: 自动化脚本
• 原始项目: https://github.com/teslamate-org/teslamate
• 英文 Dashboard 参考: https://github.com/jheredianet — https://github.com/jheredianet/Teslamate-CustomGrafanaDashboards%EF%BC%8C%E9%83%A8%E5%88%86%E9%9D%A2%E6%9D%BF%E5%AE%9E%E7%8E%B0%E9%80%BB%E8%BE%91%E5%8F%82%E8%80%83%E8%87%AA%E5%85%B6%E5%8E%9F%E7%89%88%E8%AE%BE%E8%AE%A1

💬 问题反馈

• GitHub Issues: https://github.com/wjsall/teslamate-chinese-dashboards/issues

---

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

---

💰 支持项目

业余时间 1 个人维护。最有用的支持是 ⭐ Star、https://github.com/wjsall/teslamate-chinese-dashboards/issues%E3%80%81%E5%8A%A0 *** 群 帮其他车主装好。

谢谢你 ❤️