TeslaMate完整指南免費(fèi)自托管特斯拉數(shù)據(jù)記錄儀20個儀表盤講清你的車【免費(fèi)下載鏈接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]項(xiàng)目地址: https://gitcode.com/GitHub_Trending/te/teslamate你的特斯拉已經(jīng)跑了三萬公里但你上一次確切知道電池到底衰減了幾個百分點(diǎn)是什么時候官方App只回答現(xiàn)在還有多少電從不做縱向比較——新電池 78.9 kWh 和現(xiàn)在的 75.5 kWh 之間的差距它永遠(yuǎn)不會主動告訴你。TeslaMate 就是補(bǔ)上這一塊的一款免費(fèi)、開源AGPLv3 許可的自托管特斯拉數(shù)據(jù)記錄儀。它通過特斯拉官方 API 持續(xù)采集車輛狀態(tài)寫入自己的 Postgres 數(shù)據(jù)庫再用 20 多個 Grafana 儀表盤把電池健康、充電成本、駕駛效率呈現(xiàn)出來。所有數(shù)據(jù)存在你自己的機(jī)器上不經(jīng)過任何第三方服務(wù)器。裝之前先確認(rèn)它值不值先看三組對照判斷自己是不是目標(biāo)用戶。對比項(xiàng)特斯拉官方 AppTeslaFiSaaSTeslaMate歷史數(shù)據(jù)只有當(dāng)前值不積累積累在對方服務(wù)器積累在你自己的 Postgres部署成本零零需要一臺能跑 Docker 的常開設(shè)備1GB 內(nèi)存起步建議 2GB睡眠友好度—持續(xù)輪詢會讓車難以入睡內(nèi)置休眠策略閑置 3 分鐘暫停采集、15 分鐘后才試探車輛是否睡著不額外制造吸血鬼功耗可玩性固定界面固定界面儀表盤、MQTT、API 全開放可自由擴(kuò)展費(fèi)用免費(fèi)免費(fèi)免費(fèi)AGPLv3閉源衍生版本不可行一句話判斷你手里有一臺常開的樹莓派或舊筆記本、希望數(shù)據(jù)完全自己掌握、并且不排斥折騰一點(diǎn)配置——那就對路了。反過來如果你只想要零維護(hù)看一眼電量官方App 足夠不必裝它。另一個常見疑問它和 Home Assistant 的官方 Tesla 組件是什么關(guān)系HA 官方組件長期未更新默認(rèn)輪詢參數(shù)會讓車保持喚醒、消耗電池TeslaMate 的 MQTT 數(shù)據(jù)可以替代組件的絕大部分只讀功能。這個差異后面進(jìn)階部分再展開。4 個最值得打開的儀表盤實(shí)時狀態(tài)瀏覽器里的車況面板Web 界面左側(cè)地圖顯示車輛位置與圍欄右側(cè)是電量、續(xù)航、內(nèi)外溫與充電狀態(tài)車輛信息欄含軟件版本打開http://你的IP:4000看到的就是這個地圖上車輛的實(shí)時位置加上電量百分比、可用續(xù)航、車內(nèi)車外溫度、充電進(jìn)度。它的意義不是看個位置而是給你一張隨開隨查的底牌——出門前確認(rèn)還剩多少真實(shí)續(xù)航充電時盯著預(yù)計(jì)完成時間都不需要解鎖車機(jī)。電池健康把衰減量化成數(shù)字Battery Health 儀表盤環(huán)形圖對比新電池與當(dāng)前電池容量kWh及最大續(xù)航柱狀圖按充電類型拆分已充電能量這是 TeslaMate 最被低估的一頁。它把電池還行不行拆成可以直接引用的數(shù)字初始容量與當(dāng)前容量的差值例如 78.9 → 75.5 kWh衰減約 3.5 kWh、折算后的續(xù)航損失329 英里 → 315 英里、以及能量來源拆分DC 快充 23% / AC 慢充 77%。怎么讀這些數(shù)據(jù)衰減本身不可怕可怕的是你不知道它在以什么速度發(fā)生。每月截一次這張圖容量差值的變化率就是你的衰減速率能量來源拆分則回答快充占得越多衰減是否越快這個懸了很久的問題。充電成本把電費(fèi)從糊涂賬算成明細(xì)Charging Stats 儀表盤熱力圖展示各月各時段的充電次數(shù)分布表格按地點(diǎn)匯總充電量與費(fèi)用TeslaMate 支持在地理圍欄里設(shè)置不同電價家充、超充站、公共樁分別定價之后每次充電都會計(jì)入成本。這張圖的價值在于對比熱力圖暴露你什么時候在充電地點(diǎn)表格告訴你哪里的電最便宜。如果你家充電峰谷電價差 0.5 元/度、月充電 100 度把充電挪到谷段一個月就是 25 元——數(shù)字不大但全年 300 元而且順帶對電池更友好低溫時段少用快充。能耗效率錢花在哪一公里上Efficiency 儀表盤按時間粒度展示凈/毛能耗kWh/100km可對比不同季節(jié)與駕駛場景注意一個前提特斯拉 API 不直接返回每次行程的能耗值TeslaMate 是根據(jù)記錄的充電數(shù)據(jù)反推估算的所以這個儀表盤至少需要兩次有效充電會話單次時長 10 分鐘、SoC 未超過 95%才開始出數(shù)之后每次充電都會讓估算更準(zhǔn)、并回溯修正歷史。出數(shù)之后它能回答這類問題冬天油耗是不是比夏天高出一截高速巡航和市區(qū)通勤差多少有了這條基線你調(diào)整駕駛習(xí)慣前后是否有變化就能用同一把尺子量出來。30 分鐘跑起來Docker 最短部署路徑前置條件來自 Docker 部署文檔一臺常開、能跑 Docker 的設(shè)備樹莓派 3/4 及以上、任意 Linux、裝了 Docker Desktop 的 Windows/Mac 均可x86-64 與 ARM64 官方鏡像都提供armv7 已不支持至少 1GB 內(nèi)存建議 2GB能訪問特斯拉服務(wù)器的外網(wǎng)一個安全加密密鑰和一個數(shù)據(jù)庫密碼寫進(jìn)配置文件最少命令準(zhǔn)備一個docker-compose.yml完整版見官方文檔最小骨架長這樣database與mosquitto兩個服務(wù)照文檔補(bǔ)齊services: teslamate: image: teslamate/teslamate:latest ports: [4000:4000] grafana: image: teslamate/grafana:latest ports: [3000:3000]然后后臺啟動docker compose up -d首次打開能看到什么http://你的IP:4000—— TeslaMate 登錄頁。它不能替你生成特斯拉賬號的 access/refresh token這部分需要單獨(dú)工具完成流程見 Token 生成指南把兩個 token 填進(jìn)去即可完成綁定同一賬號下的多輛車都會被自動納管。http://你的IP:3000—— Grafana默認(rèn)賬號admin/ 初始密碼admin進(jìn)去先改密碼。20 多個儀表盤已預(yù)裝好源碼在 grafana/dashboards/從 Overview 開始逛即可?；氐?TeslaMate 的 Settings → URLs把 Web 與 Dashboard 的 URL 互相填上兩邊跳轉(zhuǎn)就通了。跑起來之后3 個進(jìn)階玩法一條環(huán)境變量接入 Home AssistantTeslaMate接入Home Assistant后的儀表盤Home Assistant 中的 TeslaMate 設(shè)備電量、續(xù)航、胎壓等實(shí)體自動出現(xiàn)在集成界面把MQTT_HOME_ASSISTANT_DISCOVERY設(shè)為true重啟TeslaMate 會通過 MQTT 自動發(fā)布 HA 設(shè)備發(fā)現(xiàn)配置電量、續(xù)航、充電狀態(tài)等實(shí)體直接出現(xiàn)在 Home Assistant 里不用手工維護(hù)傳感器 YAML。之后的玩法很直接車回家自動開燈、SoC 低于 20% 推送手機(jī)通知。細(xì)節(jié)見 Home Assistant 集成指南。用 Node-RED 把數(shù)據(jù)變成動作TeslaMate 把車輛數(shù)據(jù)持續(xù)發(fā)布到本地 MQTT broker所以任何訂閱 MQTT 的系統(tǒng)都能吃到它。社區(qū)文檔里給了現(xiàn)成的 Node-RED 流程示例——比如充電完成 → 推送 Telegram 消息拖幾個節(jié)點(diǎn)就能搭出來不需要寫代碼。補(bǔ)歷史數(shù)據(jù) 一鍵備份補(bǔ)數(shù)據(jù)如果你之前用 TeslaFi 記錄過可以把它的 CSV 按月導(dǎo)出放進(jìn)導(dǎo)入目錄由 TeslaMate 的 TeslaFi 導(dǎo)入 流程寫回數(shù)據(jù)庫同機(jī)制還支持 tesla-apiscraper 的數(shù)據(jù)。導(dǎo)入前一定先做備份。備份所有數(shù)據(jù)就在 Postgres 里一條命令全量導(dǎo)出docker compose exec -T database pg_dump -U teslamate teslamate teslamate.bck掛進(jìn) crontab定期把.bck文件拷到宿主機(jī)之外的地方見 備份與恢復(fù)文檔。三個高頻問題的直接回答Grafana 里為什么看不到能耗數(shù)值正?，F(xiàn)象。如前所述能耗是估算值前兩次有效充電10 分鐘、SoC95%之前無數(shù)據(jù)之后每次充電都會讓精度提升并回溯修正。另外如果面板變量顯示null是因?yàn)槟銢]給車起名字——在車機(jī)上命名后等待同步即可。車為什么睡不下去兩個方向排查一是檢查車機(jī)設(shè)置 Controls Charging Keep Accessory Power Off 是否開啟二是 2018 年 3 月前生產(chǎn)的 Model S/XMCU1軟件信息頁顯示 Infotainment processor 為 NVIDIA Tegra需要手動打開節(jié)能顯示、關(guān)掉常連與座艙過熱保護(hù)三項(xiàng)。完整清單在 官方 FAQ。還有一個隱蔽原因如果你同時跑著 TeslaFi 等其他記錄器雙份輪詢會不斷重置車輛的閑置計(jì)時器。某段時間的數(shù)據(jù)丟了能找回嗎特斯拉 API 不提供歷史行程與充電數(shù)據(jù)所以記錄中斷期間的數(shù)據(jù) TeslaMate 自己補(bǔ)不回來但如果那段時間有別的記錄器如 TeslaFi存了數(shù)據(jù)可以按上面的導(dǎo)入流程補(bǔ)進(jìn)庫。日常建議發(fā)現(xiàn)停止記錄先查日志——網(wǎng)絡(luò)、數(shù)據(jù)庫連接、token 過期三類原因日志里都能直接分辨token 過期時重新生成并登錄即可已錄數(shù)據(jù)不受影響。三步走你的開始時間表今天約 30 分鐘完成 Docker 部署、生成并填入 token、在 Grafana 改好默認(rèn)密碼。驗(yàn)收標(biāo)準(zhǔn)4000 端口登錄頁能看到你的車。第一周每天 0 分鐘什么都別調(diào)讓它靜默積累。周末花 10 分鐘看一遍 Overview 與 Battery Health建立你電池的出廠參照系。一個月后約 30 分鐘此時至少已有數(shù)次完整充電能耗估算已可用。打開 Efficiency 與 Charging Stats 各截一張圖對比你的實(shí)際用電習(xí)慣然后才談得上調(diào)整充電時段或駕駛方式。一句話總結(jié)TeslaMate 把特斯拉官方App 里那些用完即棄的狀態(tài)數(shù)據(jù)變成了一份逐年可查、歸因到每次充電每段行程的私人車況檔案——免費(fèi)、自托管且你隨時能用一條pg_dump把它完整帶走?！久赓M(fèi)下載鏈接】teslamateA self-hosted data logger for your Tesla [main maintainerJakobLichterfeld]項(xiàng)目地址: https://gitcode.com/GitHub_Trending/te/teslamate創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考