owntracks/recorder

어떤 프로젝트인가요?

핵심 기능

• 01MQTT 구독 또는 HTTP POST를 통해 위치 데이터 수신
• 02외부 데이터베이스 없이 일반 파일에 데이터 저장
• 03내장 REST API 및 WebSocket 실시간 지도
• 04명령줄 도구 ocat으로 JSON, GeoJSON, CSV, GPX, XML 내보내기
• 05OpenCage, Google 또는 revgeod를 이용한 역지오코딩
• 06동작을 맞춤 설정할 수 있는 Lua hooks

활용 사례

• 홈 서버에서 직접 보유한 OwnTracks 기기의 위치 기록을 비공개로 관리
• 데이터를 타사 서비스에 보내지 않고 로컬 지도에서 가족 구성원의 휴대폰 위치 추적
• Raspberry Pi 같은 저전력 기기에서 실행
• 분석을 위해 위치 기록을 GPX 또는 CSV로 내보내기

빠른 시작

1. 1

   Docker Hub에서 Docker 이미지를 설치합니다

   docker pull owntracks/recorder
2. 2

   OwnTracks 토픽을 구독하는 Recorder를 실행합니다

   ./ot-recorder 'owntracks/#'
3. 3

   브라우저에서 기본 주소로 웹 인터페이스를 엽니다

사용 전 알아둘 점

• !일부 Linux 배포판에만 패키지가 제공되며, 다른 플랫폼에서는 소스 코드로 빌드해야 합니다.
• !HTTP 모드를 사용하지 않는 한 Mosquitto와 같은 MQTT 브로커가 필요합니다.
• !지도 기능을 사용하려면 자체 지도 API 키가 필요합니다.
• !메타데이터에 라이선스가 명확히 지정되어 있지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

recorder은(는) 무엇인가요?

외부 데이터베이스 없이 MQTT 또는 HTTP로 OwnTracks 모바일 앱이 전송하는 위치 데이터를 저장하고 제공하는 경량 서버입니다. OwnTracks Recorder는 MQTT 브로커를 구독하거나 OwnTracks JSON 메시지를 담은 HTTP POST 요청을 받아 위치 데이터를 디스크의 일반 파일에 기록합니다. 내장 REST API와 WebSocket 서버를 통해 데이터를 제공하며, 새 위치가 도착할 때마다 갱신되는 실시간 지도의 기반이 됩니다.

recorder은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

recorder은(는) Other 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

recorder은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. recorder의 마지막 커밋은 2026년 10월 27일입니다.

recorder은(는) 어디에 사용할 수 있나요?

홈 서버에서 직접 보유한 OwnTracks 기기의 위치 기록을 비공개로 관리 데이터를 타사 서비스에 보내지 않고 로컬 지도에서 가족 구성원의 휴대폰 위치 추적 Raspberry Pi 같은 저전력 기기에서 실행 분석을 위해 위치 기록을 GPX 또는 CSV로 내보내기

recorder는 어떻게 설치하나요?

Docker Hub에서 Docker 이미지를 설치합니다: docker pull owntracks/recorder OwnTracks 토픽을 구독하는 Recorder를 실행합니다: ./ot-recorder 'owntracks/#' 브라우저에서 기본 주소로 웹 인터페이스를 엽니다

recorder은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/owntracks/recorder