내 테슬라 데이터는 내가 소유한다: TeslaMate 트렌딩 분석

테슬라는 당신 차에서 방대한 데이터를 수집한다. 배터리 상태, 주행 경로, 충전 이력, 주차 중 온도까지. 문제는 그 데이터가 테슬라 서버에 있다는 것이다. 오너는 앱이 보여주는 제한된 통계만 볼 수 있을 뿐, 원시 데이터에 직접 접근하거나 자유롭게 분석하기는 어렵다.

TeslaMate는 이 구도를 뒤집는다. Tesla API를 활용해 차량 데이터를 내 서버에 직접 기록하고, Grafana 대시보드로 시각화한다. 오늘 하루 별 +35개를 추가하며 GitHub 트렌딩에 재등장했다. ★8,213개는 이 프로젝트가 일시적 유행이 아님을 말해준다.

---

이게 뭔가

비유하자면 **"테슬라 전용 개인 블랙박스 + 분석 센터"**다. 차가 주행하거나 충전하는 순간, TeslaMate가 Tesla의 공개 API를 통해 데이터를 가져와 내 집 서버의 PostgreSQL에 저장한다. Grafana가 이를 시각화하고, MQTT 브로커가 Home Assistant 같은 홈오토메이션 시스템에 실시간 상태를 뿌린다.

코드는 Elixir로 작성됐지만 사용자가 Elixir를 알 필요는 없다. Docker Compose 하나로 모든 구성 요소가 올라온다. 라즈베리파이 위에서도 돌아간다.

---

왜 지금 뜨는가

세 흐름이 맞물렸다.

① 데이터 주권 의식 상승. 자동차 제조사의 데이터 수집 관행이 도마에 오르면서 "내 차 데이터는 내가 갖겠다"는 수요가 가시화됐다. 테슬라는 특히 차량에서 수집하는 데이터 범위가 넓은 것으로 알려져 있다.

② Tesla API 변화. 테슬라는 2023년 이후 Fleet API 체계로 전환하며 써드파티 앱 생태계를 흔들었다. TeslaMate는 이 변화를 발 빠르게 반영해 안정성을 유지했고, 공식 앱 외 사실상 유일한 성숙한 대안으로 자리잡았다.

③ 셀프호스팅 붐. Home Assistant, Nextcloud, Immich 등 "내 서버에 직접 돌리기" 트렌드가 강해지면서 TeslaMate도 그 생태계에 자연스럽게 편입됐다. Docker Compose 한 방 배포, 라즈베리파이 지원이 이 흐름과 딱 맞는다.

---

핵심 기능

• 고정밀 주행 기록: 속도, 경로, 에너지 소비량을 초 단위로 기록
• 뱀파이어 드레인 최소화: 수집이 불필요할 때 차가 슬립 모드로 진입하도록 설계 — 배터리를 추가로 갉아먹지 않는다
• 자동 주소 변환: OpenStreetMap 기반으로 GPS 좌표를 사람이 읽을 수 있는 주소로 자동 변환
• Grafana 대시보드 20+개: 충전 통계, 효율, 지도 위 경로 시각화 등 사전 구성 완료
• MQTT 실시간 연동: Home Assistant와 단 몇 줄 설정으로 통합

---

누구에게 쓸모 있나

대상	활용
테슬라 오너 + 데이터 덕후	배터리 열화 추적, 충전 비용 분석, 주행 패턴 파악
홈오토메이션 마니아	"차가 집 근처 오면 에어컨 켜기" 같은 자동화
프라이버시 민감 유저	데이터가 외부 서버로 나가지 않음
플릿 소유자	여러 차량 데이터를 한 서버에서 통합 관리

비개발자도 Docker만 쓸 줄 알면 설치할 수 있다. 단, Tesla 계정 자격증명이 필요하고 보안 설정에 주의해야 한다.

---

시작하기

공식 문서의 Docker Compose 방식이 가장 빠르다.

사전 조건: Docker + Docker Compose 설치, Tesla 계정(Fleet API 토큰 발급 필요)

1. 공식 문서에서 최신 docker-compose.yml 복사
2. ENCRYPTION_KEY, DB 비밀번호 등 환경변수 설정
3. docker compose up -d 실행
4. TeslaMate UI(http://localhost:4000)에서 Tesla 계정 연동
5. Grafana(http://localhost:3000)에 접속해 대시보드 확인

Tesla 계정 연동 후 수분 내에 데이터 수집이 시작된다.

---

사용 예시

① 서비스 시작 및 로그 확인

# 컨테이너 4개(teslamate, postgres, grafana, mosquitto) 백그라운드 실행
docker compose up -d

# teslamate 실시간 로그 확인 (오류·수집 상태 모니터링)
docker compose logs -f teslamate

첫 실행 시 DB 마이그레이션이 자동 진행된다. 오류 없이 끝나면 데이터 수집 준비 완료.

② MQTT 토픽 구독 (Home Assistant 연동 전 테스트)

# 차량 ID 1번의 모든 실시간 MQTT 메시지 수신
mosquitto_sub -h localhost -t "teslamate/cars/1/#" -v

출력 예: teslamate/cars/1/battery_level 82 — 현재 배터리 잔량 82%를 실시간으로 받는다. 이 값을 Home Assistant의 센서로 등록하면 바로 자동화에 활용 가능하다.

③ 업데이트

# 최신 이미지 풀 후 무중단 재시작
docker compose pull && docker compose up -d

Tesla API 변경 대응을 위해 정기적인 업데이트가 중요하다. 데이터는 postgres 볼륨에 보존된다.

---

한계·주의

1. 보안이 최우선이다. Tesla 계정 토큰을 사용하므로 인터넷에 포트를 직접 노출하면 안 된다. VPN(Tailscale 등) 또는 리버스 프록시 + 인증 레이어를 반드시 구성할 것.
2. 비공식 포크를 경계하라. README 자체가 경고하듯, 앱스토어 등에 TeslaMate 이름을 사칭한 악성 앱이 존재한다. 반드시 공식 저장소에서만 받을 것.
3. Tesla API 의존성. 테슬라가 API 정책을 바꾸면 일부 기능이 일시 중단될 수 있다. 프로젝트는 활발히 유지보수 중이지만, 기업 정책 변화는 예측 불가다.
4. Elixir 기반이라 직접 커스터마이징은 진입장벽 있음. 일반 사용자는 Docker 그대로 쓰는 것이 현실적이다.

내 차 데이터를 내 손에 쥐고 싶은 테슬라 오너에게, TeslaMate는 현재 가장 성숙한 선택지다. 8,000개가 넘는 별이 그 평판을 증명한다.