Freika /dawarich

Your favorite self-hostable alternative to Google Timeline (Google Location History)

★ 10,909⑂ 420👁 26⑃ 1,635● 1,606▤ 342◈ 744

RubyAGPL-3.0Created 2024-03-24dawarich.app?utm_source=github&utm_medium=project_descriptio

GitHub ↗

10,909

stars

+48

420

forks

watchers

1,635

prs

1,606

issues

342

releases

744

discussions

README

🌍 Dawarich：可自托管的位置历史记录追踪器

English | 简体中文

 

 |  |  | 

---

 截图

!地图
地图视图

!时间线
时间线视图

!洞察
洞察页面

!家庭
家庭页面

!统计
统计概览

!行程
行程页面

---

 关于 Dawarich

如果你在找托管版的 Dawarich Cloud（一切都由官方帮你打理），可以看看 Dawarich Cloud。

Dawarich 是一个可自托管的 Web 应用，用来替代 Google 时间线（即 Google 位置历史记录）。
它能帮你：

- 追踪你的位置历史记录。
- 在交互式地图上可视化你的数据。
- 创建行程并分析你的旅行历史。
- 与家庭成员共享你的位置。
- 与 Immich、Photoprism 等照片管理应用集成，可视化带地理信息的照片。
- 从 Google 地图时间线、OwnTracks、GPX、GeoJSON 等多种来源导入你的位置历史记录。
- 探索统计数据，比如去过的国家/城市数量、总旅行距离等等！
- 与家庭成员共享你的位置。

更新日志：查看 CHANGELOG.md 获取最新动态。

参与贡献：查看 CONTRIBUTING.md 了解如何为 Dawarich 做贡献。

---

 ⚠️ 免责声明

 更新策略

- 请勿自动更新：升级前请先阅读发行说明。自动更新可能会破坏你的现有配置。
- 项目仍在积极开发中：预计会有频繁的更新、bug 与破坏性变更。
- 导入 Dawarich 后请勿删除原始数据。
- 更新前先备份：升级前请务必备份你的数据。
- 保持更新：为获得最佳体验，请确保运行的是最新版本。

---

 🧭 支持的位置追踪方式

你可以使用以下应用来追踪你的位置：

- 💫 Dawarich for iOS
- 🤖 Dawarich for Android
- 🗺️ Dawarich Community（Android）
- 🌍 Overland
- 🛰️ OwnTracks
- 🧭 GPSLogger
- 📱 PhoneTrack
- 🏡 Home Assistant

在你的设备上安装其中一个受支持的应用，并配置它把位置更新发送到你的 Dawarich 实例即可。

---

 如何在本地启动 Dawarich

1. 克隆本仓库。
2. 运行以下命令启动应用：
   bash
   docker compose -f docker/docker-compose.yml up
   
3. 访问 http://localhost:3000 即可打开应用。

停止应用：按下 Ctrl+C。

你可以直接使用默认配置，也可以基于 .env.example 创建 .env 文件来自定义你的配置。

---

 如何安装 Dawarich

- Docker 部署
- 群晖 Synology

默认凭据
- 用户名：[email protected]
- 密码：safepassword
可以随时在账户设置中修改它们。

---

 功能特性

 位置追踪
- 使用受支持的应用追踪你的实时位置。

 位置历史可视化
- 在地图上查看你的历史数据，支持多种可自定义图层：
  - 热力图
  - 轨迹点
  - 点与点之间的连线
  - 战争迷雾

 家庭共享
- 与家庭成员共享你的位置。
- 查看家庭成员的位置（需经过他们同意）。
- 每位家庭成员都可以单独开启或关闭位置共享。

 区域
- 在地图上绘制区域，让 Dawarich 帮你识别在此处的到访记录。

 到访记录（测试版）
- Dawarich 能够识别你去过的地点，并让你确认或拒绝这些记录。

 统计
- 分析你的旅行历史：按年、按月细分的去过国家/城市数量、旅行距离、花费时间等。

 洞察

- 获取关于你的位置历史的洞察，比如"你去得最多的地方是家，共到访 120 次"，或"你在 2024 年于巴黎待了 30 天"。

 在各国停留天数

- 查看你在每个国家停留了多少天。无论是用于税务居民身份判定，还是单纯想知道自己大部分时间待在哪里，都很实用。

 行程
- 创建一段行程，可视化你在两个时间点之间的旅行轨迹。你可以查看路线、距离和花费的时间，还能为行程添加备注。如果你集成了 Immich 或 Photoprism，还能看到行程中拍摄的照片！

 集成
- 提供 Immich 或 Photoprism（甚至两者都提供！）的凭据后，Dawarich 会自动从你的照片中导入地理数据。
- 你还可以在地图上可视化你的照片！

 导入你的数据
- 支持从多种来源导入：
  - Google 地图时间线
  - OwnTracks
  - Strava
  - Immich
  - GPX/GeoJSON 文件
  - 照片的 EXIF 数据

 导出你的数据
- 将你的数据导出为 GeoJSON 或 GPX 格式。

---

 📚 指南与教程

- 配置反向代理
- 导入 Google Takeout 数据
- 使用 Overland 追踪位置
- 使用 OwnTracks 追踪位置
- 导出你的数据

更多指南请查看官方文档。

---

 环境变量

关于环境变量与配置项的详细说明，请查阅官网文档。

---

 Star 历史

你大概也猜到了，我（作者）挺喜欢看统计数据的。


 
   
   
   
 


---

 关于简体中文版

Dawarich 通过标准的 Rails I18n 机制内置了简体中文语言包（config/locales/zh.yml 等），无需额外配置。在「设置 → 通用」页面即可将界面切换为中文。

本文档是 README.md 的中文翻译。如果两者内容不一致，请以英文版为准。

⚠️ Upgrade notes

- With ARCHIVE_RAW_DATA=true, set ARCHIVE_ENCRYPTION_KEY before upgrading: without it, production stops archiving raw data and only logs an error. On an instance that already has archives, use the current SECRET_KEY_BASE value; otherwise generate a key with bin/rails secret. Keep the key safe, because cleared raw data cannot be recovered without it.

 Added

- Split Tracks at midnight in your timezone with a new option in the map's Track generation settings, so a night at home with your phone still reporting no longer joins several days into one Track. It is off by defa

Snapshot: 2026-11-10T09:35:25Z · Data license Apache-2.0 · JSON

Freika /dawarich

README

Top issues

Discussions

Latest release