最近看到一个挺不错的开源导航项目 CF-Navs。
它运行在 Cloudflare Workers 上,书签和设置等数据使用 Cloudflare D1、KV 保存,最大的优点就是:
不用购买 VPS,也不用自己维护服务器。
比较适合拿来做个人导航页、浏览器首页或者收藏一些常用网站。
项目地址:
https://github.com/lbjxr/CF-Navs
目前支持分类管理、搜索、私密书签、私密分类、多套主题、浏览器书签导入、手机适配等功能。
这篇主要记录一下最简单的 Cloudflare 部署方法。
1. Fork 项目
打开项目地址:
https://github.com/lbjxr/CF-Navs
点击右上角的:
Fork
把项目 Fork 到自己的 GitHub 账号。
2. 导入 Cloudflare Workers
进入 Cloudflare:
Workers & Pages
选择连接 GitHub,授权自己的 GitHub 账号。
然后选择刚才 Fork 的:
CF-Navs
项目。
3. 设置构建参数
生产分支:
main
构建命令:
npm run build
部署命令:
npx wrangler deploy
其他基本保持默认即可,然后开始第一次部署。
正常情况下,项目需要的 D1 数据库和 KV 会自动创建并绑定,不需要提前手动创建。
如果部署时报 missing binding 等错误,再检查 D1 和 KV 绑定即可。
4. 添加 SETUP_TOKEN
第一次部署完成以后,进入:
Worker → 设置 → 变量和密钥
添加:
SETUP_TOKEN
类型选择:
Secret / 密钥
值可以自己生成一段足够长的随机字符串,例如:
8fHd92ksLx72Pq9xxxxxxxxxxxxxxxx
记得保存好,等下初始化网站需要使用。
添加完成后,重新部署一次 Worker,让这个变量生效。
5. 初始化网站
部署成功后会获得一个:
xxxx.workers.dev
地址。
在后面加入:
/install
例如:
https://xxxx.workers.dev/install
打开以后输入刚才设置的:
SETUP_TOKEN
然后创建自己的:
- 管理员用户名
- 管理员密码
完成以后基本就部署好了。
6. 添加自定义域名
这一步不是必须的。
如果自己有域名,可以进入 Worker 的:
域和路由
添加一个自定义域名,比如:
nav.example.com
以后直接使用自己的域名访问导航页即可。
如果没有域名,直接使用 Cloudflare 提供的 workers.dev 地址也可以。
7. 删除或更换 SETUP_TOKEN
确认已经可以正常登录后台以后,建议删除或者重新生成:
SETUP_TOKEN
因为这个 Token 主要就是首次安装时使用。
简单体验
进入后台以后,就可以开始添加自己的:
- 网站
- 分类
- 子分类
- 图标
- 描述
也可以直接导入浏览器原来的书签,不需要全部重新添加。
CF-Navs 还支持一个我比较喜欢的功能:
私密书签和私密分类。
一些后台地址、管理页面或者不想公开的网站,可以设置成仅管理员登录以后才能看到。
所以既可以自己使用,也可以把部分公开导航分享给别人。
另外还有多套主题、搜索、访问统计以及 Chrome / Edge 浏览器书签同步等功能,大家可以自己慢慢折腾。
总结
CF-Navs 最大的优势就是:
不需要 VPS,直接利用 Cloudflare 就能搭一个属于自己的导航页。
整个部署过程也不复杂:
Fork GitHub ↓ 连接 Cloudflare ↓ 部署 ↓ 设置 SETUP_TOKEN ↓ 访问 /install ↓ 完成
如果只是自己使用,Cloudflare 免费套餐一般也足够。
项目地址:
https://github.com/lbjxr/CF-Navs
项目仍然在持续更新,后续如果部署方式发生变化,建议优先以 GitHub 最新 README 为准。