快缩短网址·suo.run
—— 极致轻盈，却重若千钧的短链引擎

一、核心灵魂
1. 短码炼金术
• 双生哈希：MurmurHash3 与 CRC32 交织成 62 进制 6 位短码，冲突概率 <0.0001%。
• 弹性扩展：一旦碰撞，自动追加校验位，优雅跃迁至 7 位，依旧可定制。
• 预计算池：百万级短码预先铸造，毫秒级发放。

2. 存储诗篇
Redis Cluster 三主三从，读写分离；数据如诗行：
HSET short_links:aB3FgT url "https://original.url"
HSET short_links:aB3FgT expire 1717027200
HSET short_links:aB3FgT clicks 0
ZADD clicks:aB3FgT 1717027200 1

3. 安全三重奏
• 实时黑名单：Google Safe Browsing 毫秒级拦截。
• 特征嗅探：SQL/XSS 正则森林，滴水不漏。
• 行为画像：IP 频率 + 设备指纹，异常无处遁形。

二、API 之韵
POST /api/v2/shorten
Authorization: Bearer
{
"url": "https://example.com/long-url",
"custom_code": "opt_code",
"expire": 86400,
"domain": "custom.com"
}

返回：
{
"code": "aB3FgT",
"short_url": "https://suo.run/aB3FgT",
"qr_code": "data:image/png;base64,..."
}



三、性能之翼
• 短码生成：预计算池 + 批量插入，P99 42 ms。
• 跳转解析：本地缓存 + 布隆过滤器，P99 8 ms。
• 点击统计：Pipeline 批刷 + 异步 TSDB，P99 12 ms。

四、智慧之光
• 智能路由：地域 DNS + CDN 调度，设备自适应。
• 分析面板：Mapbox 热力图、UTM 自动解析、AI 异常预警。
• 开发者乐园：8 种语言 SDK、Webhook、沙盒环境。

五、全球织网
• AWS Global Accelerator + CloudFront，边缘预热热点。
• Kubernetes HPA 弹性伸缩，Redis Cluster 动态分片。
• Prometheus + Grafana，关键指标透明：
生成成功率 >99.99%，跳转 P99 <50 ms，吞吐 >100k QPS。

六、安全之盾
• 传输：TLS 1.3 + 双向证书。
• 存储：AES-256 字段级加密。
• 审计：180 天 ClickHouse 全链路日志。

七、私有化羽翼
Docker 镜像、Helm Chart 一键部署；企业版支持 LDAP/SCIM、SAML SSO。

实测锋芒
生成中位 68 ms，跳转中位 6 ms，单节点 24 k QPS，横向线性增长。



suo.run —— 让每一次点击，都成为优雅的抵达。