laoyang
6e83cc3ecc
- 前台：搜索引擎切换+联想下拉、网格板块（常用/工具）、合集标签页 - 后台：初始化/登录、网站/板块/引擎增删改、上下移排序 - 添加网站自动抓取名称与图标（存储于服务器），支持自定义简称 - 一键全部更新（批量刷新图标+名称，保留自定义简称） - 搜索联想服务端代理（必应/百度/谷歌/搜狗/360/DuckDuckGo） - 零依赖：原生 CSS/JS，PDO SQLite
69 lines
3.5 KiB
Markdown
69 lines
3.5 KiB
Markdown
# 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
|