Reitti项目：自托管个人位置追踪与分析平台完全指南

项目概述

Reitti是一款功能强大的自托管应用程序，专为个人位置数据的追踪、分析和可视化而设计。作为一个注重隐私的解决方案，它让用户能够完全掌控自己的位置数据，同时提供专业级的移动模式分析能力。

核心功能解析

1. 智能位置分析引擎

• 自动访问识别：系统能智能识别停留地点并自动标记为"访问"
• 行程分析：自动检测移动轨迹，识别交通工具类型（步行、驾车等）
• 时空可视化：提供直观的时间轴视图，展示每日活动轨迹

2. 隐私保护架构

• 零云端依赖：所有数据处理都在用户自有服务器完成
• 数据隔离：多用户支持确保不同用户数据完全独立
• 本地化处理：地理位置解析可在本地完成，无需依赖第三方服务

3. 多媒体集成

• 与自托管照片平台深度整合
• 基于地理位置的照片自动归类
• 支持全屏照片浏览和键盘导航

技术架构

Reitti采用现代化的微服务架构：

• 后端：基于JVM的高性能服务
• 数据库：PostgreSQL+PostGIS提供空间数据支持
• 消息队列：RabbitMQ实现异步任务处理
• 前端：响应式Web界面，适配各种设备

部署指南

Docker Compose推荐方案（完整环境）

# 获取部署配置文件
git clone <项目仓库>
cd reitti

# 一键启动所有服务
docker-compose up -d

此方案会自动配置：

• PostgreSQL数据库（带PostGIS扩展）
• RabbitMQ消息队列
• Reitti应用服务

独立Docker部署

docker pull dedicatedcode/reitti:latest
docker run -p 8080:8080 \
  -e POSTGIS_HOST=postgres \
  -e POSTGIS_PORT=5432 \
  # 其他必要环境变量...
  dedicatedcode/reitti:latest

注意：独立部署需要预先配置好PostgreSQL和RabbitMQ服务

关键环境变量说明

变量名	作用	默认值
POSTGIS_HOST	数据库主机地址	postgis
RABBITMQ_PORT	消息队列端口	5672
SERVER_PORT	应用服务端口	8080
JAVA_OPTS	JVM调优参数	空

使用入门

1. 初始配置：通过Web界面创建管理员账户
2. 数据导入：支持多种格式历史数据导入
   • GPX：标准GPS交换格式
   • Google Takeout：谷歌位置历史导出数据
   • GeoJSON：通用地理数据格式
3. 实时追踪：配置移动端应用连接
4. 照片整合：设置自托管照片服务连接

移动端集成方案

推荐使用以下应用进行实时位置上报：

• OwnTracks：跨平台，注重隐私
• GPSLogger：Android专属，轻量级
• 自定义应用：通过REST API集成

版本策略

• 开发版(develop)：前沿功能，适合技术尝鲜者
• 稳定版(latest)：经过测试的主流版本
• 特定版本(x.y.z)：锁定版本，适合生产环境

技术优势

1. 高性能处理：异步任务队列确保大数据量处理不阻塞
2. 空间索引：PostGIS提供高效的地理查询能力
3. 可扩展架构：支持自定义地理编码服务等扩展

典型应用场景

• 个人数字足迹分析：了解自己的活动模式
• 旅行记录：自动生成行程日志
• 家庭位置共享：在私有环境中共享位置
• 照片地理标记：自动关联照片与拍摄地点

常见问题解答

Q：需要多少服务器资源？ A：基础配置建议2核CPU/4GB内存，大数据量用户建议4核CPU/8GB内存

Q：支持多大数量的位置点？ A：测试环境下可轻松处理百万级位置点，实际性能取决于硬件配置

Q：数据如何备份？ A：建议定期备份PostgreSQL数据库，可使用pg_dump工具

通过本指南，您应该已经对Reitti项目有了全面的了解。无论是隐私意识强的个人用户，还是需要自建位置服务的技术爱好者，Reitti都提供了一个功能完善且可控的解决方案。