TREK快速开始教程一条Docker命令30秒部署你的旅行规划系统【免费下载链接】TREKA self-hosted travel/trip planner with real-time collaboration, interactive maps, PWA support, SSO, budgets, packing lists, and more.项目地址: https://gitcode.com/GitHub_Trending/nomad22/TREKTREK 是一款功能强大的自托管旅行规划系统Travel Planner内置实时协作、互动地图、PWA 离线支持、SSO 单点登录、预算管理、打包清单等完整功能。本快速开始教程只需一条 Docker 命令30 秒拉取镜像并启动容器5 分钟内就能规划出你的第一段行程。 准备工作部署 TREK 前的 2 个前置条件开始之前请确认你的服务器满足以下两个条件条件说明Docker已安装并正在运行执行docker --version能正常返回版本号端口主机 3000 端口空闲也可映射到其他任意端口无需数据库、无需反向代理——TREK 使用 SQLite 作为存储全部装在一个容器里。 一条 Docker 命令30 秒启动 TREK复制下面这一条命令粘贴到终端执行即可ENCRYPTION_KEY$(openssl rand -hex 32) docker run -d \ --name trek \ -p 3000:3000 \ -e ENCRYPTION_KEY$ENCRYPTION_KEY \ -v ./data:/app/data \ -v ./uploads:/app/uploads \ --restart unless-stopped \ mauriceboe/trek:latest命令参数一目了然参数作用-d后台运行容器-p 3000:3000将容器端口映射到主机 3000 端口-e ENCRYPTION_KEY静态加密密钥用于加密 API 密钥、MFA 种子、OIDC 凭据等敏感数据-v ./data:/app/data持久化 SQLite 数据库、日志与密钥文件-v ./uploads:/app/uploads持久化你上传的照片和文档--restart unless-stopped服务器重启后自动拉起保证服务长期可用为什么建议手动生成加密密钥如果省略ENCRYPTION_KEYTREK 首次启动时会自动生成一个并保存到./data/.encryption_key。显式设置它意味着密钥完全由你保管——将来更换服务器时只要带上密钥和数据目录所有加密数据都能无缝恢复。镜像构建逻辑见项目根目录的 Dockerfile。 访问 TREK30 秒拿到管理员账号命令执行完毕后在浏览器打开http://localhost:3000你会看到登录页面。TREK 在首次启动时自动创建一个管理员账号先于任何注册行为默认邮箱admintrek.local、用户名admin初始密码为随机生成执行docker logs trek即可从容器日志中找回初始密码首次登录会强制要求修改密码如果启动时设置了ADMIN_EMAIL/ADMIN_PASSWORD环境变量则直接使用你预设的值登录后即解锁管理面板用户管理、插件开关、打包模板、备份策略、API 密钥配置全部集中在这一个入口。 5 分钟上手认识你的旅行规划系统部署完成后建议花 5 分钟体验这四个核心功能 仪表盘行程统计、待办事项和最近的动态一目了然是每次打开 TREK 的第一站。️ 行程规划器基于互动地图规划每一天的行程把目的地拖拽到时间轴上即可支持地图选点、路线优化和交通方式记录飞机、火车、自驾。 预算管理按类别记录开销支持多人分摊、多币种汇率换算和最终结算旅行账目从此不糊涂。 全球地图Atlas在世界地图上标记你去过和想去的地方旅行的足迹全部可视化管理。 部署完成后的 3 个健康检查# 1. 健康检查端点容器内置返回存活状态 curl -s http://localhost:3000/api/health # 2. 确认容器在运行 docker ps --filter nametrek # 3. 查看启动日志管理员初始密码也在这里 docker logs trek三项都正常你的旅行规划系统就完全就绪了。✅⚙️ 进阶建议从个人使用到生产环境版本更新直接拉取新镜像重建容器即可./data和./uploads两个目录是全部持久化状态只要不删除它们数据就不会丢失。更新方法详见wiki/Updating.md。生产部署docker run适合个人使用生产环境建议改用 Docker Compose 方式附带read_only、cap_drop、no-new-privileges等安全加固环境配置集中在.env文件中。项目自带 docker-compose.yml官方说明在wiki/Install-Docker-Compose.md。HTTPSPWA 安装和安全的会话 Cookie 依赖 HTTPS建议参考wiki/Reverse-Proxy.md将 TREK 放到反向代理之后。❓ 常见问题FAQQ3000 端口被占用了怎么办把映射改成-p 8080:3000之后访问http://localhost:8080即可。Q忘了加密密钥会丢数据吗密钥持久化在./data/.encryption_key备份数据目录时把它一并带上即可跨服务器迁移前请先确认密钥已备份。Q可以在 NAS 上部署吗可以。TREK 官方提供 Unraid 模板和 Proxmox 指南分别见wiki/Install-Unraid.md与wiki/Install-Proxmox.md同样是一条命令级别的操作。✅ 总结回顾一下本教程的核心路径安装 Docker → 一条命令启动 →docker logs trek取密码 → 浏览器登录。整个过程不到 5 分钟你就拥有了一个支持实时协作、互动地图和 PWA 离线的私有旅行规划系统。更多环境变量时区、CORS、邮件等配置可查阅wiki/Environment-Variables.md。祝旅途愉快从规划下一段行程开始【免费下载链接】TREKA self-hosted travel/trip planner with real-time collaboration, interactive maps, PWA support, SSO, budgets, packing lists, and more.项目地址: https://gitcode.com/GitHub_Trending/nomad22/TREK创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 TREK快速开始教程：一条Docker命令30秒部署你的旅行规划系统
TREK快速开始教程一条Docker命令30秒部署你的旅行规划系统【免费下载链接】TREKA self-hosted travel/trip planner with real-time collaboration, interactive maps, PWA support, SSO, budgets, packing lists, and more.项目地址: https://gitcode.com/GitHub_Trending/nomad22/TREKTREK 是一款功能强大的自托管旅行规划系统Travel Planner内置实时协作、互动地图、PWA 离线支持、SSO 单点登录、预算管理、打包清单等完整功能。本快速开始教程只需一条 Docker 命令30 秒拉取镜像并启动容器5 分钟内就能规划出你的第一段行程。 准备工作部署 TREK 前的 2 个前置条件开始之前请确认你的服务器满足以下两个条件条件说明Docker已安装并正在运行执行docker --version能正常返回版本号端口主机 3000 端口空闲也可映射到其他任意端口无需数据库、无需反向代理——TREK 使用 SQLite 作为存储全部装在一个容器里。 一条 Docker 命令30 秒启动 TREK复制下面这一条命令粘贴到终端执行即可ENCRYPTION_KEY$(openssl rand -hex 32) docker run -d \ --name trek \ -p 3000:3000 \ -e ENCRYPTION_KEY$ENCRYPTION_KEY \ -v ./data:/app/data \ -v ./uploads:/app/uploads \ --restart unless-stopped \ mauriceboe/trek:latest命令参数一目了然参数作用-d后台运行容器-p 3000:3000将容器端口映射到主机 3000 端口-e ENCRYPTION_KEY静态加密密钥用于加密 API 密钥、MFA 种子、OIDC 凭据等敏感数据-v ./data:/app/data持久化 SQLite 数据库、日志与密钥文件-v ./uploads:/app/uploads持久化你上传的照片和文档--restart unless-stopped服务器重启后自动拉起保证服务长期可用为什么建议手动生成加密密钥如果省略ENCRYPTION_KEYTREK 首次启动时会自动生成一个并保存到./data/.encryption_key。显式设置它意味着密钥完全由你保管——将来更换服务器时只要带上密钥和数据目录所有加密数据都能无缝恢复。镜像构建逻辑见项目根目录的 Dockerfile。 访问 TREK30 秒拿到管理员账号命令执行完毕后在浏览器打开http://localhost:3000你会看到登录页面。TREK 在首次启动时自动创建一个管理员账号先于任何注册行为默认邮箱admintrek.local、用户名admin初始密码为随机生成执行docker logs trek即可从容器日志中找回初始密码首次登录会强制要求修改密码如果启动时设置了ADMIN_EMAIL/ADMIN_PASSWORD环境变量则直接使用你预设的值登录后即解锁管理面板用户管理、插件开关、打包模板、备份策略、API 密钥配置全部集中在这一个入口。 5 分钟上手认识你的旅行规划系统部署完成后建议花 5 分钟体验这四个核心功能 仪表盘行程统计、待办事项和最近的动态一目了然是每次打开 TREK 的第一站。️ 行程规划器基于互动地图规划每一天的行程把目的地拖拽到时间轴上即可支持地图选点、路线优化和交通方式记录飞机、火车、自驾。 预算管理按类别记录开销支持多人分摊、多币种汇率换算和最终结算旅行账目从此不糊涂。 全球地图Atlas在世界地图上标记你去过和想去的地方旅行的足迹全部可视化管理。 部署完成后的 3 个健康检查# 1. 健康检查端点容器内置返回存活状态 curl -s http://localhost:3000/api/health # 2. 确认容器在运行 docker ps --filter nametrek # 3. 查看启动日志管理员初始密码也在这里 docker logs trek三项都正常你的旅行规划系统就完全就绪了。✅⚙️ 进阶建议从个人使用到生产环境版本更新直接拉取新镜像重建容器即可./data和./uploads两个目录是全部持久化状态只要不删除它们数据就不会丢失。更新方法详见wiki/Updating.md。生产部署docker run适合个人使用生产环境建议改用 Docker Compose 方式附带read_only、cap_drop、no-new-privileges等安全加固环境配置集中在.env文件中。项目自带 docker-compose.yml官方说明在wiki/Install-Docker-Compose.md。HTTPSPWA 安装和安全的会话 Cookie 依赖 HTTPS建议参考wiki/Reverse-Proxy.md将 TREK 放到反向代理之后。❓ 常见问题FAQQ3000 端口被占用了怎么办把映射改成-p 8080:3000之后访问http://localhost:8080即可。Q忘了加密密钥会丢数据吗密钥持久化在./data/.encryption_key备份数据目录时把它一并带上即可跨服务器迁移前请先确认密钥已备份。Q可以在 NAS 上部署吗可以。TREK 官方提供 Unraid 模板和 Proxmox 指南分别见wiki/Install-Unraid.md与wiki/Install-Proxmox.md同样是一条命令级别的操作。✅ 总结回顾一下本教程的核心路径安装 Docker → 一条命令启动 →docker logs trek取密码 → 浏览器登录。整个过程不到 5 分钟你就拥有了一个支持实时协作、互动地图和 PWA 离线的私有旅行规划系统。更多环境变量时区、CORS、邮件等配置可查阅wiki/Environment-Variables.md。祝旅途愉快从规划下一段行程开始【免费下载链接】TREKA self-hosted travel/trip planner with real-time collaboration, interactive maps, PWA support, SSO, budgets, packing lists, and more.项目地址: https://gitcode.com/GitHub_Trending/nomad22/TREK创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考