《快缩短网址》——suo.run 技术漫游指南
让冗长归于静默，让轻盈成为永恒。

一、序章：从“长”到“短”的哲学
互联网是一座无垠的图书馆，而 URL 是每一本书的索书号。索书号越长，书架越拥挤；索书号越短，指尖越轻盈。快缩短网址（suo.run）要做的，正是把一本本厚重的精装书，折成一枚轻盈的书签，夹在世界的指缝之间。



二、接口：极简主义的 API 诗
1. 生成短链
POST /api/v1/shorten
请求体：{"origin":"https://example.com/very/long/url"}
返回体：{"short":"suo.run/aB3kL"}

2. 解析短链
GET /api/v1/expand?s=suo.run/aB3kL
返回体：{"origin":"https://example.com/very/long/url","ttl":86400}



3. 自定义别名
POST /api/v1/alias
请求体：{"origin":"https://example.com","alias":"demo"}
返回体：{"short":"suo.run/demo"}

4. 一键统计
GET /api/v1/stats?s=suo.run/demo
返回体：{"clicks":1024,"referrers":{"twitter.com":512,"weibo.com":256}}

三、算法：在 62 进制的星河里打捞唯一
1. 雪花 ID → 62 进制 → 6 位字符：
0-9、a-z、A-Z 共 62 个符号，6 位可容纳 568 亿种组合，足够让每一粒尘埃都有名字。
2. 布隆过滤器：在纳秒级内拒绝重复，避免“同名异书”。
3. LRU + 分布式缓存：热点短链常驻内存，冷门链优雅退场。

四、架构：云原生的三行诗
Nginx → Gateway → 短链服务 → Redis → MySQL → Kafka → 日志分析
• Nginx：SSL 终端、限流、WAF。
• Gateway：统一鉴权、灰度发布、熔断。
• 短链服务：无状态 Pod，横向扩展。
• Redis：双层缓存（L1 本地 Caffeine，L2 Redis Cluster）。
• MySQL：分库分表，雪花 ID 做 shard key。
• Kafka：点击流异步落盘，供实时大屏与离线数仓。

五、解法：把“坑”写成诗
1. 301 or 302？
对外 301（永久重定向）保 SEO；对内 302（临时重定向）保可观测。
2. 碰撞？
雪花 ID 天然单调递增，布隆过滤器二次校验，概率 < 10⁻¹²。
3. 过期？
默认 180 天无人访问即回收；高价值链可付费续命。

六、特殊场景：在风暴中保持优雅
• 高并发秒杀：本地缓存 + 令牌桶，单节点 10 w QPS 无抖动。
• 短链轰炸：IP 级限速 + 图形验证码 + 行为指纹。
• 域名被封：备用域名池 + DNS 智能切换，30 秒内完成漂移。

七、安全：让每一道门都有钥匙
1. HTTPS 强制、HSTS、TLS1.3。
2. 内容安全：AI 鉴黄、恶意网址库、举报即封禁。
3. 权限：OAuth2 + JWT，企业用户可设“仅团队可见”。
4. 审计：每一次点击皆写入不可篡改的日志链，满足 GDPR & 等保三级。

八、尾声：把世界折叠进口袋
在 suo.run，我们不做信息的搬运工，而做信息的雕塑家。
把冗长折叠，把瞬间延展；
把复杂藏进云端，把简单留给指尖。

现在，就让冗长的 URL 随风而去，
让 suo.run 成为你与世界之间最短的距离。