什么是GeoPulse:这款自托管的Google Timeline替代品完整功能介绍

原创2026-10-11 14:52:571,987 阅读

什么是GeoPulse:这款自托管的Google Timeline替代品完整功能介绍

GeoPulse 是一款自托管、隐私优先的 Google Timeline 替代品和个人位置时间线平台。它能将 OwnTracks、GPSLogger 等应用的原始 GPS 数据自动转换为「停留、行程、数据缺口」组成的可搜索时间线,并可与 Immich 相册、Memos 笔记和天气数据联动——所有数据都运行在你自己的服务器上。本文将带你完整认识它的 8 大核心能力,帮你在 10 分钟内判断它是否适合你。

GeoPulse自托管Google Timeline替代品的时间线总览地图

一句话理解 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 道路匹配,让噪点路线「贴合真实道路」
  • 选中任意行程可逐步回放,查看天气、速度等细节

GeoPulse时间线中的行程回放与路线地图

📄 相关文档:core-features/timeline.md、timeline/trip_detection.md

2️⃣ 位置源一键接入:兼容主流 GPS 应用

打开「Location Sources」页面,即可连接你已经在用的定位工具:

OwnTracks(HTTP/MQTT)、Overland、GPSLogger、Home Assistant、Traccar、Dawarich、Colota

每个源都可以单独配置 GPS 过滤规则,避免漂移点污染你的时间线。

GeoPulse位置源管理页面与GPS应用接入指南

📄 相关文档:gps-sources/overview.md

3️⃣ 历史数据导入:Google Timeline 数据完整迁移

不想从头积累数据?GeoPulse 支持批量导入历史数据,文件最大支持 2GB,且支持断点续传式流式解析:

  • Google Timeline / Google 位置历史记录导出(Takeout)
  • GPX(Garmin、Strava 等)、GeoJSON、CSV、OwnTracks 导出
  • GeoPulse 备份文件(换机/换服务器无缝迁移)

导入完成后会自动在后台重新生成时间线,大文件一般 10–30 分钟即可完成。

GeoPulse历史位置数据导入页面与Google Timeline迁移

📄 相关文档:interacting-with-data/import-export.md

4️⃣ 位置分析:像 Google 时间线一样复盘你的足迹

「Location Analytics」按地图、城市、国家三个维度展示你访问过的每个地方,包括重复到访的地点和访问频率;Coverage Explorer 还能用热力图展示你探索过的街道与街区。

GeoPulse位置分析地图与访问城市国家统计

Journey Insights 则更进一步:自动计算累计里程、到访国家/城市、时间规律、里程碑和徽章;Rewind 提供每月/每年的行程、距离与亮点总结,Dashboard 展示 7 天/30 天的出行概览图表。

GeoPulse行程洞察旅行统计与里程碑徽章

📄 相关文档:core-features/journey-insights.md、core-features/rewind.md

5️⃣ Immich 照片 + Memos 笔记集成:时间线「活」起来

这是 GeoPulse 最大的差异化亮点之一:不复制照片原件,而是直接把 Immich 相册里与时间段匹配的照片显示在时间线地图上;Memos 中的带时间戳笔记、以及行程/停留点的天气数据也会同步叠加展示。

Immich照片集成在GeoPulse时间线地图上的效果示例

📄 相关文档:personalization/immich-integration.md

6️⃣ AI 助手与 MCP:直接用自然语言「问」你的位置数据

GeoPulse 内置可选的 AI 助手(自带 OpenAI 兼容 API Key,密钥仅加密用于你的请求),可以问出:

  • 「我上个月骑了多少公里?」
  • 「2024 年我去过哪些城市?」
  • 「我在健身房附近待了多久?」

同时提供只读 MCP Server,让 Claude 等 AI 客户端通过 API Token 安全地查询你的时间线与授权内的好友数据。

GeoPulse AI助手对话界面与位置数据分析问答

📄 相关文档:using-geopulse/ai-assistant.md、api/mcp.md

7️⃣ 好友与分享链接:隐私完全自己说了算

  • 好友系统:逐个好友控制可见范围——实时位置、历史时间线可分别授权
  • 访客分享链接:可选密码保护、过期时间、一键撤销,适合「旅行时把实时位置发给家人」的场景
  • 内置邀请制多用户、角色权限和管理员审计日志

GeoPulse分享链接管理页面与隐私授权控制

📄 相关文档:social-and-sharing/friends.md、social-and-sharing/public-links.md

8️⃣ 个性化与移动端:一台手机也能用

界面支持英文/乌克兰语、深色/浅色主题、公制/英制单位、自定义时区与自定义地图瓦片;Web 应用针对手机深度优化,可作为 PWA 安装到主屏幕。

GeoPulse个人设置页面与语言时区单位自定义

📄 相关文档: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 内存)、无遥测、支持完整数据导出与账号删除

更多资料

💡 GeoPulse 采用 BSL 1.1 许可证:个人、教育与非商业用途免费,商业使用需另行获取许可,详见 LICENSE。

登录后查看全文
geopulse