侧边栏壁纸
博主头像
Disue

Carpe diem

  • 累计撰写 8 篇文章
  • 累计创建 9 个标签
  • 累计收到 0 条评论

目 录CONTENT

文章目录

基于 Cloudflare Workers 的全功能短链接生成器教程

Disue
2025-12-17 / 0 评论 / 0 点赞 / 48 阅读 / 0 字

本教程将指导你部署一个稳定、安全且自带管理后台的短链接生成系统。

核心功能

  • 内置 UI:无需托管网页,代码自带响应式生成页面。

  • 管理后台:支持查看所有链接、动态修改验证码配置、一键删除。

  • 安全防护:集成 Cloudflare Turnstile 验证码,有效防止机器人刷量。

  • 自定义后缀:支持手动输入短链接后缀,也支持自动生成。

  • 数据持久化:使用 Cloudflare KV 存储,数据永不丢失。


第一步:创建 KV 数据库

在 Cloudflare 中,KV 数据库用于存储长链接与短链接的对应关系。

  1. 登录 Cloudflare 控制台

  2. 进入 “存储与数据库” -> “KV”

  3. 点击 “创建命名空间”,名称填入 LINKS

  4. 记录下这个名称,稍后需要绑定。


第二步:部署 Worker 代码

  1. 创建一个新的 Worker 脚本。

  2. 清空编辑器中的所有默认代码,粘贴下方提供的完整代码

  3. 修改管理员密码:在代码第 3 行找到 admin_pass: "admin123",将 admin123 改为你自己的私密密码。

https://github.com/oceansuc/SSURL/blob/main/ssurl.js

第三步:绑定 KV 命名空间

这是让代码能够访问数据库的关键步骤。

  1. 在 Worker 详情页,进入 “设置” -> “变量”

  2. “KV 命名空间绑定” 处点击添加。

  3. 变量名称:填入 LINKS

  4. KV 命名空间:选择你在第一步创建的 LINKS

  5. 点击 “保存并部署”


第四步:管理后台使用指南

1. 登录后台

访问 https://你的域名/admin,在弹出的对话框中输入你在代码里设置的密码。

2. 配置验证码 (Turnstile)

为了防止机器人刷量,强烈建议开启 Cloudflare 官方的验证码服务:

  1. 在 Cloudflare 控制台搜索 Turnstile

  2. 添加你的域名,获取 Site KeySecret Key

  3. 在你的短链接管理后台填入这两个 Key,勾选 “开启验证码” 并保存。

3. 链接管理

在后台下方的表格中,你可以看到所有生成的短链接。如果发现违规或不再需要的链接,点击 “删除” 按钮即可彻底从数据库中抹除。


教程到此结束! 现在的你已经拥有了一个高度自定义且安全的短链接服务。如果有任何疑问,欢迎在评论区讨论。

0

评论区