利用 Cloudflare 搭建一个短网址服务

众所周知，Cloudflare 被网友称为“赛博菩萨”，正是 Cloudflare 因为提供了非常慷慨的免费计划，不需要付费也不需要绑定银行卡即可使用大部分服务；
本文讲述了使用 Cloudflare Pages 和函数以及 DB 数据库来完全免费的搭建一个可自用可公开的短网址服务。

Short

molikai-work/short 是一个 GitHub 上的开源项目，全程使用了 Cloudflare 的服务来提供一个短网址服务。

此项目是由 x-dr/short 分叉并进行了大量修改和优化得来的，截至 2024/12/13 原作者已经有很长时间没有更新了，所以有了这个项目，基于原项目的优化维护版本。

优化后的版本支持支持设置密码来管理短链、使用 Turnstile 人机验证、黑名单域名管理、跳转页面配置、代理资源响应、多域名使用，可通过环境变量快速配置。

优化后的版本示例: c1n.top

部署

在 GitHub 上分叉此项目: molikai-work/short。
登录到Cloudflare控制台。
在帐户主页中，选择Workers 和 Pages-> 创建应用程序 -> Pages -> 连接到 Git。（Cloudflare 支持多种语言，推荐在控制台页面右上角将语言显示设置为与本教程相同的语言）
选择你创建的项目存储库，在 设置构建和部署 部分中，全部默认即可，不需要修改框架预设、构建命令等内容。
点击 保存并部署，稍等片刻等待网站部署完成。

6.《点击这里查看配置数据库操作的图示》

(1) 进入 Cloudflare 的控制台，查看左侧侧边栏，选择 Workers 和 Pages 展开菜单后再选择 D1：

(2) 在 D1 页面点击右上角的 创建数据库 以打开创建数据库菜单：

(3) 填写 数据库名称 输入框，名称随意，只要确保绑定是为同一个数据库即可，下方的位置选项可不选（这里已经填好，示范）：

(4) 完成数据库创建，接下来在数据库的操作页面，请点击 控制台，并查看主部署教程的下一步（第7步）：

在数据库控制台输入框粘贴下面语句执行 SQLite 的命令创建表执行即可。

DROP TABLE IF EXISTS links;
CREATE TABLE IF NOT EXISTS links (
  `id` integer PRIMARY KEY NOT NULL,
  `url` text,
  `slug` text,
  `password` text,
  `email` text,
  `ua` text,
  `ip` text,
  `status` text,
  `hostname` text ,
  `create_time` DATE
);
DROP TABLE IF EXISTS logs;
CREATE TABLE IF NOT EXISTS logs (
  `id` integer PRIMARY KEY NOT NULL,
  `url` text ,
  `slug` text,
  `referer` text,
  `ua` text ,
  `ip` text ,
  `status` text,
  `hostname` text ,
  `create_time` DATE
);
DROP TABLE IF EXISTS banDomain;
CREATE TABLE IF NOT EXISTS banDomain (
  `id` INTEGER PRIMARY KEY NOT NULL,
  `domain` TEXT,
  `create_time` TEXT DEFAULT (strftime('%Y-%m-%dT%H:%M:%SZ', 'now'))
);

CREATE UNIQUE INDEX links_index ON links(slug);
CREATE INDEX logs_index ON logs(slug);
CREATE UNIQUE INDEX banDomain_index ON banDomain(domain);

选择部署完成项目，前往 Cloudflare Pages 项目控制面板依次点击 设置 -> 函数 -> D1 数据库绑定 -> 编辑绑定 ->添加变量，变量名称填写：DB -> D1 数据库选择 [刚刚创建好的数据库]

《点击这里查看绑定操作的图示》

(1) 打开具体项目的控制台：

(2) 进入设置找到函数选项并向下拉：

(3) 找到D1数据库绑定，编辑，变量名称填 DB，D1 数据库选择刚刚创建的数据库（这里已经填好，示范）：

在项目控制台主页重新部署项目以刷新数据。完成。

配置环境变量与信息

事实上你现在可以开始使用了，因为所有的环境变量与配置信息全部都是可选配置的，不配置则执行默认的相关函数，不影响正常使用。

你可以在 Cloudflare Pages 项目控制面板 设置 -> 环境变量 -> 制作 -> 为生产环境定义变量 中配置以下环境变量。

变量名称	示例值	可选	介绍
SHORT_DOMAINS	example.com	是的	短链生成后的显示域名，没有变量则默认自动获取当前域名
DIRECT_DOMAINS	example.com	是的	直链域名，设置后使用该域名访问则直接 302 重定向跳转，多个用逗号分割，没有变量则默认不启用直链跳转
ALLOW_DOMAINS	example.com,example.org	是的	允许解析目标地址的域名白名单，设置后只能使用该域名访问跳转，否则拒绝请求，多个用逗号分割，没有变量则默认不启用允许解析域名白名单
TURNSTILE_SECRET_KEY	0x2Ba5_qET35AIiYUO-ZGHtaHc	是的	Turnstile 的密钥，没有变量则默认不启用 Turnstile 验证

你还可以在项目的 functions 文件夹下找到 utils.js 文件，可以在这里浏览通用函数和部分设置信息，例如在后端的短链的显示名称。

在前端展示的信息需要你手动去一个一个的更新，推荐使用 Visual Studio Code 的查找、替换功能。

设置黑名单域名

你可以向 Cloudflare 的 D1 数据库的已创建短链数据库中的 banDomain 数据表添加数据以设置黑名单域名。

在此数据表中的域名均无法创建/解析短链。

请直接在 banDomain 数据表的 domain 项添加要加黑名单的一级域名，如 example.com ，其他的数据项会自动填写。

这里推荐另一个项目 JacobLinCool/d1-manager，可视化 Cloudflare 的 D1 数据库的操作，更方便的设置和备份数据表。

配置 Turnstile 验证

如果未在环境变量中配置关于 Turnstile 密钥的环境变量，请忽略本节信息。

如果你需要开启 Turnstile 验证功能，请：

在 Turnstile 页面根据引导步骤申请获得站点密钥和密钥，然后配置环境变量 TURNSTILE_SECRET_KEY 的值为密钥内容。
在项目根目录的 index.html 文件，将第 47 行的元素的 data-sitekey 属性设置为你的站点密钥。另外可以还取消下一行的注释以更好的提醒验证码的存在。
在项目 pages 目录下的 manage.html 文件，将第 57 行的元素的 data-sitekey 属性为设置你的站点密钥。

配置项目部署设置

项目根目录文件 _headers
请求响应头设置，参见 Cloudflare Pages 文档：标头
项目根目录文件 _redirects
重定向设置，参见 Cloudflare Pages 文档：重定向
项目根目录文件 _routes.json
路由设置，参见 Cloudflare Pages 文档：路由

API

仅限未启用 Turnstile 验证的情况下可以任意使用 API 生成。

# POST 请求到 /create
curl -X POST -H "Content-Type: application/json" -d '{"url":"https://example.org/http"}' https://example.com/create

# 指定 slug，还支持 email、password
curl -X POST -H "Content-Type: application/json" -d '{"url":"https://example.org/http","slug":"example"}' https://example.com/create

响应:

{
    "code": 200, // 响应状态码
    "message": "success", // 响应信息
    "time": 1717431484672, // 当前时间戳
    "url": "https://example.org/http", // 原始 URL
    "slug": "example", // 短链 Slug
    "link": "https://example.com/example" // 短链完整 URL
}