TREK 是一款开源自托管旅行规划工具,支持多人实时协作规划行程、可视化地图、预算管理、打包清单和 AI 助手。内置交互式地图、费用分摊、打包清单、旅游游记和 MCP AI 助手,一条 Docker 命令即可快速部署,数据完全私有,适合爱好旅行的极客群体,文末附详细使用教程

🎤 引言

旅行规划这事儿,大部分人现在还靠微信群 + 备忘录 + Excel 表格混着来。行程分散在各个地方,出发前临时找酒店、记预算、算分摊,每次都像打仗。

TREK 就是来解决这个问题的——一个开源自托管的旅行规划平台,把地图、预算、打包清单、游记和 AI 助手全部整合在一起,数据完全在自己手里,不需要任何订阅费用。


⭐ 核心功能

🧭 行程规划

拖拽式日计划安排,支持交互式地图(Leaflet 或 Mapbox GL),可以搜索地点、导入 Google Maps 列表、GPX/KML/GeoJSON 文件。还能自动优化路线并导出到 Google Maps。天气数据用 Open-Meteo(无需 API Key),16 天预报直接看。

🧳 旅行管理

管理所有预订信息:航班、酒店、餐厅,支持上传确认文件和 PDF。预算追踪和分摊(类似 Splitwise 风格),支持多币种。打包清单可以分配给不同成员,追踪进度。还有文档管理功能,行程相关文件直接上传附件(单个 ≤50MB)。

👥 多人实时协作

基于 WebSocket 的实时同步,成员变动立即生效。支持角色权限控制、一次性或可复用邀请链接。SSO 支持 Google、Apple、Authentik、Keycloak 等 OIDC 提供商。还有 Passkeys 无密码登录、2FA 双重验证。

🤖 AI 助手 & MCP

内置 MCP 服务器(OAuth 2.1 认证),暴露 150+ 工具和 30 个资源。AI 可以帮你创建行程、规划每日安排、生成打包清单、管理预算、标记去过哪些国家。支持 trip-summarypacking-listbudget-overview 等预置提示词。

📱 移动端 & PWA

可以直接从浏览器安装为 iOS/Android 应用,支持离线模式(Service Worker 缓存地图瓦片和 API 数据),全屏沉浸式体验,触摸操作优化。


📥 安装与使用

一条命令跑起来:

ENCRYPTION_KEY=$(openssl rand -hex 32) docker run -d -p 3000:3000 \
  -e ENCRYPTION_KEY=$ENCRYPTION_KEY \
  -v ./data:/app/data -v ./uploads:/app/uploads mauriceboe/trek

然后打开 http://localhost:3000 即可。初次启动会自动创建管理员账户,如果设置了 ADMIN_EMAILADMIN_PASSWORD 环境变量则使用这些凭据,否则凭据会打印在容器日志里(docker logs trek)。

还支持 Docker Compose、Helm/Kubernetes 部署。官方也提供在线 Demo,可以先体验再决定要不要部署。

技术栈:Node.js 22 + NestJS 11 + SQLite + React 19 + Vite,纯前端单页应用,后端 NestJS 提供 REST + WebSocket API,SQLite 数据库无需额外部署。


🎯 适用场景

结伴出行:多人共同规划行程,实时同步改动,不用再微信来回传文件。费用分摊自动计算,谁欠谁一目了然。

独立旅行者:用 Vacay 模块管理个人行程日历、100+ 国家的节假日信息、剩余假期追踪。Atlas 记录去过哪些国家,Journey 写游记博客。

技术爱好者:TREK 完全自托管,代码开源(AGPL v3),数据存在自己的服务器上。可以接入 AirTrail 导入自托管航班数据,接入 Immich/Synology 同步旅行照片。


🔍 对比与替代方案

同类工具里,Notion + Public Templates 可以做旅行规划,但协作功能需要付费版。Google Trips 已停止服务。 Wanderlog 更偏向 SaaS,数据在云端。TREK 的优势在于完全开源自托管,一条 Docker 命令就能跑起来,数据完全私有,还内置了 AI 助手能力。

GitHub 仓库活跃度高(1276 次提交),维护者持续更新,功能迭代快。缺点是纯英文界面,对中文用户有一点门槛。

项目地址:https://github.com/mauriceboe/TREK


⚠️ 注意事项

首次部署需要配置 ENCRYPTION_KEY,建议配合反向代理启用 HTTPS。SQLite 数据库适合中小规模团队(单文件存储,高并发场景有限),如果行程数据量极大可能需要考虑其他方案。AI 助手功能依赖 MCP 协议,部分高级功能需要进一步配置。


✅ 总结

维度评价
易用性一条 Docker 命令跑起来,对技术用户友好
功能完整度地图、预算、打包、协作、AI 全覆盖
隐私可控性完全自托管,数据在自己手里
维护活跃度1276 次提交,持续迭代中
推荐指数⭐⭐⭐⭐ 适合喜欢自托管的旅行爱好者