Ръководство за настройка
Как да свържете HedgieMate с вашия TeslaMate сървър
Предварителни изисквания
Системни изисквания
HedgieMate работи със съществуващата ви инсталация на TeslaMate. За отдалечен достъп ще ви трябва:
- Работеща инстанция на TeslaMate или услугата MyTeslaMate
- Без отдалечен достъп HedgieMate работи само в локалната мрежа
- Можете да използвате домейн с тунел Cloudflare Zero Trust, публичен IP адрес или VPN решение (Tailscale, OpenVPN и др.)
Инсталиране на TeslaMate API
Инсталирайте TeslaMate API
HedgieMate се нуждае от TeslaMate API, за да работи. Той трябва да бъде инсталиран на същия сървър, на който работи TeslaMate.
Подробни инструкции ще намерите в хранилището на TeslaMate API в GitHub.
Добавете тази услуга към съществуващия си файл docker-compose.yml на TeslaMate и променете променливите на средата според текущата си конфигурация на TeslaMate:
... 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 трябва да сочи към същия MQTT брокер, който използва вашият TeslaMate. Копирайте стойността от съществуващата си Docker конфигурация на TeslaMate.
Настройка на публичен достъп (по избор)
Конфигуриране на публичен достъп
Никога не излагайте TeslaMate API публично без надеждно удостоверяване. Неоторизиран достъп може да застраши поверителността и сигурността ви.
За отдалечен достъп до вашия TeslaMate API можете да обмислите следните сигурни варианти:
Препоръчани решения
Вариант 1: VPN решения
Вариант 2: Reverse proxy с удостоверяване
Вариант 3: Cloudflare Zero Trust (изисква домейн)
Допълнителни съвети за сигурност
- Винаги използвайте HTTPS/TLS: никога не излагайте API-то си в интернет през обикновен HTTP
- Използвайте силни пароли: ако ползвате Basic Auth, генерирайте дълги, случайни пароли
- Редовни актуализации: поддържайте reverse proxy-то и системите за удостоверяване актуални
- Следете логовете за достъп: редовно проверявайте за опити за неоторизиран достъп
- Ограничете достъпа до API: излагайте само endpoint-ите, които наистина са ви нужни
Ако имате нужда от помощ с настройката на сигурен публичен достъп, свържете се с нашата поддръжка.
Инсталиране на TeslaMate 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, Login и Password/Token
- В HedgieMate поставете Endpoint като API URL, Login от MyTeslamate като Потребителско име и Password/Token като Парола
- Не се получава? Пишете ни на [email protected] и ще ви помогнем.
Ръководство за свързване на MyTeslamate
Пазете в тайна адреса на Endpoint, данните за Login и Password/Token. Никога не ги споделяйте публично, те дават пълен достъп до данните ви в TeslaMate.
Конфигуриране на HedgieMate
Изтеглете HedgieMate
Инсталирайте HedgieMate от App Store на вашето iOS устройство.
Изтеглете от App StoreВъведете URL адреса на TeslaMate API
В HedgieMate въведете URL адреса на вашия TeslaMate API:
- Публичен достъп
https://your-domain.com(ако използвате Cloudflare Zero Trust) - IP адрес с порт
https://your-ip:8080 - Локална мрежа
http://192.168.1.xxx:8080
URL адресът трябва да сочи към услугата TeslaMate API, която работи на порт 8080.
Проверете връзката
Тествайте връзката, заредете автомобилите и започнете да разглеждате данните за своята Tesla с разширените анализи на HedgieMate.