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