Skip to content

SunshineList/cf-short-url

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 

Repository files navigation

Cloudflare Worker 短链接系统

一个基于 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 控制台页面

  1. 登录 Cloudflare 控制台。
  2. 创建 KV 命名空间(如果还没有):进入 Workers & Pages -> KV -> 创建命名空间,记下这个名字。
  3. 创建或编辑 Worker:进入 Workers & Pages -> 概览 -> 创建 Worker 或选择现有 Worker。
  4. 在代码编辑界面,粘贴 _worker.js 的全部内容,并保存。
  5. 进入 Worker 的 设置 选项卡 -> 变量 -> KV 命名空间绑定
  6. 点击 添加绑定
    • 变量名称: 输入 LINKS_KV (注意大小写)。
    • KV 命名空间: 从下拉菜单中选择你创建的 KV 命名空间的名字。
  7. 保存设置。Cloudflare 会自动部署更新。

使用方法

  1. 在浏览器中访问你的 Worker URL (例如 your-worker-name.your-subdomain.workers.dev 或你配置的自定义域名)。
  2. 页面加载后,在输入框中输入长链接。
  3. 点击按钮生成短链接。
  4. 生成的短链接将显示在下方区域。
  5. 访问生成的短链接即可重定向到原长链接。

可配置项与绑定

以下表格列出了影响 Worker 行为或前端显示的主要可配置项和所需的绑定:

变量/绑定名称 类型/用途 说明 配置方式
LINKS_KV KV 命名空间绑定 用于读写短链接到长链接映射的 KV 存储。必须配置此绑定,名称必须为 LINKS_KV 在 Cloudflare 控制台 Worker 设置的 KV 绑定中,变量名称设置为 LINKS_KV 并选择对应的 KV 命名空间。

贡献

纯自己牛马的想法🐂🐴

About

CF worker 搭配KV空间的短链生成器

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published