快速访问服务 · 说明 (v2)
基于 Cloudflare Workers + KV + D1 的智能短链接服务,全面升级 Token 鉴权机制,极简资源消耗。
使用场景
- 个人收藏夹快速跳转:将常用网址设为短链接,告别书签臃肿。
- 社交媒体签名:在微博、微信、邮件签名中放短链接,指向个人主页。
- 活动推广 / 文件分享:为每次活动生成专属短链。
- 内部系统导航:企业内网为 OA、邮箱等设置别名。
- API 代理:参数化路径动态跳转,实现轻型路由。
v2 核心功能
- Token 鉴权机制:登录后返回 JWT(有效期 2 小时),后续管理操作无需重复传输密码,大幅降低密码泄露风险。
- 可视化规则管理:添加、编辑、删除规则,支持备注。
- 站点深度自定义:标题、图标、导航名称、大标题、小标题、404 地址、版权信息。
- 智能 404 跳转:自动携带当前域名和路径跳转至指定 404 页面。
- 访问计数:D1 实时记录重定向次数。
- 密码联动与修改:支持与云盘共用 KV 或独立设置密码;管理员可在站点设置中修改密码,保留共享键值其他字段不变。
- 性能优化:普通跳转不读取密码,管理 API 鉴权不再重复读取 KV,整体 KV 读取次数降低约 40%。
- 输入容错:短路径自动补全
/,目标 URL 自动补全 https://。
单次操作资源消耗对比(v1.3 → v2)
| 场景 | 资源 | v1.3 | v2 | 变化 |
| 普通重定向 | KV 读取 | 1 次 | 1 次 | — |
| D1 写入 (计数) | 1 次 | 1 次 | — |
| 管理登录 | KV 读取 | 2 次* | 1 次** | ⬇️ 50% |
| 添加/编辑规则 | KV 读取 | 2 次* | 1 次 | ⬇️ 50% |
| KV 写入 | 1 次 | 1 次 | — |
| 修改密码 | KV 读取 | 2 次* | 2 次 | — |
* 含读取 sys_config(密码)和 redirect_data
** 仅读取 redirect_data,密码通过 Token 验证,不再额外 KV 读取
✅ 结论:v2 采用 JWT 后,绝大多数管理操作的 KV 读取次数减少一半,进一步降低了配额压力。
Worker 配置教程 (v2)
从零部署短链接服务(支持 Token 鉴权),可与云盘共用 KV 同步密码。
0. 准备工作
- 一个 Cloudflare 账号(注册)
- 一个可绑定的 域名(推荐腾讯云 .cn 域名)
- 域名的 DNS 服务器已修改为 Cloudflare 提供的地址
1. 创建 Cloudflare 资源
1.1 创建 KV 命名空间
- 进入 Cloudflare Dashboard →【Workers & Pages】→【KV】。
- 点击“创建命名空间”,名称如
REDIRECT_KV,保存。
1.2 创建 D1 数据库
- 进入【Workers & Pages】→【D1】。
- 点击“创建数据库”,名称如
redirect-db。
- 创建后进入数据库详情,点击“控制台”,执行以下 SQL:
CREATE TABLE IF NOT EXISTS redirect_counter (
id INTEGER PRIMARY KEY DEFAULT 1,
count INTEGER DEFAULT 0
);
INSERT OR IGNORE INTO redirect_counter (id, count) VALUES (1, 0);
2. 创建 Worker 并绑定资源
- 进入【Workers & Pages】→“创建应用程序”→“创建 Worker”。
- 命名 Worker,部署后进入编辑页面。
- 点击“设置”→“变量和机密”:
- 在“KV 命名空间绑定”中添加:变量名
KV_PAN,选择你的 KV。
- 在“D1 数据库绑定”中添加:变量名
DB,选择你的 D1。
3. 绑定自定义域名
- 进入 Worker 详情页 →“触发器”→“添加自定义域”。
- 输入你的短链接域名,Cloudflare 自动配置 DNS。
4. 环境变量配置
在 Worker 设置 → 变量和机密 → 环境变量中,添加以下变量:
重要:
JWT_SECRET 必须设置(建议长度 ≥32 字符),否则登录接口将返回 500 错误。
- 如果此 Worker 与私有云盘共用 KV,则无需设置
ADMIN_PASSWORD,密码由云盘管理;但两个 Worker 必须配置相同的 JWT_SECRET,否则 Token 无法互通验证。
- 若不共用 KV,可设置
ADMIN_PASSWORD 作为初始密码,部署后通过站点设置修改。
5. 部署与验证
- 将 Worker 代码完整粘贴,点击“保存并部署”。
- 访问
https://你的域名/rules 查看规则页。
- 点击右上角“管理”,输入管理员密码进行登录,系统将自动获取 Token 并保持管理状态。
- 在管理模式中可随时修改密码,密码修改后旧的 Token 仍有效期内可继续使用,退出管理后会要求重新登录。