Freika /dawarich
Your favorite self-hostable alternative to Google Timeline (Google Location History)
★ 10,963⑂ 422👁 27⑃ 1,642● 1,622▤ 343
+12
日增长
+102
周增长
10,963
stars
422
forks
27
watchers
1,642
prs
1,622
issues
343
releases
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 的中文翻译。如果两者内容不一致,请以英文版为准。
Top issues
#3105Postgres database dawarich_development is unavailable11 comments · 2026-07-10#2536Android app shows current location but does not record tracking points11 comments · 2026-04-27#2711Countries flown over are still displayed in trips and Year-End Digests10 comments · 2026-05-13#3658App to Server Sync Issue.7 comments · 2026-09-17#2974Date-range filtering selects points by the account timezone, not by each point's local time7 comments · 2026-06-20#3986Exploration::RebuildJob: back-to-back full-history rebuilds6 comments · 2026-11-02#3662Android Mobil App eats the Battery5 comments · 2026-09-18#3844Bad map performance after recent update4 comments · 2026-10-14
Discussions
#4021Map click to search0 comments · 2026-11-11#4019Possibility to jump from places to visits0 comments · 2026-11-11#4014[Feature Request]: More Options for Android automations0 comments · 2026-11-09#4008[Feature request] Override Android system theme0 comments · 2026-11-07#3998Track generation issue and other QOL0 comments · 2026-11-05#3997Feature request - A Ready status indicator after the application is fully loaded and finished any migrations0 comments · 2026-11-05#3990Feature Request: Adaptive Zoom and Automatic Viewport Adjustment During Playback0 comments · 2026-11-03#3987Dawarich app: store recorded points on device0 comments · 2026-11-03
Latest release
1.23.0 1.23.0 2026-11-15⚠️ Upgrade notes - Immich, Photoprism, AirTrail, TeslaMate and TREK no longer follow redirects. If an integration URL redirects, for example from http:// to https://, save the final URL in Settings → Integrations. The connection test and a notification from the background import say where the redirect points. - The Docker image no longer contains curl, git or npm. A healthcheck or script of your own that calls curl inside the container fails after the upgrade: use wget -qO -, as the bundled compose files do. - GET /api/v1/settings no longer returns integration API keys, and restoring an a