Freika/dawarich
Freika/dawarich has 10,859 GitHub stars and 418 forks. GitHot measured +16 stars in 24 hours. Last checked 2026-11-08 16:54 UTC. Last push 2026-11-04.
Your favorite self-hostable alternative to Google Timeline (Google Location History)
实测星标增长
- 24小时
- +16
- 7天
- 更新延迟
- 15天
- 更新延迟
- 1个月
- 更新延迟
各周期内的星标净变化，周期相互重叠，并非每日新增。缺失的测量保持空白。星标代表关注度，不代表软件质量。
README.zh-CN.md
原文🌍 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
- 克隆本仓库。
- 运行以下命令启动应用：
docker compose -f docker/docker-compose.yml up - 访问
http://localhost:3000即可打开应用。
停止应用：按下 Ctrl+C。
你可以直接使用默认配置，也可以基于 .env.example 创建 .env 文件来自定义你的配置。
如何安装 Dawarich
默认凭据
- 用户名：
[email protected] - 密码：
safepassword可以随时在账户设置中修改它们。
功能特性
位置追踪
- 使用受支持的应用追踪你的实时位置。
位置历史可视化
- 在地图上查看你的历史数据，支持多种可自定义图层：
- 热力图
- 轨迹点
- 点与点之间的连线
- 战争迷雾
家庭共享
- 与家庭成员共享你的位置。
- 查看家庭成员的位置（需经过他们同意）。
- 每位家庭成员都可以单独开启或关闭位置共享。
区域
- 在地图上绘制区域，让 Dawarich 帮你识别在此处的到访记录。
到访记录（测试版）
- Dawarich 能够识别你去过的地点，并让你确认或拒绝这些记录。
统计
- 分析你的旅行历史：按年、按月细分的去过国家/城市数量、旅行距离、花费时间等。
洞察
- 获取关于你的位置历史的洞察，比如"你去得最多的地方是家，共到访 120 次"，或"你在 2024 年于巴黎待了 30 天"。
在各国停留天数
- 查看你在每个国家停留了多少天。无论是用于税务居民身份判定，还是单纯想知道自己大部分时间待在哪里，都很实用。
行程
- 创建一段行程，可视化你在两个时间点之间的旅行轨迹。你可以查看路线、距离和花费的时间，还能为行程添加备注。如果你集成了 Immich 或 Photoprism，还能看到行程中拍摄的照片！
集成
- 提供 Immich 或 Photoprism（甚至两者都提供！）的凭据后，Dawarich 会自动从你的照片中导入地理数据。
- 你还可以在地图上可视化你的照片！
导入你的数据
- 支持从多种来源导入：
- Google 地图时间线
- OwnTracks
- Strava
- Immich
- GPX/GeoJSON 文件
- 照片的 EXIF 数据
导出你的数据
- 将你的数据导出为 GeoJSON 或 GPX 格式。
📚 指南与教程
更多指南请查看官方文档。
环境变量
关于环境变量与配置项的详细说明，请查阅官网文档。
Star 历史
你大概也猜到了，我（作者）挺喜欢看统计数据的。
关于简体中文版
Dawarich 通过标准的 Rails I18n 机制内置了简体中文语言包（config/locales/zh.yml 等），无需额外配置。在「设置 → 通用」页面即可将界面切换为中文。
本文档是 README.md 的中文翻译。如果两者内容不一致，请以英文版为准。