部署指南
如何將 HedgieMate 連線到您的 TeslaMate 伺服器
環境準備
您需要具備：
HedgieMate 是 TeslaMate 的客戶端，本身不儲存資料。請確保您擁有：
- 自建 TeslaMate 伺服器 (Docker) 或 MyTeslaMate 雲託管服務
- 若需外網存取：需配置內網穿透或 VPN
- 若僅內網使用：需手機與伺服器在同一 Wi-Fi 下
第一步：部署 API 服務
安裝 TeslaMate API
App 需要透過 API 介面讀取資料。請將此服務部署在執行 TeslaMate 的同一台伺服器上。
詳細說明請見 TeslaMate API GitHub 倉庫。
將以下配置新增到您的 `docker-compose.yml` 檔案中，並務必根據實際情況修改資料庫密碼等環境變數：
... existing TeslaMate docker-compose configuration ...
services:
teslamateapi:
image: tobiasehlert/teslamateapi:latest
restart: always
depends_on:
- database
environment:
- ENCRYPTION_KEY=MySuperSecretEncryptionKey
- DATABASE_USER=teslamate
- DATABASE_PASS=secret
- DATABASE_NAME=teslamate
- DATABASE_HOST=database
- MQTT_HOST=mosquitto
- TZ=Europe/Berlin
ports:
- 8080:8080注意： MQTT_HOST 必須與您的 TeslaMate 所使用的 MQTT broker 相同。請使用與現有 TeslaMate Docker 配置相同的值。
第二步：配置遠端存取（可選）
如何安全地在戶外存取？
高危警告：切勿直接透過埠對映將 API 暴露在公網且不設密碼！
為了安全地進行遠端存取，這是我們的推薦方案：
推薦方案
方案 A：Tailscale (最推薦)
方案 B：反向代理 + 密碼認證
方案 C：Cloudflare Tunnel
安全紅線
- 強制 HTTPS：禁止使用明文 HTTP 傳輸敏感資料。:
- 強密碼：Basic Auth 密碼必須足夠複雜。:
- 勤更新：保持 Docker 映象和作業系統的最新狀態。:
- 看日誌：養成定期檢查伺服器存取日誌的習慣。:
如果需要幫助配置安全的外部存取，請聯絡我們的支援團隊。
第一步：部署 API 服務
使用 MyTeslamate 服務
MyTeslamate 提供託管的 TeslaMate API 連線服務，無需本地安裝。如果還沒有帳戶，請建立 MyTeslamate 帳戶。
重要：MyTeslamate 最新版本始終要求進行身份驗證。請使用 tobiasehlert/teslamateapi:latest 映象，並選擇 Basic Auth。
- 在 MyTeslamate 中，進入 Add-on 部分
- 啟用 Connectivity: TeslaMate API & MQTT 並選擇
tobiasehlert/teslamateapi:latest映象 - 在身份驗證方式中選擇 Basic Auth
- 複製 Endpoint URL、Login 和 Password/Token
- 在 HedgieMate 中，將 Endpoint 填入 API URL，把 MyTeslamate 的 Login 填入 Username，把 Password/Token 填入 Password
- 遇到問題？請發郵件至 [email protected]，我們很樂意提供幫助。
請妥善保管您的 Endpoint URL、Login 和 Password/Token。切勿公開分享 - 它們提供對您 TeslaMate 資料的完全存取權限。
第三步：App 連線
填入地址
開啟 App，輸入您的 API 地址：
- 公網域名
https://teslamate.your-domain.com（如使用 Cloudflare） - 內網 IP
http://192.168.1.10:8080（在家或連線 VPN 時使用）
重要提示：請填寫 API 服務地址（通常埠為 8080），不要填寫 TeslaMate 網頁後台地址（埠 4000）。
一鍵連線
點選測試連線。成功後，App 將自動同步資料，您的特斯拉資料之旅由此開始。