owntracks/recorder

OwnTracks Recorder Docker镜像文档

镜像概述

OwnTracks Recorder是OwnTracks应用的后端服务，负责处理来自OwnTracks客户端的位置数据。镜像名称格式为<Recorder版本号>-<Docker镜像构建号>，例如v0.9.2-1。

核心功能

• 作为OwnTracks应用的后端支撑，接收并存储客户端发送的位置信息
• 提供HTTP访问接口，服务启动后可通过网络访问
• 支持连接MQTT broker，实现位置数据的传输与处理

使用场景

适用于需要部署OwnTracks位置跟踪系统的场景，为OwnTracks客户端提供后端数据存储与处理能力，常见于个人或家庭位置监控、设备定位等应用场景。

使用方法

快速启动

1. 创建数据卷
   首先创建用于持久化存储Recorder数据的数据卷：

   bash
   docker volume create recorder_store
   

2. 启动容器
   运行以下命令启动OwnTracks Recorder容器：

   bash
   docker run -d -p 8083:8083 -v recorder_store:/store -e OTR_HOST=mqtt_broker owntracks/recorder
   

参数说明

• -d：后台运行容器
• -p 8083:8083：端口映射，将容器内8083端口映射到主机8083端口，用于访问Recorder服务
• -v recorder_store:/store：数据卷挂载，将主机数据卷recorder_store挂载到容器内/store目录，实现数据持久化
• -e OTR_HOST=mqtt_broker：环境变量，指定MQTT broker的主机地址，Recorder将连接此broker以接收位置数据

访问服务

容器启动后，OwnTracks Recorder服务可通过 http://localhost:8083 访问，同时会尝试连接环境变量OTR_HOST指定的MQTT broker。