侧边栏壁纸
  • 累计撰写 106 篇文章
  • 累计创建 21 个标签
  • 累计收到 3 条评论

目 录CONTENT

文章目录

零服务器成本!Cloudflare 免费部署动态导航站保姆教程

很多爱好者都想搭建一个专属网址导航,聚合常用工具、博客、资源网站,告别杂乱的浏览器书签。 今天带来开源项目 wangwangit/nav 部署教程,这是一款轻量化、简约风格的个人导航页面,基于静态页面开发,占用资源极低,支持自定义分类、搜索框、暗黑模式,部署门槛很低。

项目优势:

✅ 纯静态为主,访问速度快,服务器压力小

✅ UI 清爽简洁,支持暗色 / 亮色主题切换

✅ 无冗余后台,配置简单,适合个人使用

✅ 支持自定义搜索引擎、导航分组

✅ 适配电脑端与手机移动端

视频教程:

☟性价比超高的云服务器支持试用

https://vip.aabhyun.com/

项目地址:https://github.com/jy02739244/iori-nav

免费域名:实测免费域名注册合集(持续更新..)

一、前置条件

依赖

版本

说明

Cloudflare 账号

免费注册,开通 Workers、D1 数据库、KV 命名空间权限

GitHub 账号

Fork 源码仓库,方便自动部署

⚠️ Cloudflare 免费额度足够个人自用:

Workers 每日 10 万请求;D1 5GB 存储空间;KV 免费读写额度,个人导航完全够用。

二、整体原理

整个导航站全部运行在 Cloudflare 边缘网络:

  1. Workers:运行网站后端逻辑,提供网页访问接口

  2. D1(SQLite 数据库):存储导航分类、网址、用户配置数据

  3. KV 命名空间:缓存静态资源、站点基础配置

  4. 支持绑定自定义域名,自动 HTTPS、全球 CDN 加速,无需购买任何服务器

三、分步部署流程

步骤 1:注册并登录 Cloudflare

打开 cloudflare.com 注册免费账号。

步骤 2:Cloudflare 导航站环境变量与资源绑定配置清单

步骤 2:基础绑定(Pages 项目设置 → 绑定)

绑定名

类型

说明

NAV_DB

D1

主数据库绑定(必需)

NAV_AUTH

KV

会话、限流、标识存储(必需)

步骤 3:条件绑定(Pages 项目设置 → 绑定)

绑定名

类型

说明

AI

Workers AI

使用 Cloudflare Workers AI 自动生成链接描述时必需

步骤 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_usernameadmin_password两个键内。登录/admin时需要在页面表单中输入账号与密码,系统会返回一个HttpOnly Cookie(默认1天,任选1/7/30/60/90天),消耗也不再支持在URL查询参数中的快捷键。点击后台右上角的“退出登录”按钮即可立即拓扑。

给后台登录与公开文档增加Cloudflare Turnstile人机验证,请在Cloudflare Turnstile控制台创建站点后,将站点密钥配置为TURNSTILE_SITE_KEY,机密密钥配置为TURNSTILE_SECRET_KEY。两个参数均为空时会保持原流程;仅配置其中一个会提示配置不完整。


0
🔥 今日已注册 171 🎁 新用户专享 · 首月 5 折
☁️ 云服务器 · 全区域覆盖 🇭🇰 香港 🇺🇸 美国 🇰🇷 韩国 🇨🇳 国内 12元/月起 ⚡ CN2 GIA 🌐 BGP 📡 CDIA 三网直连
💡 注册时输入优惠码 aabh,享首月 5 折 · 新购 8 折 · 续费 9.5 折 🔥 可叠加年付 7 折

评论区