TeslaMate

TeslaMate 是一個強大的自架 Tesla 資料記錄器。它會記錄你的行程、充電、能效、休眠狀態、韌體更新等詳細資料，並透過精心設計的 Grafana 儀表板進行視覺化。

功能特色

• 行程與充電紀錄 —— 距離、時長、能耗、費用
• 能效分析 —— 依溫度、路線、駕駛風格分析能耗
• 充電統計 —— 在哪裡、何時、充了多少、花了多少
• 韌體更新追蹤 —— 完整的韌體版本歷史
• 地理圍欄 —— 用命名地點（家、公司等）自動標記行程
• MQTT 串流 —— 即時車輛狀態，方便接入家庭自動化
• 預載 Grafana 儀表板 —— 15+ 個開箱即用的視覺化面板

部署內容

此模版會部署經過安全強化的完整 TeslaMate 技術堆疊：

1. Caddy —— TeslaMate 的前置反向代理，強制 HTTP Basic Auth（公網上唯一可存取的入口，綁定 PUBLIC_DOMAIN）
2. TeslaMate —— 主 Web 應用，僅內網存取，必須透過 Caddy 進入
3. PostgreSQL 18 —— 僅內網存取，儲存所有車輛資料
4. Grafana —— 預載 TeslaMate 官方儀表板，對外暴露於 GRAFANA_DOMAIN，內建獨立登入
5. Mosquitto MQTT —— 僅內網存取的即時狀態訊息代理

快速開始

1. 部署 —— 點擊部署，填寫所有變數（含 Web UI 帳號密碼），並綁定兩個網域
2. 存取 TeslaMate —— 開啟 PUBLIC_DOMAIN，瀏覽器會跳出視窗要求輸入你設定的 Basic Auth 帳密，接著再走 TeslaMate 自己的 Tesla token 設定流程
3. 開啟 Grafana —— 造訪 GRAFANA_DOMAIN（預設 admin / admin，請立即修改）
4. 開車 —— TeslaMate 會自動開始記錄資料

安全說明

• TeslaMate Web UI 本身沒有登入機制，因此本模版在它前面掛了一層帶 HTTP Basic Auth 的 Caddy 反向代理。TeslaMate 容器不直接對外暴露，只有 Caddy 對外。
• Postgres 與 Mosquitto 預設僅內網存取。請勿在 Zeabur 控制台為這兩個服務啟用 Port Forwarding，除非你完全清楚後果 —— Mosquitto 是無密碼的，公開 1883 連接埠等同於把車輛即時 GPS 位置直接公開。
• 請把 ENCRYPTION_KEY 保存到 Zeabur 之外，還原資料庫備份時必須使用同一把金鑰。
• Grafana 內建獨立登入（首次 admin / admin，登入後會要求立即修改）。
• Basic Auth 密碼在容器啟動時由 caddy hash-password 自動 bcrypt 加密，明文僅存於 Zeabur 的環境變數，不會落到容器檔案系統。

相關連結

• 官方文件
• GitHub
• Discord