TREK

TREK 是一個自架的即時協作旅遊規劃器，內建地圖、預算、打包清單、旅遊日誌與 AI。

功能特色

• 行程規劃 — 拖拉式每日行程編輯器、Leaflet／Mapbox 互動式 3D 地圖、路線最佳化、天氣預報
• 旅遊管理 — 訂位管理（航班、住宿、餐廳）、多幣別預算追蹤、打包清單、文件附件、PDF 匯出
• 多人協作 — WebSocket 即時同步、角色權限管理、邀請連結、SSO（OIDC）、二階段驗證、群組聊天／筆記／投票
• 行動裝置與 PWA — 可安裝至 iOS／Android、Service Worker 離線支援、原生般的使用體驗
• 附加模組 — Lists、Budget、Documents、Collab、Vacay、Atlas（世界足跡地圖）、Journey（旅遊日誌）、Naver 清單匯入、MCP
• AI／MCP — 內建 OAuth 2.1 MCP 伺服器，含 150+ 工具、27 種權限、預製提示詞（trip-summary、packing-list、budget-overview）
• 管理員後台 — 儀表板、深色模式、15 種語言、自動備份、使用者／邀請／範本／API 金鑰管理

首次啟動

首次啟動時 TREK 會建立管理員帳號：

• 若設定了 ADMIN_EMAIL／ADMIN_PASSWORD，會使用該帳密。
• 否則隨機產生的帳密會印在容器日誌中，請至服務的 Logs 分頁查看。

環境變數

如有需要，請於服務的環境變數分頁中設定下列變數。

變數	說明
ENCRYPTION_KEY	用於加密儲存的密鑰（API 金鑰、TOTP、SMTP、OIDC）。本模板已預設；若移除，TREK 會自動產生並寫入 /app/data/.encryption_key。
ADMIN_EMAIL	首次啟動時建立的管理員 Email。
ADMIN_PASSWORD	首次啟動時建立的管理員密碼。
JWT_SECRET	選用。Session token 簽章金鑰；未設定時自動產生。

其他設定（SSO/OIDC、SMTP、Mapbox／Google Places API、附加模組、備份等）可於部署後在應用內的管理員後台中管理。

資料持久化

本模板掛載兩個 Volume，重啟與重新部署時資料不會遺失：

• /app/data — SQLite 資料庫、加密金鑰、JWT secret
• /app/uploads — 使用者上傳的檔案（文件、相片、附件）

原始碼

GitHub Repository · Docker Hub