laoyang b4b81ec45e chore: 把 deploy/ 与 data/ 移出版本库
- .gitignore 改为整目录忽略 /data/ 与 /deploy/(原先用 /data/* + 白名单,
  反而把 data/.htaccess、data/index.html 放进仓库)
- git rm --cached 移除 data/.htaccess、data/index.html、
  deploy/setup-simplenav-user.sh、deploy/nginx-simplenav-deny-data.conf
- 部署脚本移到 ~/code/_tooling/simplenav-deploy/,不再属于应用源码
- /data/ 的保护由站点根 .htaccess(RewriteRule ^data/ - [F,L])负责;
  nav.db 从未被提交,无凭据泄露
2026-09-28 16:18:09 +08:00
2026-09-28 07:22:08 +00:00

SimpleNav · 简航

简航(SimpleNav),一个面向个人的轻量级网站导航系统。PHP + SQLite,零外部依赖、无需 Composer,上传即用。

特点

  • 轻量:纯 PHP + SQLite,不依赖 MySQL / 框架 / Composer;前端无 Bootstrap / jQuery,原生 CSS + JS。
  • 个人向:单管理员,页面就是「你自己常用网站的起始页」。
  • 搜索引擎可切换 + 联想下拉:后台勾选喜欢的搜索引擎即可显示在顶部;输入时下拉联想词由服务端代理(规避跨域)。
  • 添加即补全:填网址自动抓取网站名称、图标(图标下载并规范化后存到服务器本地)。
  • 显示简称:每个网站有「名称(自动)」和「简称(手动)」两个字段,页面展示你自定义的简称。
  • 自定义排序:网站 / 板块 / 搜索引擎都可上移下移排序。
  • 一键全部更新:批量刷新所有网站的图标与名称,不会改动你自定义的简称。
  • 合集标签页:把「合集」做成标签页,点标签平铺该合集下的全部链接。

页面结构(复刻 n.yangyq.net 风格)

  1. 顶部:搜索引擎切换 + 搜索框(带联想下拉)
  2. 中部:网格板块(如「常用」「工具」)
  3. 下部:「合集」标签页

目录结构

SimpleNav/
├─ index.php              前台首页
├─ suggest.php            搜索联想代理(多引擎,服务端请求)
├─ login.php / logout.php 管理员登录 / 首次初始化
├─ db.php                 数据库初始化(建表 + 默认数据)
├─ config.php             基础配置
├─ functions.php          公共函数(抓取元信息、下载图标等)
├─ admin/                 后台(网站 / 板块 / 搜索引擎 / 设置)
│   ├─ index.php          后台页面
│   ├─ actions.php        增删改 / 排序处理
│   ├─ fetch_meta.php     添加网站时自动抓取名称与图标
│   └─ update_all.php     一键“全部更新”(分批)
├─ assets/                CSS / JS / 图标
├─ uploads/icons/         抓取到的网站图标(需可写)
└─ data/                  SQLite 数据库(需可写,禁止 Web 访问)

部署

  1. 上传全部文件到站点目录(如 /www/wwwroot/n.yangyq.net/simplenav)。
  2. 确保 web 用户对 data/ 与 uploads/icons/ 有写权限。
  3. 浏览器打开站点 → 首次访问进入「初始化管理员」,创建账号后即可在后台管理。
  4. 建议在 nginx server{} 中加入 deploy/nginx-simplenav-deny-data.conf 里的规则(禁止访问 data/)。

服务器上创建最小权限部署账号:以 root 运行 deploy/setup-simplenav-user.sh。

搜索引擎联想接口说明

联想接口需服务端代理(浏览器直接调用会跨域)。内置解析类型:

类型 平台 联想接口
bing_osjson 必应 https://api.bing.com/osjson.aspx?query={q}
baidu_sugrec 百度 https://www.baidu.com/sugrec?prod=pc&wd={q}
google_firefox 谷歌 https://suggestqueries.google.com/complete/search?client=firefox&q={q}
sogou_ajaj 搜狗 https://www.sogou.com/suggnew/ajajjson?type=web&key={q}
so360 360 https://sug.so.360.cn/suggest?encodein=utf-8&encodeout=utf-8&format=json&word={q}
ddg DuckDuckGo https://duckduckgo.com/ac/?type=list&q={q}

注:国内服务器访问 Google / DuckDuckGo 可能不通,联想会优雅降级为空(不影响搜索跳转)。

许可

Apache License 2.0

S
Description
简航,一个面向个人的轻量级导航系统
Readme Apache-2.0
637 KiB
Languages
PHP 75.9%
JavaScript 15.5%
CSS 8.6%