OneNav搭建个人导航站完整教程

安装准备与环境配置

服务器要求

• PHP版本：7.4 及以上（推荐 8.0+）
• 数据库：MySQL 5.7+ 或 MariaDB 10.2+
• Web服务器：Nginx 或 Apache
• 伪静态支持：必须开启

下载与部署

1. 访问 OneNav GitHub 仓库下载最新发行版
2. 将压缩包解压至网站根目录
3. 确保 runtime 目录具有写入权限（755 或 777）

Nginx 伪静态配置

location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last;
        break;
    }
}

Apache 用户直接在根目录放置 .htaccess 文件即可。

安装向导

数据库信息填写

管理员账号设置

• 邮箱：用于密码找回
• 用户名：建议避免使用 admin 等常见名称
• 密码：至少 8 位，包含大小写字母与数字

核心功能配置

基础设置

• 站点标题：显示在浏览器标签页
• 站点副标题：导航页头部描述文字
• 备案号：国内服务器需填写 ICP 备案号
• 统计代码：支持百度/Google Analytics

分类管理

1. 进入后台「分类管理」模块
2. 创建顶级分类（如：常用工具、设计资源、学习平台）
3. 设置排序权重（数字越小越靠前）
4. 添加二级分类（如「设计资源」下分「图标库」「配色工具」）

链接添加

格式示例：
- 标题：百度
- 链接：https://www.baidu.com
- 图标：https://www.baidu.com/favicon.ico（自动获取）
- 分类：搜索引擎
- 描述：中文搜索引擎
- 排序：1

支持批量导入，使用 JSON 格式：

[
    {"title":"示例站","url":"https://example.com","category":"测试分类"}
]

主题与样式调整

内置主题切换

• 默认主题：响应式设计，适合多数场景
• 暗黑主题：夜间使用更护眼
• 极简主题：去除多余元素，专注链接展示

自定义 CSS

在后台「主题设置」->「自定义 CSS」中添加：

/* 修改卡片背景色 */
.link-card {
    background: #f8f9fa;
    border-radius: 12px;
}
/* 调整导航栏透明度 */
.navbar {
    background: rgba(255,255,255,0.95) !important;
}

高级功能与优化

数据备份

• 手动备份：后台「系统工具」->「数据备份」
• 自动备份：配置 cron 定时任务，每日凌晨执行

  0 3 * * * cd /网站路径 && php think backup

性能优化

安全加固

1. 修改后台入口：重命名 admin.php 为复杂名称
2. 限制登录 IP：在 Nginx 配置中添加白名单
3. 禁用注册功能：后台「用户管理」关闭公开注册
4. 定期更新：关注 GitHub 仓库发布新版本

常见问题处理

安装失败排查

• 检查 PHP 扩展是否齐全（PDO、GD、CURL）
• 确认数据库连接信息无误
• 查看 runtime 目录下的日志文件

页面显示异常

• 清除浏览器缓存或强制刷新（Ctrl+F5）
• 检查伪静态规则是否生效
• 确认主题文件权限为 644

图标无法显示

• 手动上传图标至 /public/uploads/ 目录
• 在链接编辑页面直接填写图标 URL
• 使用 SVG 格式图标保证清晰度

通过以上步骤，你已成功搭建个人导航站。后续可根据使用习惯持续优化分类结构，添加常用链接，打造完全适配个人需求的高效导航工具。