用GitHub搭建免费短链接教程

快缩短网址｜suo.run —— 极致轻量，瞬时生成的免费短链引擎

在信息奔涌的时代，每一个字符都承载着效率的重量。我们深知：一段简洁的链接，不只是长度的压缩，更是信任与体验的传递。

快缩短网址（suo.run），正是为这一理念而生——一个无需服务器、零成本部署、即时生效的在线短链接生成平台。它以极简之姿，诠释高效之道。

---

为何选择 suorun？

- ✅ 真正免费：无广告、无隐藏费用，永久免费使用
- ✅ 极速响应：毫秒级生成，秒级跳转，无卡顿，无延迟
- ✅ 安全可靠：基于 GitHub Pages 的静态托管架构，天然抗攻击
- ✅ 开源透明：代码公开可查，信任源于可见

---

一触即达的构建哲学

你无需购置服务器，不必配置数据库。只需三步，即可拥有属于你的专属短链服务：

1. 创建仓库
在 GitHub 上新建一个名为 gh-pages-url-shortener-db 的仓库（建议设为公开），作为你的链接“记忆库”。

2. 定制重定向逻辑
Fork本项目后，打开 404.html，将以下字段替换为你自己的信息：

   var GITHUB_ISSUES_LINK = "https://api.github.com/repos/{username}/{dbname}/issues/";

将 {username} 替换为你的 GitHub 用户名，{dbname} 替换为你刚刚创建的仓库名。

3. 启用 GitHub Pages
进入仓库设置 → GitHub Pages → 选择源分支（如 main），开启页面发布。
成功后，访问 https://yourname.github.io/ 即可激活服务。

---

一键生成，即刻生效

在你的仓库中新建一个 Issue，标题填写目标长链接，例如：

> 🌐 https://zh.wikipedia.org/wiki/科比·布莱恩特

保存后，立即访问：

https://suo.run/link/1

👉 你将被无缝跳转至科比的百科页面。

---

自动化升级：命令行驾驭短链

厌倦手动建 Issue？我们为你准备了 gh-short-url CLI 工具，让短链生成如呼吸般自然。

<h1>全局安装</h1>

npm install gh-short-url -g



<h1>配置你的短链环境</h1>

shorten config \

  --database=gh-pages-url-shortener-db \

  --user=your-github-username \

  --pages=suo.run



<h1>生成短链接</h1>

shorten https://en.wikipedia.org/wiki/Kobe_Bryant#Basketball_legacy/

输出结果：

✅ 短链接已生成：https://suo.run/link/2

> 🔗 工具已开源于 GitHub @gh-short-url，欢迎星标支持，共筑开放生态。

---

技术内核：静默中的智慧

一切始于一个巧妙的约定：
当用户访问不存在的路径（如 /link/1），GitHub Pages 会返回 404.html。
而这个文件，藏匿着整个系统的灵魂——一段精巧的 JavaScript 脚本，通过 GitHub API 动态读取对应 Issue 标题，并将其作为目标 URL 执行跳转。

> 无需后端，不依赖数据库，仅凭静态页面与 API 智能联动，实现“无服务器”的短链奇迹。

---

未来，从一个链接开始

快缩短网址（suo.run） 不仅仅是一个工具，更是一种轻量化数字生活的宣言。
它告诉我们：最强大的系统，往往诞生于最简洁的设计之中。

无论你是内容创作者、开发者、社群运营者，还是想优雅分享生活点滴的普通人——
你值得拥有一条干净、快速、可信的短链。

---

🌐 立即体验：https://suo.run
✨ 生成你的第一段短链接，让每一次分享，都从“快”开始。

> 快缩短网址 —— 简而不凡，速而有度。

短链接生成成功!