tess1o/geopulse

这是什么？

核心功能

• 01将 GPS 点转换为停留、行程和数据缺口，并划分出行方式。
• 02支持从 OwnTracks、Overland、GPSLogger、Home Assistant、Traccar、Dawarich、Colota 实时接收位置。
• 03可将 Immich 照片、Memos 笔记和天气信息叠加到地图历史中。
• 04通过 Valhalla 进行地图匹配，使行程轨迹贴合道路。
• 05支持从 Google Timeline、GPX、GeoJSON、OwnTracks 和 CSV 导入，并导出为标准格式。
• 06提供 MCP 服务和基于 OpenAI 兼容接口的 AI 对话功能。

适用场景

• 在自有服务器上保存个人移动记录，不依赖云端位置服务。
• 把行程和停留与 Immich 相册中的照片放在一起查看。
• 在可控的可见范围内与家人或朋友共享实时位置和历史轨迹。
• 导入已有的 Google Timeline 数据，并在自己的服务器上浏览。

快速上手

1. 1

   创建目录并下载配置文件

   mkdir geopulse && cd geopulse curl -L -o .env https://raw.githubusercontent.com/tess1o/GeoPulse/main/.env.example curl -L -o docker-compose.yml https://raw.githubusercontent.com/tess1o/GeoPulse/main/docker-compose.yml
2. 2

   启动容器

   docker compose up -d
3. 3

   在 localhost:5555 打开应用，生产环境请先检查 .env 中的安全设置

使用前须知

• !采用 BSL 1.1 许可证，属于源码可用而非 OSI 定义的开源许可证。
• !需要自行部署和维护服务器来存放位置数据。
• !部分集成功能（如 AI 聊天）需要您自备兼容 OpenAI 的 API 密钥。

标签

常见问题

geopulse 是什么？

自托管的位置时间线工具，将 OwnTracks、Overland 等 GPS 数据转为停留、行程和分析，可替代 Google Timeline。 GeoPulse 是一个自托管的位置历史平台。它接收 OwnTracks、Overland、GPSLogger、Home Assistant、Traccar、Dawarich、Colota 等来源的 GPS 数据，将其整理为可搜索的时间线，包含停留、行程和数据缺口，并为每段行程划分出行方式。

geopulse 可以免费使用吗？用的什么许可证？

geopulse 以 Other 许可证开源。用于商业产品前，请先确认许可证条款。

geopulse 还在维护吗？

活跃维护中。geopulse 最近一次提交是在 2026年10月19日。

geopulse 适合用来做什么？

在自有服务器上保存个人移动记录，不依赖云端位置服务。 把行程和停留与 Immich 相册中的照片放在一起查看。 在可控的可见范围内与家人或朋友共享实时位置和历史轨迹。 导入已有的 Google Timeline 数据，并在自己的服务器上浏览。

geopulse 怎么安装和运行？

创建目录并下载配置文件: mkdir geopulse && cd geopulse curl -L -o .env https://raw.githubusercontent.com/tess1o/GeoPulse/main/.env.example curl -L -o docker-compose.yml https://raw.githubusercontent.com/tess1o/GeoPulse/main/docker-compose.yml 启动容器: docker compose up -d 在 localhost:5555 打开应用，生产环境请先检查 .env 中的安全设置

在哪里获取 geopulse？

源代码和安装说明在 GitHub 上：https://github.com/tess1o/geopulse