x

xiaoz博客
lisa主机lisa主机

一篇文章带你快速了解开源免费的书签（导航）管理程序OneNav

发布于：2022-03-09 更新于：2026-06-02 分享发现 88条评论

OneNav是一款开源免费的书签（导航）管理程序，由xiaoz使用使用PHP + SQLite 3开发，界面简洁，安装简单，使用方便。OneNav可帮助你你将浏览器书签集中式管理，解决跨设备、跨平台、跨浏览器之间同步和访问困难问题，做到一处部署，随处访问。

功能特点

  • 支持后台管理
  • 支持私有链接
  • 支持Chrome/Firefox/Edge书签批量导入
  • 支持多种主题风格
  • 支持链接信息自动识别
  • 支持API
  • 支持Docker部署
  • 支持uTools插件
  • 支持Chrome扩展

安装

环境要求：

  • 5.6 <= PHP <= 7.4
  • PHP需支持pdo_sqlite组件（绝大部分环境默认支持）

下载源码：

安装：

  1. 将源码上传到你站点根目录并解压
  2. 访问您的站点首页，等待5s自动完成安装
  3. 务必参考安装帮助文档做进一步安全设置：https://doc.xiaoz.org/books/onenav/page/a1d0c

Docker方式安装：

docker run -itd --name="onenav" -p 80:80 \
    -v /data/onenav:/data/wwwroot/default/data \
    helloz/onenav
  • 80：第1个80端口为访问端口，可自行修改，第2个80为容器内部端口，请不要修改
  • /data/onenav：本机挂载目录，用于持久存储Onenav数据

使用

这篇文章对OneNav部分功能介绍，OneNav正在积极更新中，后期可能会随着版本迭代，功能上会有所变化，有兴趣的同学可安装后进一步体验。

进入OneNav后台 - 链接管理 - 书签导入，可将浏览器导出的.html书签批量导入到OneNav中，目前支持Chrome、Firefox、Edge浏览器书签导入。

在分类管理 - 添加分类 - 支持设置Font Awesome 4图标，试试将字体图标设置为fa fa-book，然后访问前台看看效果。（更多字体图标可前往：https://fontawesome.dashgame.com/ 选择）。哦对了，如果您将分类或者链接设为私有，未登录用户无法看到也无法访问。

如果您使用的默认主题，并以管理员身份登录后，右下角会出现“+”按钮，点击可快速添加链接。

鼠标移动到某个链接上面，并单击鼠标右键，即可弹出右键菜单，可快速编辑、删除、显示二维码，复制原始链接等操作。

如果你不喜欢默认主题，没关系，网友@baisu 还为OneNav制作了baisuTwo主题（仅0.9.16版本及以后支持），目前已经集成到OneNav项目中，你只需要修改data/config.php，将：

define('TEMPLATE','default');

修改为：

define('TEMPLATE','baisuTwo');

然后访问前台看看效果：

默认主题和baisuTwo主题均使用响应式布局，PC、平板、手机访问都能轻松完美展示。

默认主题和baisuTwo主题还支持书签搜索，方便你快速直达。

如果你是uTools用户，还可以在uTools插件市场搜索“OneNav”安装插件，方便你在uTools中使用，从而进一步提高效率。

最后

一篇文章不足以介绍OneNav完整功能，更多细节大家可以自行部署体验。OneNav项目已经持续2年多，目前处于积极开发中，如果使用中有任何问题，也可以在我的下问社区进行反馈，感谢大家的支持。

OneNav 书签管理 导航源码 开源书签

上一篇

一款开源的Hitomi-Downloader视频下载工具，几乎支持所有主流视频网站

下一篇

QiReader一款基于 Web 的全平台 RSS 阅读器，支持全文输出

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注

已有 88 条评论

  1. Jackl

    https://favicon.rss.ink 证书失效了，OneNav 的图标都不显示了，显示不是安全链接，麻烦修复下

    回复
    1. xiaoz Jackl

      未能复现，你看看恢复了吗？

      回复
  2. rkey

    我想问我使用的docker部署，我如果换了一台机器重新部署，如何数据迁移？

    回复
    1. xiaoz rkey

      直接备份你的docker挂载目录，然后打包迁移挂载目录到新的机器并解压，新的机器重建一个docker容器，指向到迁移后的挂载目录即可。

      回复
  4. jack

    自动获取图标的服务（favicon.rss.ink）挂了，导致导航主题网站图标全部加载不出来

    回复
    1. jack jack

      打开图标链接（https://favicon.rss.ink/v1/……）显示“此网站无法提供安全连接”

      回复
    2. xiaoz jack

      CDN部分节点异常，应该已经恢复了吧，你再试试呢？

      回复
  5. 666

    有没有考虑使用mysql。

    回复
    1. xiaoz 666

      后续的版本可能会考虑，感谢支持。

      回复
  6. fooz

    貌似默认icon链接坏了

    回复
  9. 静态化页面

    大佬你好，想问一下静态化怎么生成，没有自己的服务器，想用本程序管理一下自己的收藏夹，然后静态化使用，但是一直没找到如何生成静态化页面。

    回复
    1. xiaoz 静态化页面

      这个需要依赖PHP环境，静态化的不好管理（比如增、删、改、查），不支持静态环境运行。

      回复
  10. 奥特曼

    首次进去 没提示安装什么 登录密码是什么？？？？

    回复
    1. xiaoz 奥特曼

      首次安装应该有个初始化界面，你是通过什么方式安装的？Docker吗？

      回复
      1. 奥特曼 xiaoz

        虚拟服务器，后来放到主目录 可以运行了
        能不能不放主目录？怎么修改 求赐教

        回复
  11. kws

    用docker ，然后做了以下目录映射，在docker/onenav映射data/wwwroot/default/data ，要想换模板的话，我在docker/onenav下再建个templates目录放入主题，在后台应用后样式什么的都没有，是什么原因？

    回复
    1. xiaoz kws

      你自己建的主题没样式吗？看下主题引入的CSS文件路径。

      回复
      1. kws xiaoz

        是下载上传的baisuTw 模板

        回复
      2. kws xiaoz

        是自己下载上穿的 baisuTw

        回复
  12. 地方领导

    密码忘记了，怎么找回呢，亲

    回复
    1. xiaoz 地方领导

      可以参考这个帮助文档：https://doc.xiaoz.me/books/onenav/page/35f4a

      回复
  13. 嘟嘟宝宝

    我用群晖docker部署的，80端口只能http访问，添加443端口也不能用https访问，要怎么设置呢？？？

    回复
    1. xiaoz 嘟嘟宝宝

      需要在容器里面修改nginx配置才可以，不过不建议用这个方法，可以反代你的OneNav实现https访问。

      回复
  14. 小二

    不支持书签分类的子分类，这个希望可以支持下，谢谢

    回复
    1. xiaoz 小二

      二级分类前几个版本就支持了啊，你现在用的是最新版本吗？

      回复
      1. 小二 xiaoz

        后台支持二级目录,我的意思是说,比如在chome导出的书签里面有二级目录,但是导入进去,二级目录就变成了一级的了,谢谢

        回复
  15. macyoyo

    不能从v0.9.11直接升级到v0.9.21版本么？

    回复
    1. xiaoz macyoyo

      先升级到0.9.16，然后再升级到最新的0.9.21，0.9.16是个重要的过段版本，不能跳过，其它版本可以直接跳到最后。

      回复
  16. 奥特曼必胜

    老哥，这个怎么迁移数据，有没有教程啊？

    回复
    1. xiaoz 奥特曼必胜

      直接打包整个站点就行了。

      回复
  17. aleixcox

    希望可以增加“导出”功能

    回复
    1. xiaoz aleixcox

      0.9.21已经可以在后台导出，如下图。

      回复
  18. harris

    大佬，获取的icon图标有办法让他清晰点吗，比如我想设置图片为32×32的，有些失真

    回复
    1. xiaoz harris

      不能哦，这个默认只有16px，如果你觉得不清晰的话，默认主题可以设置为字体图标，而不用在线图标，参考：主题设置说明，将favicon修改为offline

      回复
      1. Bany xiaoz

        同觉得图标模糊，挺多网站都有大尺寸图标的，可不可以在添加网站时，自动获取源站大尺寸图标，或者加一个“自定义图标”设置，我们可以自己找图标添加（链接或者上传图片）。

        回复
        1. xiaoz Bany

          1. 为了提高便捷性，不会考虑自定义链接图标，每个链接都去自定义图标太累了，实用性不强
          2. 在很早的版本中就已经支持无损放大的文字图标了，这个功能不知道你用过没有，您可以将OneNav更新到啊0.9.23然后使用5iux这个主题试试

          这是字体图标的效果：

          回复
          1. Bany xiaoz

            感谢回复，已经在用最新版啦，字体图标区分度不强，还是喜欢站点本身图标。因为看代码咱现在是根据 base64 统一获取图标，这样对搭建者来说确实省事方便，可也有两个问题：1. 默认匹配的 16×16 图标，缩放会比较模糊，可否考虑采用 32×32 尺寸的？2. 有些站点带有图标，但是自动获取不到，比如 https://yixi.tv/、https://sspai.com/ 等，也无法自己添加或修改，就比较尴尬。可否默认还是自动获取，但提供一个能够自己添加图标链接的选项呢，在呈现时判断下，有管理员添加的图标就优先呈现，无就自动获取。码了这么多，再次感谢 [抱拳]！

  19. harris

    浏览器导入的标签，自带的windows分类后台删不了…

    回复
    1. xiaoz harris

      如果某个分类下存在书签是不允许删除的，正确的做法是通过链接列表，批量将windows分类下的链接转移到其它分类或者批量删除此分类下的链接。

      回复
      1. harris xiaoz

        这个想自己编辑样式怎么弄，目前的样式是动态的还怎么的，

        回复
          1. harris xiaoz

            有些样式写在页面相应代码的stylel里，这咋改，能改首页模版代码吗

          2. xiaoz harris

            如果无法满足需要的话直接去修改模板就行了，在templates目录下。

          3. harris xiaoz

            找到首页模版了

          4. harris xiaoz

            有个问题，这个数据库在哪儿，能保存到本地吗

          5. xiaoz harris

            在/data/onenav.db3，你可以自行下载保存到本地，用的SQLite3数据库。

          6. harris xiaoz

            了解，谢谢解答

    2. 老樵 harris

      你好，贵站的onenav主题能分享一下吗？

      回复
      1. xiaoz 老樵

        确实还挺好看的，简洁舒适。

        回复
        1. 老樵 xiaoz

          是的，传统的导航页都一样的 看腻了

          回复
  20. harris

    这个版本很轻便啊，如若能开放用户注册就更好了

    回复
    1. xiaoz harris

      目标定位是个人书签，而且书签数据比较敏感，有些用户可能不愿意注册并将书签交出去。所以可能不会考虑用户功能。不过有个朋友开发的Extend版本是可以支持多用户的,参考：https://doc.xiaoz.me/books/onenav-extend

      回复
      1. harris xiaoz

        thanks,我研究一下

        回复
      2. harris xiaoz

        还有就是，输入网址能不能识别网站tittle呢，手动输入有点麻烦

        回复
        1. xiaoz harris

          后台添加链接的时候底部有个识别按钮，可以识别部分网站的标题和描述，但不确保所有网站都能识别。

          回复
  21. ATzzz

    docker 版本 拉取的 docker pull helloz/onenav:latest 这个不是最新版本吗？
    进后台显示是 当前版本：v0.9.12-20210726

    回复
    1. ATzzz ATzzz

      进入容器查看 version.txt 也是显示 的 v0.9.12-20210726

      回复
    2. xiaoz ATzzz

      你用了国内的docker加速镜像？如果用了国内镜像可能导致镜像更新不及时，建议加上具体版本试一下，比如：docker pull helloz/onenav:0.9.20

      回复
  22. 黑色铅笔

    OneNav Extend 升级到最新版，是直接下载最新的源码覆盖之前的吗？

    回复
    1. xiaoz 黑色铅笔

      您可以参考下Extend版本的帮助文档：帮助文档 看是否有用。

      回复
      1. 黑色铅笔 xiaoz

        收到，谢谢

        回复
  23. klsdfjo

    群辉docker版本如何看到templates目录哦？

    回复
    1. xiaoz klsdfjo

      可以进入终端看到，在/data/wwwroot/default/templates目录下面。你是想更换主题吗？docker更换主题可以参考：OneNav更换主题

      回复
  24. biglee

    点击链接之后为什么会有个链接信息页面，为什么不直接跳转到目标网站，效率很低啊

    回复
    1. xiaoz biglee

      下个版本可以通过后台关闭这个过渡页面。

      回复
  26. 黑色铅笔

    想请问下链接跳转页面是在哪个文件修改呢，谢谢~

    回复
    1. xiaoz 黑色铅笔

      在templates/admin/click.php

      回复
      1. 黑色铅笔 xiaoz

        谢谢

        回复
        1. xiaoz 黑色铅笔

          不必客气。

          回复
  27. 柒景影

    楼主加油，很好的项目。

    回复
    1. xiaoz 柒景影

      谢谢支持。

      回复
  28. kqysw

    增加一个浏览器插件 方便通过浏览器 保存收藏链接 形成一个云端收藏夹

    回复
    1. xiaoz kqysw

      前期先把基础功能完善后会考虑推出浏览器插件。

      回复
  29. 天天忽悠

    真棒,看完我立刻就去更新了
    不过baisuTwo是砍了暗色模式???
    我自己还是习惯用暗色

    回复
    1. xiaoz 天天忽悠

      好像baisuTwo确实没有暗色模式，可以在群里（147687134）给baisu反馈下。

      回复
  30. Kem

    本来以为是炒冷饭，没想到baisu居然更新了，一会儿去试试看。期待onenav的后台管理功能更新XD

    回复
    1. xiaoz Kem

      最近几个小版本后台没有什么太大的功能更新，新主题baisuTwo已经整合到0.9.16了。

      回复