一个基于 Cloudflare Workers 和 KV 的单文件短链接服务,包含一个响应式的、带有科技感界面的前端。
本项目是一个简单、轻量级的短链接解决方案。它利用 Cloudflare Workers 的边缘计算能力和 KV 存储进行数据持久化。整个 Worker 代码以及配套的前端界面(HTML/CSS/JavaScript)都集成在一个单独的 _worker.js
文件中,旨在简化部署和管理流程。
- 将长 URL 转换为短链接。
- 访问生成的短链接时,自动将用户重定向到原始长 URL。
- 完全运行在 Cloudflare Workers 上,无需传统服务器维护。
- 使用 Cloudflare KV 存储短链接到长链接的映射。
- 所有代码(Worker 逻辑与前端)都在一个
_worker.js
文件中。
- 一个 Cloudflare 账号。
- 一个 Cloudflare KV 命名空间。
部署此 Worker 需要将 _worker.js
代码上传到 Cloudflare,并配置一个 KV 绑定,使其能够访问你的 KV 命名空间。
你可以选择使用 Cloudflare 控制台页面进行部署:
- 登录 Cloudflare 控制台。
- 创建 KV 命名空间(如果还没有):进入 Workers & Pages -> KV -> 创建命名空间,记下这个名字。
- 创建或编辑 Worker:进入 Workers & Pages -> 概览 -> 创建 Worker 或选择现有 Worker。
- 在代码编辑界面,粘贴
_worker.js
的全部内容,并保存。 - 进入 Worker 的 设置 选项卡 -> 变量 -> KV 命名空间绑定。
- 点击 添加绑定。
- 变量名称: 输入
LINKS_KV
(注意大小写)。 - KV 命名空间: 从下拉菜单中选择你创建的 KV 命名空间的名字。
- 变量名称: 输入
- 保存设置。Cloudflare 会自动部署更新。
- 在浏览器中访问你的 Worker URL (例如
your-worker-name.your-subdomain.workers.dev
或你配置的自定义域名)。 - 页面加载后,在输入框中输入长链接。
- 点击按钮生成短链接。
- 生成的短链接将显示在下方区域。
- 访问生成的短链接即可重定向到原长链接。
以下表格列出了影响 Worker 行为或前端显示的主要可配置项和所需的绑定:
变量/绑定名称 | 类型/用途 | 说明 | 配置方式 |
---|---|---|---|
LINKS_KV |
KV 命名空间绑定 | 用于读写短链接到长链接映射的 KV 存储。必须配置此绑定,名称必须为 LINKS_KV 。 |
在 Cloudflare 控制台 Worker 设置的 KV 绑定中,变量名称设置为 LINKS_KV 并选择对应的 KV 命名空间。 |
纯自己牛马的想法🐂🐴