freikin/dawarich

自托管Google位置历史替代方案镜像

镜像概述

该镜像是一个自托管解决方案，旨在替代Google地图时间线（Google Location History）服务。它允许用户完全控制个人位置数据，通过本地存储实现隐私保护，避免依赖第三方云服务，适用于注重数据主权和隐私安全的用户。

核心功能与特性

• 数据私有化存储：位置数据存储在用户自有服务器，无第三方访问权限
• Google数据兼容：支持从Google Takeout导入历史位置数据（JSON格式）
• 时间线可视化：提供类似Google地图的交互式位置时间线视图，按时间轴展示移动轨迹
• 多源数据导入：支持从手机GPS应用、位置记录器等多设备导入位置数据
• 数据管理功能：提供数据备份、导出（CSV/JSON格式）和批量删除工具
• 地图集成：内置地图引擎，支持位置标记、路径显示和区域统计
• 隐私保护机制：可选数据加密存储，支持访问权限控制

使用场景与适用范围

• 隐私敏感用户：需避免位置数据被Google等第三方收集的个人用户
• 数据主权需求：希望完全控制位置数据存储和使用的自托管爱好者
• Google服务替代：因政策限制或隐私顾虑无法使用Google位置历史的用户
• 离线数据访问：需要在无网络环境下查看历史位置记录的场景

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name location-timeline \
  -p 8080:8080 \
  -v /path/to/local/data:/app/data \
  -e TZ=Asia/Shanghai \
  -e PUID=1000 \
  -e PGID=1000 \
  location-timeline:latest

Docker Compose配置

yaml
version: '3.8'
services:
  location-timeline:
    image: location-timeline:latest
    container_name: location-timeline
    restart: unless-stopped
    ports:
      - "8080:8080"  # Web访问端口
    volumes:
      - /path/to/local/data:/app/data  # 持久化存储位置数据
      - /path/to/imports:/app/imports  # 数据导入目录（可选）
    environment:
      - TZ=Asia/Shanghai  # 设置时区
      - PUID=1000         # 运行用户ID（匹配宿主机用户）
      - PGID=1000         # 运行组ID（匹配宿主机用户）
      - DB_TYPE=sqlite    # 数据库类型（支持sqlite/postgres/mysql）
      - LOG_LEVEL=info    # 日志级别（debug/info/warn/error）

环境变量配置

数据导入流程

1. 导出Google位置数据：

   • 访问Google Takeout
   • 仅选择"位置历史"（Location History），格式选择JSON
   • 下载导出文件并解压

2. 导入至容器：

   • 将解压后的Records.json文件放入宿主机挂载的/path/to/imports目录
   • 访问服务Web界面（http://<服务器IP>:8080）
   • 进入"数据管理"→"导入"页面，选择文件完成导入

访问与使用

• 部署完成后，通过http://<服务器IP>:8080访问Web管理界面
• 首次登录需创建管理员账户（仅支持单用户模式）
• 功能模块包括：
  • 时间线视图：按日期查看位置轨迹和停留点
  • 数据统计：月度/年度位置分布图表
  • 设置中心：配置地图类型、数据保留策略、备份计划

注意事项

• 建议定期备份/app/data目录以防止数据丢失
• 若需外部访问，建议配合反向代理（如Nginx）启用HTTPS加密
• 移动端位置数据实时同步需配合支持的客户端应用（如OwnTracks）