원본 Compose는 ZimaOS 경로 예시로 유용하지만, 원 게시자가 확인한 적이 없으므로 현재 TeslaMate 스택으로 고정해서는 안 됩니다. TeslaMate의 최신 Docker 문서에서는 여전히 여러 컨테이너로 구성된 Compose 배포 방식을 사용하며, 영구적인 데이터베이스 및 Grafana 상태를 유지할 수 있는 상시 가동 머신에서 서비스를 실행할 것을 명시적으로 권장합니다.
현재 업스트림 지침에서는 TeslaMate가 Tesla API 토큰을 저장하므로 보안도 강조합니다. 서비스를 신뢰할 수 있는 홈 네트워크에서 실행하거나, 원시 WebUI를 직접 공개하는 대신 VPN/Tailscale/Cloudflare Tunnel 또는 보안이 강화된 리버스 프록시를 통해 원격 액세스를 제공하세요.
현재 TeslaMate 요구 사항 확인
현재 TeslaMate 문서에는 다음이 명시되어 있습니다.
- Docker/Compose
- 상시 가동 호스트
- 설치에 최소 1GB RAM, 권장 2GB
- Tesla 서비스에 대한 인터넷 액세스
- amd64 또는 arm64 하드웨어
최신 TeslaMate Docker 설치 문서를 참조하세요.
원본은 영구 데이터를 /DATA/AppData 아래로 올바르게 이동했습니다
커뮤니티 Compose는 전용 ZimaOS AppData 폴더에 Postgres 데이터, Grafana 데이터 및 가져오기 데이터를 저장했습니다. 이는 적절한 플랫폼 조정입니다. 컨테이너 상태는 삭제될 수 있는 컨테이너 파일 시스템 외부에 저장되어야 합니다.
PostgreSQL 데이터베이스 보호
TeslaMate의 데이터베이스에는 차량의 과거 데이터와 애플리케이션 상태가 포함됩니다. 이미지 업그레이드 또는 주요 Compose 변경 전에 백업하세요.
실행 중인 Postgres 데이터 디렉터리를 불안정한 네트워크 공유에 두거나 컨테이너를 정리할 때 해당 디렉터리를 삭제하지 마세요.
강력한 ENCRYPTION_KEY 사용
TeslaMate는 암호화 키를 사용해 저장된 Tesla API 토큰을 보호합니다. 원본의 자리 표시자는 “암호화를 위한 임의의 솔트”라고 되어 있으므로, 이를 강력한 무작위 비밀 값으로 교체하고 공개 스크린샷이나 포럼 게시물에 노출하지 마세요.
일관되고 강력한 데이터베이스 비밀번호 사용
원본에서는 데이터베이스 비밀번호가 Postgres, TeslaMate 및 Grafana 설정에서 일치해야 한다고 올바르게 설명합니다. 비밀번호가 일치하지 않으면 컨테이너 자체는 실행 중인데도 애플리케이션 시작 문제처럼 보일 수 있습니다.
원본은 MQTT를 비활성화했지만, 최신 업스트림에는 표준 스택에 MQTT가 포함됩니다
커뮤니티 Compose는 DISABLE_MQTT=true로 설정했습니다. 현재 TeslaMate Docker 지침에서는 표준 예시에 Mosquitto를 포함합니다. MQTT는 통합 구성에 따라 선택 사항이지만, 현재 사용자는 2025년에 단순화된 설정을 무조건 그대로 따르기보다 실제로 필요한 업스트림 스택을 사용해야 합니다.
Grafana도 보호하세요
원본은 익명 Grafana 액세스를 활성화했습니다. 사설 LAN에서는 편리할 수 있지만, 해당 포트에 접근할 수 있는 누구에게나 차량 대시보드가 노출됩니다. 원격 액세스에는 인증과 보호된 네트워크 경로를 사용하세요.
전체 스택을 신중하게 업데이트하세요
업그레이드하기 전에 데이터베이스를 백업하고 TeslaMate 릴리스 노트를 검토한 다음 새 이미지를 가져와 스택을 다시 생성하세요. 이후 Tesla 데이터 수집과 Grafana 대시보드가 정상적으로 작동하는지 확인하세요.
ZimaOS에서 TeslaMate 사용 FAQ
원 게시자는 커뮤니티 Compose가 작동한다고 확인했나요?
아니요. 시도해 보겠다고 했지만, 해당 스레드에는 결과가 없습니다.
어떤 데이터를 영구적으로 보존해야 하나요?
최소한 TeslaMate/Postgres 데이터베이스와 Grafana 상태를 보존해야 하며, 추가로 가져오거나 구성한 데이터도 보호하세요.
TeslaMate를 공용 인터넷에 직접 공개해도 되나요?
현재 TeslaMate 지침에서는 VPN, Cloudflare Tunnel, Tailscale, ZeroTier 또는 보안이 강화된 리버스 프록시와 같은 안전한 연결을 권장합니다.
