Průvodce nastavením
Jak připojit HedgieMate k vašemu TeslaMate serveru
Co budete potřebovat
Systémové požadavky
HedgieMate je doplněk k vaší existující instalaci TeslaMate. Pro funkčnost mimo domov je třeba vyřešit přístup:
- Vlastní instance TeslaMate nebo cloudová služba MyTeslaMate
- Bez vzdáleného přístupu bude aplikace fungovat jen na domácí Wi-Fi
- Pro vzdálený přístup doporučujeme Cloudflare Tunnel, VPN (Tailscale, WireGuard) nebo veřejnou IP
Instalace TeslaMate API
Zprovoznění TeslaMate API
Aby aplikace mohla číst data, potřebuje komponentu TeslaMate API. Tu musíte přidat na stejný server, kde vám běží TeslaMate.
Visit the Repozitář TeslaMate API na GitHubu for detailed instructions.
Přidejte následující službu do vašeho `docker-compose.yml` souboru a upravte proměnné prostředí tak, aby odpovídaly vaší databázi:
... 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:8080Nastavení vzdáleného přístupu (Volitelné)
Jak se připojit odkudkoliv
Nikdy nevystavujte API do internetu bez zabezpečení! Riskujete tím únik citlivých dat o vašem pohybu.
Pro bezpečný přístup k datům mimo domov doporučujeme jedno z následujících řešení:
Doporučená řešení
Varianta 1: VPN (Nejbezpečnější)
Varianta 2: Reverzní proxy s heslem
Varianta 3: Cloudflare Zero Trust (vyžaduje doménu)
Bezpečnostní zásady
- Vždy používejte HTTPS: Data musí být šifrována.
- Silná hesla: Pokud používáte Basic Auth, heslo musí být dlouhé a náhodné.
- Aktualizujte: Udržujte server i Docker kontejnery aktuální.
- Logy: Občas zkontrolujte, zda se vám na server nedobývá někdo cizí.
- Omezení: Zpřístupněte jen to, co je nezbytně nutné.
Pokud si s nastavením bezpečného přístupu nevíte rady, raději zvolte Tailscale nebo nás kontaktujte.
Instalace TeslaMate API
Použití služby MyTeslamate
MyTeslamate poskytuje hostovanou službu pro TeslaMate API bez nutnosti lokální instalace. Vytvořte si účet na MyTeslamate, pokud ho ještě nemáte.
Důležité: Po poslední aktualizaci MyTeslamate VŽDY vyžaduje autentizaci. Použijte image tobiasehlert/teslamateapi:latest a v nastavení zvolte Basic Auth.
- V MyTeslamate přejděte do sekce Add-on
- Aktivujte Connectivity: TeslaMate API & MQTT a vyberte image
tobiasehlert/teslamateapi:latest - Jako způsob autentizace zvolte Basic Auth
- Zkopírujte Endpoint URL, Login a Password/Token
- V HedgieMate vložte Endpoint jako URL API, Login z MyTeslamate jako Username a Password/Token jako Password
- Nevíte si rady? Napište nám na [email protected] a rádi pomůžeme.
Návod MyTeslamate Connectivity
Udržujte svůj Endpoint URL, Login a Password/Token v bezpečí. Nikdy je nesdílejte veřejně – poskytují plný přístup k vašim TeslaMate datům.
Nastavení aplikace HedgieMate
Zadání adresy API
Po spuštění aplikace zadejte adresu vašeho TeslaMate API:
- Veřejná doména
https://teslamate.vasedomena.cz(např. přes Cloudflare) - IP adresa s portem
https://123.45.67.89:8080 - Lokální síť
http://192.168.1.50:8080
URL musí směřovat na TeslaMate API (obvykle port 8080), nikoliv na původní webové rozhraní TeslaMate (port 4000)!
Ověření
Klikněte na test spojení. Pokud je vše v pořádku, aplikace načte seznam vašich aut a můžete začít.