Reitti 自托管位置追踪分析平台

Reitti：自托管的个人位置追踪与分析平台

Reitti 是一个用 Java 编写的自托管位置追踪应用，名字来自芬兰语，意为「路线」或「路径」。它帮助你理解自己的移动模式与重要地点，同时保证位置数据始终留在自己的服务器上。

核心能力

地图与时间线

• 交互式时间线：按天展示访问与行程，包含时长和距离信息。
• 访问与行程识别：自动判断你停留的地点，并识别步行、骑行、驾车等出行方式。
• 重要地点：识别并命名你经常访问的位置。
• 原始 GPS 轨迹：可视化完整的移动路径。
• 多用户视图：在一张地图上查看家人和朋友的位置。
• Live 模式：实时接收数据并自动显示在地图上，适合全屏 kiosk 展示。

实时位置共享

Reitti 支持多种共享方式：

• 同实例共享：同一实例内的用户可互相关注实时位置。
• 联邦（Federation）：连接其他 Reitti 实例，只交换实时位置，数据仍留在各自服务器。
• Magic Link：生成链接分享给没有账号的人，可随时撤销，只暴露你选择共享的内容。

多设备与数据修正

每个用户可以接入多台设备。默认设备的数据会自动拼接成个人时间线；其他设备可以通过 workbench 选择设备与时间范围手动拼接。workbench 还支持在地图上直接拖动错位的 GPS 点，或一键删除异常数据。

照片与统计

• 可对接自托管的 Immich，照片会按拍摄地点和时间出现在时间线上。
• 提供距离图表、常去地点排行、出行方式占比等统计可视化。

隐私与自托管

• 位置数据不会离开你的服务器。
• 实时共享只发送给明确信任的实例和用户。
• 支持 Docker 部署、多用户数据隔离、OIDC / 单点登录。
• 反向地理编码默认使用官方 Paikka 实例，也可自行配置地理编码服务。

快速开始

官方推荐使用 Docker Compose 启动：

mkdir reitti && cd reitti
wget https://raw.githubusercontent.com/dedicatedcode/reitti/refs/heads/main/docker-compose.yml
docker compose up -d

启动后访问 http://localhost:8080，首次登录会要求设置新的管理员密码，并自动生成默认 API Token，方便直接连接设备。

ARM64 用户（如 Apple Silicon）在相关 PostGIS 镜像问题解决前，需要把 compose 文件中的 PostGIS 镜像替换为 imresamu/postgis:17-3.5-alpine。

数据导入与集成

Reitti 支持多种数据来源：

• 文件导入：GPX、Google Takeout JSON、Google Timeline 导出、GeoJSON。
• 实时上报：OwnTracks、GPSLogger、Overland、Home Assistant。
• 自定义接入：REST API。

适用人群

Reitti 适合重视隐私、希望自建位置时间线的开发者，以及需要家庭位置共享、照片地图回顾的用户。它依赖 Docker 与 PostGIS，部署属于进阶难度，但功能完整度和集成生态在同类自托管项目中较为突出。