部署指南
如何将 HedgieMate 连接到您的 TeslaMate 服务器
环境准备
您需要具备：
HedgieMate 是 TeslaMate 的客户端，本身不存储数据。请确保您拥有：
- 自建 TeslaMate 服务器 (Docker) 或 MyTeslaMate 云托管服务
- 若需外网访问：需配置内网穿透或 VPN
- 若仅内网使用：需手机与服务器在同一 Wi-Fi 下
第一步：部署 API 服务
安装 TeslaMate API
App 需要通过 API 接口读取数据。请将此服务部署在运行 TeslaMate 的同一台服务器上。
Visit the TeslaMate API GitHub 仓库 for detailed instructions.
将以下配置添加到您的 `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第二步：配置远程访问（可选）
如何安全地在户外访问？
高危警告：切勿直接通过端口映射将 API 暴露在公网且不设密码！
为了安全地进行远程访问，这是我们的推荐方案：
推荐方案
方案 A：Tailscale (最推荐)
方案 B：反向代理 + 密码认证
方案 C：Cloudflare Tunnel
安全红线
- 强制 HTTPS：禁止使用明文 HTTP 传输敏感数据。:
- 强密码：Basic Auth 密码必须足够复杂。:
- 勤更新：保持 Docker 镜像和操作系统的最新状态。:
- 看日志：养成定期检查服务器访问日志的习惯。:
如果您是网络小白，请直接选择 'Tailscale' 方案，这是最稳妥的选择。
第一步：部署 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 将自动同步数据，您的特斯拉数据之旅由此开始。