很多爱好者都想搭建一个专属网址导航,聚合常用工具、博客、资源网站,告别杂乱的浏览器书签。 今天带来开源项目 wangwangit/nav 部署教程,这是一款轻量化、简约风格的个人导航页面,基于静态页面开发,占用资源极低,支持自定义分类、搜索框、暗黑模式,部署门槛很低。
项目优势:
✅ 纯静态为主,访问速度快,服务器压力小
✅ UI 清爽简洁,支持暗色 / 亮色主题切换
✅ 无冗余后台,配置简单,适合个人使用
✅ 支持自定义搜索引擎、导航分组
✅ 适配电脑端与手机移动端
视频教程:
☟性价比超高的云服务器支持试用☟
项目地址:https://github.com/jy02739244/iori-nav
免费域名:实测免费域名注册合集(持续更新..)
一、前置条件
⚠️ Cloudflare 免费额度足够个人自用:
Workers 每日 10 万请求;D1 5GB 存储空间;KV 免费读写额度,个人导航完全够用。
二、整体原理
整个导航站全部运行在 Cloudflare 边缘网络:
Workers:运行网站后端逻辑,提供网页访问接口
D1(SQLite 数据库):存储导航分类、网址、用户配置数据
KV 命名空间:缓存静态资源、站点基础配置
支持绑定自定义域名,自动 HTTPS、全球 CDN 加速,无需购买任何服务器
三、分步部署流程
步骤 1:注册并登录 Cloudflare
打开 cloudflare.com 注册免费账号。
步骤 2:Cloudflare 导航站环境变量与资源绑定配置清单
步骤 2:基础绑定(Pages 项目设置 → 绑定)
步骤 3:条件绑定(Pages 项目设置 → 绑定)
步骤 4:环境变量(Pages 项目设置 → 变量和机密)
DISPLAY_CATEGORY 已经废弃,当前版本不再读取此变量
| 变量名 | 默认值 | 说明 |
| ---- | ---- | ---- |
| ENABLE_PUBLIC_SUBMISSION | false | 是否允许访客投稿 |
| SITE_NAME | 灰色轨迹 | 首页站点名称(环境变量兜底) |
| SITE_DESCRIPTION | 一个优雅、快速、易于部署的书签(网址)收藏与分享平台,完全基于 Cloudflare 全家桶构建 | 首页副标题(环境变量兜底) |
| FOOTER_TEXT | 曾梦想仗剑走天涯 | 页面底部脚本文案 |
| ICON_API | https://faviconsnap.com/api/favicon?url= | 网站图标自动拉取接口 |
| AI_REQUEST_DELAY | 1500 | AI 一键补全描述请求间隔,单位:毫秒 |
| WORKERS_AI_MODEL | @cf/google/gemma-4-26b-a4b-it | Workers AI 默认模型;后台设置内选择的模型优先级更高 |
| TURNSTILE_SITE_KEY | 空 | Cloudflare Turnstile 人机验证站点密钥;需搭配 TURNSTILE_SECRET_KEY,开启后台登录、访客投稿防机器人验证 |
| TURNSTILE_SECRET_KEY | 空 | Cloudflare Turnstile 人机验证密钥;需搭配 TURNSTILE_SITE_KEY 同时启用 |
3) 配置优先级说明
首页名称/副标题等支持后台设置项的字段,优先读取数据库
settings,作为环境变量兜底。AI_REQUEST_DELAY在代码中的默认兜底为1500;本地可按API限频自行调整。Workers AI的模型可以在后台AI中手动填写;需要使用Workers AI的
@cf/...模型名。工人AI设置推荐:(
@cf/google/gemma-4-26b-a4b-it默认)、@cf/mistralai/mistral-small-3.1-24b-instruct、@cf/qwen/qwq-32b、@cf/qwen/qwen3-30b-a3b-fp8、@cf/meta/llama-3.1-8b-instruct-fp8。其余模型请自行测试。
💡提示:如使用免费的Gemini API Key(模型
gemini-2.5-flash-lite),频率限制为15次/分钟,请根据实际情况调整AI_REQUEST_DELAY。
🔐管理后台
后台管理页面地址为:
https://你的域名/admin
后台登录支架在NAV_AUTHKV中的admin_username与admin_password两个键内。登录/admin时需要在页面表单中输入账号与密码,系统会返回一个HttpOnly Cookie(默认1天,任选1/7/30/60/90天),消耗也不再支持在URL查询参数中的快捷键。点击后台右上角的“退出登录”按钮即可立即拓扑。
给后台登录与公开文档增加Cloudflare Turnstile人机验证,请在Cloudflare Turnstile控制台创建站点后,将站点密钥配置为TURNSTILE_SITE_KEY,机密密钥配置为TURNSTILE_SECRET_KEY。两个参数均为空时会保持原流程;仅配置其中一个会提示配置不完整。
评论区