自建私人书签管理库一处部署随处访问，OneNav Docker极简快速部署指南

项目介绍

OneNav 是一款自建的浏览器书签导航。它把散落在各个浏览器、各台设备上的网址集中到一个页面上，按分类排成卡片，打开就能看，一处部署、随处访问。

它跟「私人书签库」那一类不太一样：OneNav 的前台不用登录也能打开，更像一个给人看的导航页；不想给别人看到的那些链接，可以单独标成私有，访客那边就不显示了。两种用法各有各的场景。

程序本身是 PHP + SQLite，一个容器就跑得起来，镜像不到 20 MB，装在 NAS 上一点都不占地方。

部署安装

装在 NAS 上之后，想在外面也能打开，就得配一条内网穿透。这里用的是帕斯内网穿透，先注册一个账号备用。飞牛的应用中心里直接能搜到客户端，装完账号登一次就行。

下面这份编排可以直接用，跟视频里贴的是同一份：

1services:
2  onenav:
3    image: helloz/onenav
4    container_name: onenav
5    ports:
6      # 左边 3080 是 NAS 上开的口，右边 80 是它自己的
7      - 3080:80
8    volumes:
9      # 书签和账号都存在这个目录里，备份直接拷它
10      - ./data:/data/wwwroot/default/data
11    restart: unless-stopped

这份编排有三处值得单独说：

① 镜像那行写的是 helloz/onenav，不带版本号 —— 官方文档给的就是这个写法，你什么时候拉，拿到的就是当时的最新版，不用回头改这份编排。

② 端口那一行 3080:80。左边 3080 是 NAS 上开出来的口，可以随便换成没被占用的；右边 80 是 OneNav 自己的端口，别动。左边这个数字后面建隧道要填，记一下。

③ ./data:/data/wwwroot/default/data 是数据目录。书签、分类、账号，整个库都在这里面，备份的时候直接把这个目录拷走就行。它落在你上一步在文件管理里挑的那个文件夹下。

在飞牛里建 Compose 项目

打开飞牛桌面上的 Docker，切到上面的「Compose」标签，点「新增项目」。

项目名称填 onenav。路径点右边的图标挑一个空文件夹，没有的话在选择器左下角当场建一个。

「来源」选「创建 docker-compose.yml」，把上面那段贴进去，勾上「创建项目后立即启动」，点确认。镜像不大，十几秒就拉完起来了。

建隧道开放到公网

飞牛的应用中心里搜 PassNAT 就能装到客户端，装完账号登一次。

打开插件，进「隧道」，点创建隧道。名字自己起一个，接入节点和传输协议都留默认。

「本地IP」这一栏不用填 —— 留空默认就是 127.0.0.1，插件本来就跑在 NAS 上，回环地址天然指向本机。本地端口填 3080，也就是上面编排里冒号左边那个数。

建好之后在隧道列表里点开详情，按一下最左边的电源图标连接，端口列表里就能看到分配给你的公网地址，浏览器直接敲那个地址就打开了。

第一次打开：先把管理员建掉

OneNav 第一次打开是「初始化」页，不是登录页 —— 也就是说这时候谁先打开谁就是管理员。所以隧道一开，第一件事就是把这一步做完。

用户名 3 到 32 位的字母或数字，密码 6 到 16 位，邮箱填一个自己常用的，点「完成初始化」。之后就跳到登录页了，后台地址是在你那个公网地址后面接上 /index.php?c=login。

把自己的网址收进去

进后台之后，先在「分类管理 - 添加分类」里建一个分类。分类就是前台首页上一栏一栏的那个标题。

然后去「链接管理 - 添加链接」：填地址、填名字、挑刚建的那个分类，权重留 0（数字越大排得越靠前），点添加。回到前台首页，就多出来一张卡片了。

嫌一条条加太慢的话，「书签导入」那一页可以把浏览器导出的书签文件整个传进来。

不想给人看的，标成私有

前台是公开的，这也是它好用的地方 —— 发给家里人、发到别的设备上，打开就能用。

但总有几条不想让别人看见。在后台「我的链接」里选中那一条，点「设为私有」，前台没登录的人就看不到它了；你自己登录之后它才会重新出现。分类也能整个设成私有。

总结

到这儿，家里那些自建服务的网址就集中到一个页面上了，手机上打开也是一样的排版。看完把隧道在插件里关掉，下次要用再打开就行。

本篇教程到此结束。

自建私人书签管理库 一处部署随处访问，OneNav Docker极简快速部署指南