短链接 · 简单管理

English

---

Cunlink

基于 Cloudflare Workers + D1 的个人短链接系统。 由 Web3村长 在 shrtnr 基础上修改定制。

轻量、快速、完全掌控。将冗长的网址一键缩短，实时追踪点击数据。

功能特性

• 免费托管 在 Cloudflare Workers + D1 上运行，无需服务器，无需月费
• 短链生成 支持 3 位随机短码，也可使用自定义短码
• 点击分析 追踪来源、国家、设备、浏览器等维度
• 链接分组 将相关链接分组，统一查看组合数据
• 管理后台 链接管理、分析图表、二维码生成
• 多语言界面 中文 / English

快速部署

以下步骤在本地终端操作，需安装 Node.js 和 Wrangler CLI。

1. 准备环境

# 克隆仓库
git clone https://github.com/你的用户名/cunlink.git
cd cunlink

# 安装依赖
yarn install

2. 创建数据库和 KV

在 Cloudflare Dashboard 操作：

1. Workers & Pages → D1 → 创建数据库，名字随意（如 cunlink-db）
2. Workers & Pages → KV → 创建命名空间，名字随意（如 cunlink-kv）

3. 部署 Worker

# 首次需要登录（如果没登录过）
npx wrangler login

# 部署
yarn deploy

4. 配置绑定

部署成功后，去 Cloudflare Dashboard：

1. Workers & Pages → Workers 标签 → 点你的 cunlink Worker

2. 设置 → 绑定 → 添加绑定：

   绑定类型	变量名	选择
   D1 数据库	DB	选你刚创建的 D1 数据库
   KV 命名空间	SLUG_KV	选你刚创建的 KV 命名空间

5. 初始化数据库

Worker → D1 标签 → 点击你的数据库 → 控制台，打开仓库中 migrations/init.sql，按文件中标注的步骤逐条执行（D1 Console 每次只能执行一条 SQL，请勿一次性粘贴全部内容）

6. 完成

所有步骤完成后刷新 Worker 页面即可使用。

本地开发

yarn install
npx wrangler d1 migrations apply DB --local
npx wrangler dev

然后访问 http://localhost:8787 即可查看。

本地开发免登录：在项目根目录创建 .dev.vars 文件：

DEV_IDENTITY=dev@local

然后启动 npx wrangler dev 即可自动以该身份登录。

访问控制

管理后台 (/_/admin/*) 默认不内置用户认证。建议使用 Cloudflare Access 来保护后台。

致谢

Cunlink 是基于 shrtnr 修改定制的衍生作品。

• 原作者: Oddbit
• 原仓库: github.com/oddbit/shrtnr
• 开源协议: Apache License 2.0

感谢 Oddbit 团队开发并开源了 shrtnr 这个优秀的短链接系统。

许可证

Copyright (c) 2026 Web3村长

本项目为 shrtnr 的衍生作品，基于 Apache License, Version 2.0 许可。

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

完整的许可证文本请参见 LICENSE 文件和 NOTICE 文件。