小众但超好用的：OneNav 书签导航系统（附完整安装教程）

## 前言

站长们平时收藏的网址越来越多，浏览器书签同步又总是不尽如人意。今天给大家推荐一款**小众但极具实用价值**的开源 PHP 项目 —— **OneNav**，一个使用 PHP + SQLite3 开发的书签/导航管理系统，帮你把散落各处的网址统一管起来，部署简单，界面漂亮，拿来就用。

## 项目简介

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

– **GitHub**：https://github.com/helloxz/onenav
– **开源协议**：Apache-2.0
– **Star 数**：约 3.1k（小众，但社区活跃）
– **最新版本**：v1.2.4（2026年5月）
– **演示地址**：http://demo.onenav.top（账号 `xiaoz` / 密码 `xiaoz.me`）

—

功能亮点

OneNav 的功能之丰富，远超同类小项目，以下是核心亮点：

### 🔖 书签管理
– 支持从 **Chrome / Firefox / Edge** 批量导入书签
– 链接信息**自动识别**（标题、图标等）
– 支持**二级分类**，层级管理更清晰
– **链接拖拽排序**，在 default2 主题中自由拖动
– **右键菜单**：打开/复制链接、显示二维码、编辑/删除，一气呵成

🎨 界面与体验
– 多种主题风格（default2 等），支持 PWA 应用
– **前台直接编辑**：弹窗完成添加、编辑、删除，无需进后台
– 手机版后台，移动端完美适配
– **底部工具栏**（管理员登录后显示）：添加链接、返回顶部、订阅管理、系统状态、后台管理

### 🤖 AI 与智能
– **AI 检索**：告诉 AI 关键词或描述，智能匹配相关链接
– **链接批量检测**：自动检测死链，快速找出失效链接
– **私有链接**：支持链接隐私控制

### ⚙️ 技术与部署
– 支持 **Docker 一键部署**，也支持传统 PHP 环境
– 后台**一键在线升级**，无需手动操作
– 提供 **API 接口**，支持外部调用
– 配套**浏览器扩展插件**，收藏体验丝滑

## 安装教程

下面提供两种安装方式，**推荐 Docker 方式**，适合不想折腾环境的朋友；传统 PHP 方式适合已经有 PHP 环境的服务器。

—

### 方式一：Docker 部署（推荐）

#### 步骤 1：安装 Docker

如果你的服务器还没有 Docker，先装一下：

“`bash
# CentOS / Rocky / AlmaLinux
yum install -y docker
systemctl enable docker
systemctl start docker

# Ubuntu / Debian
apt update
apt install -y docker.io
systemctl enable docker
systemctl start docker
“`

#### 步骤 2：运行 OneNav 容器

“`bash
docker run -itd –name=”onenav” -p 3080:80 \
-v /data/onenav:/data/wwwroot/default/data \
–restart always \
helloz/onenav
“`

**参数说明：**

| 参数 | 说明 |
|——|——|
| `-p 3080:80` | 将容器 80 端口映射到宿主机 3080 端口，可自行修改 |
| `-v /data/onenav:…` | 数据持久化挂载，换容器数据不丢 |
| `–restart always` | 开机自启 |

#### 步骤 3：访问安装

浏览器打开 `http://你的服务器IP:3080`，根据提示初始化管理员账号和密码，完成安装。

后台访问地址：`http://IP:3080/index.php?c=login`

> **📸【截图 3】Docker 容器运行状态**
> *截图要点：终端执行 `docker ps` 命令的输出结果，显示 onenav 容器正在运行，包含 STATUS 为 Up、端口映射信息。*

### 方式二：传统 PHP 环境部署

适合已经有 LNMP/LAMP 环境的服务器。

#### 环境要求

| 组件 | 要求 |
|——|——|
| PHP | 7.2 及以上（推荐 7.4+） |
| 数据库 | SQLite3（PHP 需开启 pdo_sqlite 扩展） |
| Web 服务器 | Nginx / Apache 均可 |
| 其他 | 支持 URL Rewrite（伪静态） |

#### 步骤 1：下载源码

“`bash
cd /var/www/html # 换成你的站点目录
git clone https://github.com/helloxz/onenav.git .
# 或者手动下载 zip 包解压
“`

#### 步骤 2：配置 Web 服务器

**Nginx 配置示例：**

“`nginx
server {
listen 80;
server_name your-domain.com;
root /var/www/html;
index index.php index.html;

location / {
try_files $uri $uri/ /index.php?$args;
}

location ~ \.php$ {
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_index index.php;
include fastcgi.conf;
}
}
“`

#### 步骤 3：访问安装

浏览器打开你的域名，根据页面提示完成初始化（设置管理员账号密码）。

后台地址：`http://your-domain.com/index.php?c=login`

## 使用体验

装好之后，第一感觉是**轻**。整个程序才几 MB，SQLite 数据库文件也在 `data/` 目录下，备份只需要 copy 一个文件。

后台功能完整但不臃肿，添加链接时有自动识别功能，粘贴一个 URL 就能把标题、图标都拉过来，非常省事。

前台展示风格走的是**极简卡片风**，默认主题 default2 支持拖拽排序，手机端也能正常操作，作为「个人起始页」或者「内部工具导航」都非常合适。*

—

## 同类项目对比

| 项目 | 技术栈 | Star | 特点 |
|——|——–|——|——|
| **OneNav** | PHP+SQLite | 3.1k | 功能全、轻量、支持 Docker |
| dwz-shorturl | PHP+MySQL | 极低（小众） | 超轻量短链服务，适合自建 |
| PESCMS-Ticket | PHP+MySQL | 157 | 开源工单系统，功能完整 |
| Lychee | PHP+MySQL | ~3k | 自托管相册，界面精美 |

—

## 总结

OneNav 是一个**小而美**的开源项目，没有过度设计，没有复杂依赖，PHP + SQLite 一把梭，10 分钟就能跑起来。对于想要一个**自己的网址导航/书签管理**的站长或开发者来说，是一个非常值得尝试的选择。

**GitHub 地址**：https://github.com/helloxz/onenav
**官方文档**：https://dwz.ovh/onenav

—