연동 가이드
HedgieMate를 TeslaMate 서버에 연결하는 방법
사전 준비 사항
필수 환경
이 앱은 TeslaMate의 데이터를 시각화해주는 클라이언트입니다. 따라서 다음 환경이 필요합니다:
- TeslaMate 개인 서버 (Docker) 또는 MyTeslaMate 클라우드 서비스
- 집 밖에서 접속하려면: 외부 접속 설정 필요 (VPN 등)
- 집 안에서만 쓴다면: 동일한 Wi-Fi 네트워크 연결 필요
1단계: API 컨테이너 설치
TeslaMate API 추가
앱이 TeslaMate 데이터베이스와 통신하기 위해 작은 '통역사(API)'가 필요합니다. TeslaMate가 설치된 서버에 아래 컨테이너를 추가해주세요.
Visit the TeslaMate API 깃허브 가이드 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:80802단계: 외부 접속 설정 (선택)
LTE/5G 환경에서도 접속하려면?
보안 경고: 아무런 보호 조치 없이 포트 포워딩으로 서버를 개방하지 마세요.
안전하게 외부에서 내 서버에 접속하는 3가지 추천 방법입니다:
추천 솔루션
방법 A: Tailscale (가장 추천)
방법 B: 리버스 프록시 + 인증
방법 C: Cloudflare Tunnel
보안 체크리스트
- HTTPS 사용 필수: 암호화되지 않은 HTTP는 위험합니다.
- 강력한 비밀번호: Basic Auth 사용 시, 무작위로 생성된 긴 비밀번호를 쓰세요.
- 업데이트 생활화: TeslaMate와 Docker 이미지를 주기적으로 업데이트하세요.
- 로그 모니터링: 낯선 IP의 접속 시도가 없는지 종종 확인하세요.
네트워크 설정이 너무 어렵다면 'Tailscale'을 검색해서 따라해보세요. 가장 쉽고 안전한 방법입니다.
1단계: 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 데이터에 대한 전체 액세스 권한을 제공합니다.
3단계: 앱 설정
주소 입력
앱을 켜고 설정한 API 주소를 입력하세요:
- 도메인 사용 시
https://teslamate.my-domain.com(Cloudflare Tunnel 등) - IP 직접 입력
http://192.168.0.10:8080(집안 내부망 또는 VPN 연결 시)
중요: TeslaMate 웹 대시보드 주소(포트 4000)가 아니라, 위에서 설치한 API 주소(보통 포트 8080)를 입력해야 합니다.
연결 완료
'연결 테스트' 버튼을 눌러 성공 메시지가 뜨면 모든 준비가 끝났습니다. 이제 내 차의 데이터를 탐험해보세요.