📖 项目简介

🚀 快速开始

在线体验

📰 Github项目地址：

🚀 快速部署指南

第一步：准备 Cloudflare 账户与资源

1. 确保你拥有一个 Cloudflare 账户，并且已成功添加一个域名（或使用 Workers 默认分配的 .workers.dev 域名）。

2. 进入 Cloudflare 仪表板，在左侧菜单中找到 “Workers 和 Pages” 服务。

第二步：创建数据库 (D1)

1. 在 Workers 页面，切换到 “D1” 标签页。

2. 点击 “创建数据库”。
• 数据库名称：输入 book（或任何你喜欢的名称）。
• 点击 “创建”。

1. 数据库创建成功后，点击其名称进入详情页，切换到 “执行 SQL” 标签页。

2. 我们需要创建两张表。请分别执行以下两段 SQL 语句：
创建 sites 表（用于存储已通过审核的书签）：



创建 pending_sites 表（用于存储用户提交待审核的书签）：

第三步：创建 KV 命名空间 (用于存储管理员密码)

1. 切换到 “KV” 标签页。

2. 点击 “创建命名空间”。
• 命名空间名称：输入 NAV_AUTH。
• 点击 “创建”。

1. 创建成功后，点击 “查看” 进入该 KV 空间。

2. 点击 “添加条目”，我们需要创建两个键值对：
• 第一条：
• 键：admin_username
• 值：admin (或你自定义的管理员用户名)
• 第二条：
• 键：admin_password
• 值：你的管理员密码 (请务必设置一个强密码)

第四步：创建并配置 Worker

1. 切换回 “Workers” 标签页。

2. 点击 “创建 Worker”。

3. 在创建页面，为你的 Worker 取一个名称（例如 my-nav-site），然后点击 “部署”。系统会生成一个基础的 Worker 代码。

4. 部署成功后，点击 “编辑代码”，进入在线代码编辑器。

5. 清空编辑器内所有默认代码，将本项目中的 worker.js 文件内容完整复制粘贴进来。

6. 点击右上角的 “保存并部署”。

第五步：绑定资源到 Worker

1. 在 Worker 的详情页，切换到 “设置” 标签页。

2. 找到 “绑定” 部分，点击 “添加绑定”。
1. 绑定 D1 数据库：
• 选择 “D1 数据库”。
• 变量名称：输入 DB (必须与代码中的变量名一致)。
• D1 数据库：选择你之前创建的 book 数据库。
• 点击 “添加绑定”。
2. 绑定 KV 命名空间：
• 选择 “KV 命名空间”。
• 变量名称：输入 AUTH_STORE (必须与代码中的变量名一致)。
• KV 命名空间：选择你之前创建的 NAV_AUTH。
• 点击 “添加绑定”。

3. 所有绑定添加完成后，建议再次点击 “保存并部署” 以确保配置生效。

第六步：访问与初始化内容

1. 访问首页：
• 在 Worker 详情页的顶部，你可以看到你的 Worker 访问地址（格式如 https://my-nav-site.你的用户名.workers.dev）。
• 首次访问首页，你可能会看到 “暂无数据” 的提示，这是正常的。

2. 登录后台：
• 在浏览器地址栏，在你的 Worker 访问地址后加上 /admin（例如：https://my-nav-site.你的用户名.workers.dev/admin）。
• 使用你在 第三步 中设置于 KV 的 admin_username 和 admin_password 进行登录。

3. 添加第一个书签：
• 登录成功后，在后台管理页面，点击 “添加网站”。
• 填写网站的名称、URL、描述、分类等信息，然后提交。
• 注意：提交后，这个书签会直接进入 sites 表（已通过状态）。

4. 查看效果：
• 回到你的网站首页并刷新，现在你应该能看到刚刚添加的书签了！

🔄 从旧版本升级

1. 进入你的 book 数据库控制台。

2. 在 “执行 SQL” 标签页，运行以下命令：

3. 执行成功后，用最新的 worker.js 代码重新部署你的 Worker 即可。

✨ 使用提示

• 用户提交：访客可以通过首页的 “提交网站” 功能申请添加书签。这些申请会进入 pending_sites 表，你需要在 /admin 后台进行审核。

• 获取网站图标：你可以使用在线工具（如 https://toolb.cn/favicon）获取目标网站的 favicon 链接，并填入 “Logo” 字段。

• 自定义样式：如需修改网站主题色等样式，可以编辑 worker.js 文件中 tailwind.config 部分的配置。