AdventureLog 自建旅行地图:NAS 上记足迹、排行程,手机上想看就看
作者
小编
发布时间

开源自托管旅行日志:互动地图点亮去过的地方、行程按天排、链接发给家人。Compose 部署、首次启动要点、PassNAT 穿透、常见问题。
项目介绍
AdventureLog 是一个开源的旅行日志与行程规划应用:去过的地方在地图上打点,可以记日期、写笔记、标分类;一次旅行做成一个「收藏」(Collection),把地点按天排进去,就是行程表。
它最大的特点是「一张自己的世界地图」——首页会统计你走过几个国家、几个地区、几个城市,地图上按已访问和计划中两种状态显示地点。行程可以设为公开,生成分享图或者直接把链接发给家人。
技术上是一个 Django + PostGIS 的后端,前端打包在同一个应用镜像里,所以现在只需要一个应用容器加一个数据库容器。
项目地址:点我跳转
部署安装
只要能跑 Docker 的 NAS 都能装,下面用飞牛 NAS 演示。两个容器,一份 Compose 编排就够了。
一、想在外面看,先把 3505 放出去
只在局域网里用,这一步可以跳过,直接看第二步。但如果你想把行程链接发给不在家的家人、或在外面用手机打开,就先在飞牛的「应用中心」里搜 PassNAT,装上这个穿透插件,打开它,点「创建隧道」:名字随便起(不超过 12 个字符),本地 IP 留默认的 127.0.0.1,本地端口填 3505,点开、按一下电源,状态变成运行中。详情里那个公网地址先记下来 —— 下一步要填进编排。
不是飞牛的系统,PassNAT 文档的「连接使用」里有其他系统的连接教程:点我跳转。
二、新建 Compose 项目
打开飞牛的「Docker」应用,切到「Compose」标签,点右上角的新增项目。项目名称填 adventurelog,路径在「我的文件」下面挑一个空文件夹,来源选「创建 docker-compose.yml」,把下面这段整个贴进去:
1services:2 app:3 image: ghcr.io/seanmorley15/adventurelog:latest4 container_name: adventurelog5 restart: unless-stopped6 environment:7 # 分享链接 / 公开页面用的地址,换成你外网访问的地址8 SITE_URL: http://nas.local:35059 POSTGRES_DB: database10 POSTGRES_USER: adventure11 POSTGRES_PASSWORD: change-me-please12 PGHOST: db13 ports:14 - "3505:80"15 volumes:16 - adventurelog_media:/code/media/17 depends_on:18 db:19 condition: service_healthy2021 db:22 image: postgis/postgis:16-3.523 container_name: adventurelog-db24 restart: unless-stopped25 environment:26 POSTGRES_DB: database27 POSTGRES_USER: adventure28 POSTGRES_PASSWORD: change-me-please29 volumes:30 - postgres_data:/var/lib/postgresql/data/31 healthcheck:32 test: ["CMD-SHELL", "pg_isready -U adventure -d database"]33 interval: 5s34 timeout: 5s35 retries: 53637volumes:38 postgres_data:39 adventurelog_media:
两处要改:SITE_URL 换成你实际打开这个应用的地址(如果做了第一步,就填隧道详情里的公网地址);POSTGRES_PASSWORD 换成你自己的口令,两个服务里要写成一样的。冒号前面那个 3505 是 NAS 上的端口,被占了就改它,后面的 80 不用动。
勾上「创建项目后立即启动」,点确认。数据库容器先起来,应用容器等它健康检查通过再启动。
三、第一次打开要等几分钟
浏览器打开 http://NAS的局域网地址:3505。第一次启动会比平时慢很多:应用要先建表,再把国家、地区、城市数据导入数据库,这一步在日志里显示为 download-countries,实测要五六分钟。这期间网页打不开是正常的,等日志里出现 gunicorn entered RUNNING 再刷新。
默认账号是 admin,密码也是 admin,登录后先到「个人资料」里把密码改掉。
进入后是首页,顶部一句「您已经探索了 N 个国家/地区」,下面是统计卡:访问过的国家、访问地点、收藏、访问过的地区、访问过的城市。
四、记下第一个地点
点左边的「地点」→「创建地点」。在「快速开始」里搜地名(比如 West Lake Hangzhou),从结果里点一个,点继续,进入「详细信息」:填名称、选类别(类别可以自己建,带个图标)、打个分、写点笔记;「访问次数」里加一段日期,保存。
也可以不用搜索:在下面的地图上点一下,坐标就填好了。地图底图是 OpenStreetMap,NAS 和外网通才出图。
地点建好后,首页的地图和统计卡会跟着变;「地点」列表里能看到每个地点的类别、评分和访问次数。
五、做一条行程,发给家人
点「收藏」→ 新建收藏,填名字、起止日期,把这次要去的地点按天加进去(就是行程表)。
收藏可以设为公开:打开收藏详情,点「对外分享」,可以下载方形、故事、景观三种尺寸的分享图,也可以复制链接。链接里的域名就是编排里填的 SITE_URL —— 所以想让家人在外网打开,SITE_URL 必须填公网地址。
家人打开链接不用登录就能看这条行程;想一起编辑,就在「用户」里邀请账号。
六、在外面用手机打开
手机浏览器直接打开隧道详情里的那个公网地址,用同一个账号登录:首页、地图、地点列表和电脑上一样,地图上的点可以放大看,行程按天排。走到一个新地方,当场加一条,回家打开电脑就是完整的记录。
几点说明
数据都在这两个卷里。 postgres_data 是数据库,adventurelog_media 是上传的图片。备份这两个卷就够了,升级镜像不会丢数据。
改 SITE_URL 要重建容器。 它是在启动时读进环境变量的,改完 compose 重新 up 一次才生效;改之前生成的分享链接还是旧地址。
地图要能上外网。 底图走 MapLibre + CARTO 的在线瓦片,NAS 完全没有外网时地图会是空白,但地点和统计照常记录。
端口冲突。 宿主 3505 被占了就改编排里冒号前面那个数字,记得隧道端口跟着改。
更新。 拉新镜像重建容器即可。数据库在卷里,重建不会清空;但大版本升级前还是先备份一下卷。
相关教程

在飞牛 NAS 上用 Docker 自建书签库 Linkding:一份编排贴进 Compose 就能跑,管理员账号在编排里直接建好;再用帕斯内网穿透把它开放到公网,换台电脑、人在外面也找得着自己收的网址。含编排逐行说明和建隧道每一栏怎么填。

wger是完全免费开源的健身营养管理平台,采用Django+PostgreSQL+Redis架构。提供自定义训练计划、营养追踪、体重管理、进度相册等功能。支持多用户管理,适合个人或健身房使用。所有功能完全免费,可自主部署掌控数据。Docker Compose一键部署,轻松在NAS或Linux服务器上运行。

约饭约球不用在群里一个个问哪天有空:在 NAS 上用 Docker Compose 部署开源约时间工具 Rallly,用帕斯内网穿透拿公网地址,朋友点开链接勾时间,人最齐的那天一眼看清。含 SMTP 邮箱配置和完整步骤。
