ShortLink
高性能短链接服务

游戏发行推广的痛点

在游戏发行领域，推广链接往往承载了大量的追踪参数——渠道标识、广告计划ID、创意素材编号、回调地址等。一条完整的推广链接动辄超过200个字符：

这样的长链接带来的问题是显而易见的：

现有方案的不足

市面上的短链接服务主要分为两类：

• 第三方 SaaS 服务（如 bit.ly 等）：数据托管在第三方，存在数据安全风险；免费版有 QPS 限制；无法自定义域名；海外服务在国内访问延迟高。
• 自建简易方案：通常基于 MySQL 自增 ID 或随机字符串，缺乏缓存设计，高并发下数据库成为瓶颈；没有异步统计，跳转请求被阻塞；缺少完整的管理后台。

整体架构

ShortLink 采用经典的分层架构，Go + Gin 提供 API 服务，Redis 作为缓存层，MySQL 作为持久层：

核心流程：302 跳转

1. 1 客户端发起 GET /aB3xKm 请求
2. 2 Trace 中间件生成唯一 request_id，写入 Context
3. 3 请求日志中间件记录入站信息
4. 4 查询 Redis 缓存（key: sl:aB3xKm）
5. 5 缓存命中 → 直接返回 302 跳转
6. 6 缓存未命中 → 查询 MySQL（唯一索引）→ 回写 Redis
7. 7 检查过期时间，已过期返回 404
8. 8 异步写入点击日志（push 到 buffered channel）
9. 9 异步递增 Redis 计数器（INCR 命令）
10. 10 返回 302 Location 响应

异步点击统计

点击统计是短链接服务的核心需求，但绝不能阻塞跳转请求。ShortLink 的统计设计：

• Buffered Channel —— 容量 10,000，跳转请求只做 channel push，纳秒级完成
• 批量写入 —— 每 5 秒或累积 100 条触发一次批量 INSERT，大幅减少 DB 连接开销
• Redis INCR —— 点击计数通过原子递增实现，每分钟定时同步到 MySQL total_clicks 字段
• 背压保护 —— channel 满时丢弃统计（不影响跳转），保障核心链路稳定

短码生成算法

ShortLink 的短码生成由两部分组成：

• Snowflake ID 生成 —— 64 位整数，由时间戳（41位）+ 机器ID（10位）+ 序列号（12位）组成。单节点每毫秒可生成 4096 个唯一 ID，满足任何业务规模。
• Base62 编码 —— 将 64 位整数编码为 [0-9A-Za-z] 字符串，通常产生 6-8 位短码。相比 Base64 不包含特殊字符，URL 安全无需额外编码。

一分钟启动

Docker 部署

创建第一条短链接

响应示例：

管理后台集成

如果你使用 gin-vue-admin 作为管理后台框架，ShortLink 提供了开箱即用的模块集成方案。只需将 background 目录下的模块文件复制到你的项目中，重启服务即可自动完成：

• 数据表自动迁移
• 菜单自动注册（短链接管理 → 短链接列表）
• API 权限自动注册
• RBAC 策略自动分配