什么是GeoPulse:这款自托管的Google Timeline替代品完整功能介绍
什么是GeoPulse:这款自托管的Google Timeline替代品完整功能介绍
GeoPulse 是一款自托管、隐私优先的 Google Timeline 替代品和个人位置时间线平台。它能将 OwnTracks、GPSLogger 等应用的原始 GPS 数据自动转换为「停留、行程、数据缺口」组成的可搜索时间线,并可与 Immich 相册、Memos 笔记和天气数据联动——所有数据都运行在你自己的服务器上。本文将带你完整认识它的 8 大核心能力,帮你在 10 分钟内判断它是否适合你。
一句话理解 GeoPulse
如果把 Google 时间线比作 Google 云端帮你保管的「位置记忆」,那 GeoPulse 就是把这份记忆搬回自己家里的自托管版本:
| 对比维度 | Google Timeline | GeoPulse |
|---|---|---|
| 数据存放 | Google 云端 | 你自己的服务器/NAS |
| 数据来源 | 仅限 Android | OwnTracks、Overland、GPSLogger、Home Assistant、Traccar 等多源 |
| 第三方跟踪 | 有 | 无遥测、无分析信标 |
| 资源占用 | — | 通常 < 100MB 内存、< 1% CPU |
| 授权 | — | BSL 1.1,个人/教育用途免费 |
它还支持多用户、邀请制、OIDC/SSO 单点登录,可以作为一个家庭的「位置共享中心」来部署。
GeoPulse 的 8 大核心功能详解
1️⃣ 智能时间线:GPS 点自动变行程
GeoPulse 会把零散的 GPS 点位智能分类为 停留(Stays)、行程(Trips)和数据缺口(Data Gaps),并在地图上按天回放你的路线。
- 检测灵敏度、行程判定阈值、出行方式分类(驾车/步行/骑行等)全部可配置
- 支持基于 Valhalla 的 Map Matching 道路匹配,让噪点路线「贴合真实道路」
- 选中任意行程可逐步回放,查看天气、速度等细节
📄 相关文档:core-features/timeline.md、timeline/trip_detection.md
2️⃣ 位置源一键接入:兼容主流 GPS 应用
打开「Location Sources」页面,即可连接你已经在用的定位工具:
OwnTracks(HTTP/MQTT)、Overland、GPSLogger、Home Assistant、Traccar、Dawarich、Colota
每个源都可以单独配置 GPS 过滤规则,避免漂移点污染你的时间线。
📄 相关文档:gps-sources/overview.md
3️⃣ 历史数据导入:Google Timeline 数据完整迁移
不想从头积累数据?GeoPulse 支持批量导入历史数据,文件最大支持 2GB,且支持断点续传式流式解析:
- Google Timeline / Google 位置历史记录导出(Takeout)
- GPX(Garmin、Strava 等)、GeoJSON、CSV、OwnTracks 导出
- GeoPulse 备份文件(换机/换服务器无缝迁移)
导入完成后会自动在后台重新生成时间线,大文件一般 10–30 分钟即可完成。
📄 相关文档:interacting-with-data/import-export.md
4️⃣ 位置分析:像 Google 时间线一样复盘你的足迹
「Location Analytics」按地图、城市、国家三个维度展示你访问过的每个地方,包括重复到访的地点和访问频率;Coverage Explorer 还能用热力图展示你探索过的街道与街区。
Journey Insights 则更进一步:自动计算累计里程、到访国家/城市、时间规律、里程碑和徽章;Rewind 提供每月/每年的行程、距离与亮点总结,Dashboard 展示 7 天/30 天的出行概览图表。
📄 相关文档:core-features/journey-insights.md、core-features/rewind.md
5️⃣ Immich 照片 + Memos 笔记集成:时间线「活」起来
这是 GeoPulse 最大的差异化亮点之一:不复制照片原件,而是直接把 Immich 相册里与时间段匹配的照片显示在时间线地图上;Memos 中的带时间戳笔记、以及行程/停留点的天气数据也会同步叠加展示。
📄 相关文档:personalization/immich-integration.md
6️⃣ AI 助手与 MCP:直接用自然语言「问」你的位置数据
GeoPulse 内置可选的 AI 助手(自带 OpenAI 兼容 API Key,密钥仅加密用于你的请求),可以问出:
- 「我上个月骑了多少公里?」
- 「2024 年我去过哪些城市?」
- 「我在健身房附近待了多久?」
同时提供只读 MCP Server,让 Claude 等 AI 客户端通过 API Token 安全地查询你的时间线与授权内的好友数据。
📄 相关文档:using-geopulse/ai-assistant.md、api/mcp.md
7️⃣ 好友与分享链接:隐私完全自己说了算
- 好友系统:逐个好友控制可见范围——实时位置、历史时间线可分别授权
- 访客分享链接:可选密码保护、过期时间、一键撤销,适合「旅行时把实时位置发给家人」的场景
- 内置邀请制多用户、角色权限和管理员审计日志
📄 相关文档:social-and-sharing/friends.md、social-and-sharing/public-links.md
8️⃣ 个性化与移动端:一台手机也能用
界面支持英文/乌克兰语、深色/浅色主题、公制/英制单位、自定义时区与自定义地图瓦片;Web 应用针对手机深度优化,可作为 PWA 安装到主屏幕。
📄 相关文档:personalization/profile-settings.md
快速上手:3 步部署 GeoPulse
GeoPulse 提供 Docker Compose、Unraid、Proxmox LXC、Kubernetes/Helm、裸机手动安装等多种部署方式,最常用的是 Docker Compose:
# 1. 克隆仓库
git clone https://gitcode.com/gh_mirrors/ge/geopulse
cd geopulse
# 2. (可选)检查 .env 安全配置后启动
docker compose up -d
3. 浏览器访问 http://localhost:5555,创建的第一个账号自动成为管理员,随后按 initial-setup 指南 完成初始配置即可。
Kubernetes 用户则可通过仓库内的 Helm Chart 一键安装:helm/geopulse/Chart.yaml,部署示例见 helm/examples/。
谁适合用 GeoPulse?
- ✅ Google Timeline 用户:想要同等体验但数据必须掌握在自己手里
- ✅ Homelab / NAS 玩家:已有 Immich + Memos 栈,希望位置数据与照片笔记自动联动
- ✅ 家庭共享场景:多账号、可控粒度地与家人分享位置
- ✅ 自托管爱好者:轻量(<100MB 内存)、无遥测、支持完整数据导出与账号删除
更多资料
- 项目说明:README.md
- 快速入门指南:getting-started/quick-start.md
- 架构总览:getting-started/architecture-overview.md
- Docker Compose 部署文档:getting-started/deployment/docker-compose.md
- 行程规划(Trip Plans):core-features/trip-plans.md
- 探索度地图效果图:images/coverage_map.jpg
💡 GeoPulse 采用 BSL 1.1 许可证:个人、教育与非商业用途免费,商业使用需另行获取许可,详见 LICENSE。









