wanderer
自托管的户外轨迹数据库，可上传、管理和搜索 GPS 轨迹，支持地图可视化和元数据标注。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
自己掌控所有户外轨迹，像管理相册一样管理你的徒步路线。
核心功能
- 上传或创建 GPS 轨迹并添加丰富元数据（难度、照片、笔记等）
- 基于 MeiliSearch 的极速全文搜索和多条件过滤
- 内置地图查看器，支持多种图层和海拔剖面图
- 分享轨迹给他人，也能浏览公开的路线库
- 创建自定义列表来分类整理轨迹
避坑指南
- •⚠️ 如果你不是在 localhost:3000 访问，务必修改 docker-compose.yml 中的 ORIGIN 环境变量，否则会出现 CORS 错误。
- •⚠️ 生产环境使用前必须修改 MEILI_MASTER_KEY 为强密码，默认值不安全。
- •⚠️ 首次启动需要约 90 秒完成初始化，请耐心等待。
适用场景
- 户外爱好者想把自己所有的徒步、骑行、跑步轨迹统一管理并快速找到
- 团队或俱乐部需要一个私有的轨迹分享库，避免把数据上传到商业平台
- 想保留数据主权，不依赖任何第三方服务来存储和搜索 GPS 文件
详细介绍
wanderer 是一款自托管的户外轨迹数据库，你可以上传自己记录的 GPS 轨迹，或者直接规划新路线，然后添加难度、照片、笔记等丰富元数据。它内置了强大的 MeiliSearch 搜索引擎，让你能瞬间找到想要的轨迹。你可以和朋友分享轨迹，浏览他们的路线，还能用自定义列表来整理收藏。地图查看器支持多种图层和海拔剖面图。专为徒步、骑行等户外爱好者设计，让你彻底掌控自己的数据，无需依赖 AllTrails 或 Strava 等商业平台。通过 Docker Compose 即可轻松部署。
常见问题与排障 (1)
故障排除为什么在恢复PocketBase备份后，Meilisearch会报“invalid API key”错误？
这是因为PocketBase中存储的MeiliSearch API key与当前Meili实例中的密钥不匹配。要修复，还需从同一备份中恢复MeiliSearch数据卷（/meili_data/data.ms文件夹）。如果没有备份，可能需要重新上传trails来重建索引，或者在PocketBase设置中重新配置API key。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：确保已安装 Docker 和 Docker Compose
步骤2：下载 docker-compose.yml 文件：wget https://raw.githubusercontent.com/open-wanderer/wanderer/main/docker-compose.yml
步骤3：在终端运行 docker compose up -d，等待约 90 秒
- 步骤1：确保已安装 Docker 和 Docker Compose
- 步骤2：下载 docker-compose.yml 文件：wget https://raw.githubusercontent.com/open-wanderer/wanderer/main/docker-compose.yml
- 步骤3：在终端运行 docker compose up -d，等待约 90 秒
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
运行 docker compose down 停止并删除容器，再手动删除数据卷（docker volume ls | grep wanderer 后 docker volume rm）以清理所有存储的数据。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
1 FAQ