password
category
实用工具
status
Published
date
Feb 8, 2026
slug
cloudflare-workers-short-url
icon
tags
type
Post
summary
还在忍受第三方短链的广告和随时失效的风险吗？本文手把手教你搭建一个功能完备的私有短链系统。支持自定义后缀、点击量统计、防 Referer 溯源以及微信/QQ 社交环境防拦截引导。零成本，高性能，隐私尽在掌握。
在分享链接时，长 URL 往往影响美观，且容易暴露后台地址。市面上的短链工具（如 bit.ly 等）虽然方便，但存在数据泄露、跳转广告、无法使用等风险。利用 Cloudflare 全球边缘网络自建短链，不仅完全免费，还能实现高度的定制化。
使用教程
第一步：登录
访问你的域名（或 Worker 默认地址）并在末尾加上
/admin。例如：你绑定的域名/admin
输入你在环境变量中设置的
ADMIN_KEY 的密码即可进入系统。
第二步：生成短链
- 目标长链接：输入你想要缩短的长 URL（必须以
http或https开头）。
- 备注/标签（选填）：输入方便你记忆的描述。
- 短链后缀：
留空：系统生成随机 ID（如
你绑定的域名/a7b2c9）。自定义：输入你想要的词（如
你绑定的域名/1）。绑定主页：输入
@root，则访问 你绑定的域名 根目录时直接跳转。- 点击 立即生成。
第三步：管理与维护
- 编辑：点击列表右侧的蓝色“编辑”图标。此时表单会切换为编辑模式，你可以修改目标地址、备注，甚至修改后缀 ID（系统会自动处理旧 ID 的删除和新 ID 的创建）。
- 删除：点击红色的垃圾桶图标，系统会同时删除该链接的存储数据和点击量统计。
- 复制/二维码：直接点击对应的按钮即可快速分享。
部署指南
1. 准备工作
- Cloudflare 账号：拥有一个 Cloudflare 账号。
- KV 命名空间：
在 Cloudflare 控制台，进入 Workers & Pages > KV。
创建一个新的命名空间，命名为
shortdb
2. 创建 Worker
在 Workers 界面点击 Create Application -> Create Worker。
选择从 Hellow world！开始
重新命名你的短链项目，项目名称可以自定义，无强制要求
重点：将我提供的代码全部粘贴到编辑器中。一定要把原来的全部删除完，然后复制我给出的代码。
点击展开代码
配置环境变量（非常重要）：
- 进入该 Worker 的 设置 > 变量和机密。
- 添加变量
ADMIN_KEY：设置你的管理登录密码（建议设置为复杂的字符串），然后点击部署即可。可以参考下图
绑定 KV 命名空间：
在 wokers 项目选择绑定，添加绑定
选择 KV 命名空间，点击添加绑定。
- Variable name（变量名称） 必须填
shortdb。不然会因为找不到报错。
- KV namespace（KV 命名空间）选择你刚才创建的那个空间。这个我起的两个名字一样。
- 点击 Save and Deploy（添加绑定）
3. 域名绑定
虽然 wokers 会提供一个免费的域名，但是往往很长，本来我们就是做短链项目，所以cf免费提供的我们肯定不会去用的，而且国内可能无法访问。
强烈建议绑定一个简短的域名，这样生成的短链接更短。如过没有，可以去买一个，普通后缀的一年才十几块。不要用免费域名，如果做短链跳转还用长域名，那我建议不要做了，毫无意义。
域名购买推荐：【点击访问】
教程完善更新中。
- 作者:NotionNext
- 链接:https://tangly1024.com/article/cloudflare-workers-short-url
- 声明:本文采用 CC BY-NC-SA 4.0 许可协议，转载请注明出处。
.svg?table=collection&id=dd046e88-ea74-836b-82a1-0728c9872e33&t=dd046e88-ea74-836b-82a1-0728c9872e33){kind=avatar}
