Guia de Configuração
Como conectar o HedgieMate ao seu servidor TeslaMate
Pré-requisitos
Requisitos do Sistema
O HedgieMate funciona com a sua instalação TeslaMate existente. Para acesso remoto, vai precisar de:
- Instância TeslaMate em execução ou serviço MyTeslaMate
- Sem acesso remoto, o HedgieMate funciona apenas na rede local
- Pode usar um domínio com túnel Cloudflare Zero Trust, IP público ou solução VPN (Tailscale, OpenVPN, etc.)
Instalação da API TeslaMate
Instalar API TeslaMate
O HedgieMate requer a API TeslaMate para funcionar. Esta deve ser instalada no mesmo servidor onde o TeslaMate está a correr.
Visit the Repositório GitHub da API TeslaMate for detailed instructions.
Adicione este serviço ao seu ficheiro docker-compose.yml do TeslaMate existente e atualize as variáveis de ambiente para corresponder à sua configuração TeslaMate atual:
... 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:8080Configuração de Acesso Público (Opcional)
Configurar Acesso Público
Nunca exponha a sua API TeslaMate publicamente sem autenticação adequada. O acesso não autorizado pode comprometer a sua privacidade e segurança.
Para acesso remoto à sua API TeslaMate, aqui estão algumas opções seguras que pode considerar:
Soluções Recomendadas
Opção 1: Soluções VPN
Opção 2: Proxy Reverso com Autenticação
Opção 3: Cloudflare Zero Trust (requer domínio)
Dicas Adicionais de Segurança
- Use sempre HTTPS/TLS: Nunca exponha a sua API à internet pública através de HTTP simples
- Use palavras-passe fortes: Se usar Basic Auth, gere palavras-passe longas e aleatórias
- Atualizações regulares: Mantenha o seu proxy reverso e sistemas de autenticação atualizados
- Monitorize logs de acesso: Verifique regularmente tentativas de acesso não autorizado
- Limite o acesso à API: Exponha apenas os endpoints que realmente precisa
Se precisar de ajuda para configurar o acesso público seguro, contacte a nossa equipa de suporte para assistência.
Instalação da API TeslaMate
Usar Serviço MyTeslamate
MyTeslamate fornece um serviço de conectividade alojado para a API TeslaMate sem necessidade de instalação local. Crie uma conta MyTeslamate se ainda não tiver uma.
Importante: Após a última atualização do MyTeslamate, a autenticação é SEMPRE obrigatória. Use a imagem tobiasehlert/teslamateapi:latest e selecione Basic Auth.
- No MyTeslamate, vá à secção Add-on
- Ative Connectivity: TeslaMate API & MQTT e selecione a imagem
tobiasehlert/teslamateapi:latest - Como autenticação, escolha Basic Auth
- Copie o Endpoint URL, o Login e o Password/Token
- No HedgieMate, cole o Endpoint como URL da API, o Login do MyTeslamate como Username e o Password/Token como Password
- Não consegue avançar? Escreva-nos para [email protected] e ajudamos com gosto.
Guia de Conectividade MyTeslamate
Mantenha o seu URL de Endpoint, Login e Password/Token seguros. Nunca os partilhe publicamente – eles fornecem acesso total aos seus dados TeslaMate.
Configuração do HedgieMate
Descarregar HedgieMate
Instale o HedgieMate da App Store no seu dispositivo iOS.
Descarregar na App StoreConfigurar URL da API TeslaMate
No HedgieMate, introduza o URL da sua API TeslaMate:
- Acesso público
https://o-seu-dominio.com(se usar Cloudflare Zero Trust) - IP com porta
https://o-seu-ip:8080 - Rede local
http://192.168.1.xxx:8080
O URL deve apontar para o serviço da API TeslaMate a correr na porta 8080.
Verificar Ligação
Teste a ligação, obtenha os carros e comece a explorar os seus dados Tesla com análises e insights melhorados fornecidos pelo HedgieMate.