ghcr.io/wjsall/teslamate-chinese-dashboards:sha-93427df

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 分钟装好，自动检测云主机并加固安全

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

---

你是谁？怎么走？

---

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

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

• 🆕 「⚡ 分时电价配置」仪表盘 — 在线配置峰平谷电价 + 配置审计 + 24 小时电价分布
• 🆕 「🏆 充电桩性价比榜」仪表盘 — 按 ¥/度 排序所有充电点
• 🌡️ 「天气-能耗关联」仪表盘（v1.6.0）— 国内 #1 痛点「冬天到底掉多少电」量化版
• 🚀 positions 表性能索引（v1.6.1）— 电池健康/行程列表/能耗聚合等查询从 200ms 降到 9ms
• 🔧 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 的回滚命令，复制粘贴即可回去。

[!IMPORTANT] 在 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

🚀 快速开始

按你的场景三选一：

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

适合谁：第一次安装 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 升级路径）。

[!WARNING] 版本要求：部分仪表板使用 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（方法一脚本已默认选择 Docker Hub，方法二/三中需手动指定）。

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

sudo tee /etc/docker/daemon.json <<EOF
{
  "registry-mirrors": ["https://docker.mirrors.ustc.edu.cn"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker

[!IMPORTANT] 以上仅更新 Grafana 镜像和仪表盘。若某版本改动了 SQL（坐标函数 / 分时电价 / 索引），还需重装 SQL 三件套，否则分时电价 / 地图等面板会报错 —— 一键安装用户直接重跑 simple-deploy.sh（自动进入升级模式安装 SQL），其他用户见上方 升级方法 A/B/C/D。纯仪表盘版本（如 v1.7.10）使用上面两条命令即可。

[!NOTE] 典型报错：地图整页 / 分时电价面板报 function lat_for_map(...) does not exist、function effective_cost(...) does not exist 等错误 —— 这是由于未安装/未重装 SQL 三件套，并非 PostgreSQL 版本问题，请勿升级 PG。重新运行上述 SQL 安装命令即可（坐标函数位于 install-coord-functions.sql、分时电价位于 install-tou.sql）。

[!WARNING] 如果更新后 Dashboard 仍显示旧版本，说明 Grafana 数据卷存在缓存残留，执行以下命令重置（车辆数据不受影响）：

> 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

🔧 故障排除

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

• ghproxy.com 等第三方镜像

[!WARNING] — 镜像运营方能修改返回内容（实际是新增一个 MITM 信任点），仅在你信任该镜像方时使用

• 自建 Cloudflare Worker 转发 raw 内容 ✅ — 你完全控制 Worker 源码 → 等价于直连

🛠️ 系统要求

• Docker 20.10+
• Docker Compose 2.0+
• PostgreSQL 18（与官方 teslamate-org 对齐，postgres:18-trixie）
• 12 个仪表盘使用 3 参数 date_trunc 时区聚合，PostgreSQL ≤15 必定报错
• PostgreSQL 16/17 可以运行但建议升级到 18；从旧版 TeslaMate 迁移过来需先升级 PostgreSQL，备份升级流程参见 TROUBLESHOOTING.md「PostgreSQL 大版本升级」
• 内存：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 - 项目发起人、主要汉化
• 社区贡献者 - 翻译校对、建议反馈

如何成为贡献者？

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

• 🌐 翻译改进
• 🐛 问题反馈
• 📝 文档完善
• 💡 功能建议
• ⭐ 给项目点 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%E5%85%A5 *** 群 帮助其他车主安装。

谢谢你 ❤️