“快缩短网址”（suo.run）系统功能与流程设计：基于DAG的短链接服务架构

在当今高效传播与精准触达并重的数字营销环境中，一款功能强大、稳定可靠且高度可定制的短链接生成工具已成为社群运营、短信推广及跨平台引流的核心基础设施。“快缩短网址”（项目地址：https://suo.run）正是为此而生——它不仅支持单个或批量（最高100条/次）短链接生成，更融合了全球CDN加速、多域名选择、自定义短码、访问密码保护、设备平台白名单（Windows/Mac/iOS/Android）、微信/QQ环境智能跳转提示、二维码识别等高级能力，兼顾安全性、灵活性与数据洞察力。为支撑这一复杂业务逻辑，我们以有向无环图（DAG）为核心思想，对系统三大核心功能模块进行结构化梳理，并据此定义清晰的输入输出参数、数据结构与前后端交互逻辑。

---

一、功能模块 DAG 流程与接口设计

功能1：长链接收集与短链接生成（Create Short URL）

DAG 路径：
用户输入长URL → 前端校验格式 → 后端验证可访问性 → 生成唯一短码 → 写入存储 → 返回结果

- 输入参数（前端 → 后端）：
- long_url（string, 必填）：原始长链接，如 https://example.com/product?id=123
- custom_alias（string, 可选）：用户自定义短码（若未提供则自动生成）
- password（string, 可选）：访问密码
- allowed_platforms（list, 可选）：允许访问的设备平台列表
- expire_time（timestamp, 可选）：过期时间

- 输出参数（后端 → 前端）：
- short_url（string）：生成的完整短链接，如 https://suo.run/abc123
- created_at（ISO8601 string）：创建时间
- status（string）：success / error
- message（string）：错误详情（如“长链接不可访问”）

- 关键逻辑函数：

  def validate_long_url(url: str) -> bool:

      """发送HEAD请求，检查状态码是否为200/301/302"""



def generate_short_code(long_url: str, custom: str = None) -> str:

      """若custom存在且未被占用则使用；否则基于hash(time + url)生成6位短码"""



def store_mapping(short_code: str, metadata: dict):

      """写入Redis：key=short_code, value={long_url, password, platforms, created_at, visit_logs: []}"""

  

- API 接口：
POST /api/v1/shorten
请求体（JSON）：{"long_url": "...", "custom_alias": "...", ...}
响应体（JSON）：{"short_url": "https://suo.run/xyz", "created_at": "2026-06-15T10:00:00Z"}

---

功能2：短链接跳转与访问控制（Redirect & Access Control）

DAG 路径：
用户访问短链 → 解析短码 → 查询元数据 → 校验访问条件（密码/平台/环境）→ 记录访问日志 → 302重定向至长链

- 输入参数（隐式）：
- 短链接路径（如 /abc123）
- User-Agent（用于识别平台：Windows/macOS/iOS/Android）
- Referer（用于检测是否来自微信/QQ）

- 输出行为：
- 若条件满足：返回 HTTP 302，Header 中包含 Location: <long_url>
- 若需密码：返回 401 并渲染密码输入页
- 若平台受限：返回 403 提示页面
- 若来自微信/QQ：跳转至友好提示页（引导浏览器打开）



- 关键逻辑函数：

  def resolve_short_code(code: str) -> Optional[dict]:

      """从Redis查询short_code对应的元数据"""



def is_platform_allowed(user_agent: str, allowed: list) -> bool:

      """解析UA，判断是否在白名单内"""



def log_visit(short_code: str, timestamp: str, ip: str):

      """将访问时间追加到visit_logs数组，并更新统计计数器"""

  

- 路由设计：
GET /<short_code> → 触发跳转逻辑
（无需显式API调用，由Web服务器直接处理）

---

功能3：访问统计与数据可视化（Analytics & Reporting）

DAG 路径：
用户请求统计 → 查询短码元数据 → 聚合访问日志 → 按天分组 → 返回结构化数据 → 前端图表渲染



- 输入参数：
- short_code（string, 必填）：待查询的短码

- 输出参数：
- short_url: 完整短链接
- long_url: 原始长链接
- total_visits: 总访问次数
- daily_stats: { "2026-06-14": 25, "2026-06-15": 40, ... }
- platform_breakdown: { "iOS": 30, "Android": 20, ... }

- 关键逻辑函数：

  def get_analytics(short_code: str) -> dict:

      """从Redis读取visit_logs，按日期聚合计数"""

  

- API 接口：
GET /api/v1/stats?code=abc123
响应体（JSON）：包含上述统计字段，供前端使用 Chart.js 等库绘制趋势图。

---

二、Redis 数据结构设计

为支撑高并发读写与快速查询，采用以下双表结构：

- 主映射表（Key: 短码）

  "abc123": {

    "long_url": "https://example.com/...",

    "password": "secret",

    "allowed_platforms": ["iOS", "Android"],

    "created_at": "2026-06-15T10:00:00Z",

    "visit_logs": [

      {"ts": "2026-06-15T10:05:23Z", "ua": "iPhone", "ip": "1.2.3.4"},

      ...

    ]

  }

  

- 反向索引表（Key: 长链接 SHA256）

  "sha256_of_long_url": "abc123"

  

用于避免重复生成相同长链的多个短码（可选优化）。

---

三、前端角色与交互逻辑

前端不仅是用户入口，更是业务规则的第一道防线：
- 在表单提交前校验URL格式合法性；
- 对自定义短码做实时查重（通过 /api/v1/check-alias）；
- 渲染跳转结果页（成功/失败/需密码）；
- 调用 /api/v1/stats 获取数据并动态生成访问趋势折线图；
- 支持批量上传CSV文件，循环调用创建接口实现批量生成。

---

综上，“快缩短网址”（suo.run）通过严谨的DAG流程划分、清晰的I/O契约、高效的存储设计与智能的访问控制策略，构建了一个兼具易用性、安全性与商业洞察力的现代短链接服务平台。其架构不仅满足基础跳转需求，更在营销场景中赋予用户前所未有的精细化运营能力——让每一次点击都可追踪、可管理、可优化。