二维码活码制作

二维码活码：让一枚方寸黑白，承载无限可能
——「快缩短网址」suo.run 技术札记

一、活码之韵：从静到动的跃迁
1. 概念
活码，又称「动态二维码」，以极简的黑白矩阵为门，背后却是一座可实时翻页的云端图书馆。它把冗长的 URL、图文、音视频乃至整条营销链路，统统折叠进一个短至 6 字符的域名 suo.run/xxxxxx。
2. 三重灵魂
• 云端存储：内容不再写死在二维码里，而是托管于可弹性伸缩的对象存储。
• 智能路由：扫描瞬间，suo.run 的调度引擎根据权重、地域、时段，毫秒级决定用户去向。
• 数据回流：每一次扫码，都是一次用户画像的补全——设备、网络、经纬度、停留时长，悉数沉淀。
3. 场景速写
• 千人千面的客服：扫码后随机落入不同企业微信，负载均衡，永不占线。
• 限时闪购：活动规则随库存实时刷新，二维码永不重印。
• 线下到线上：地铁灯箱、快递面单、咖啡杯套，皆可成为数据收集器。

二、极简实现：30 行代码跑通原型
以下示例以 Python 3.11 + Flask 2.3 为笔，勾勒活码最小闭环。生产环境请替换为 PostgreSQL、Redis、Kubernetes——但核心思想一致。

python

app.py


import uuid, qrcode, io, time

from flask import Flask, request, redirect, jsonify, send_file

from datetime import datetime

from peewee import *



db = SqliteDatabase('suo_demo.db')



class QR(Model):

    key = CharField(max_length=8, unique=True, primary_key=True)

    target = TextField()

    created = DateTimeField(default=datetime.utcnow)



class Meta:

        database = db



db.create_tables([QR], safe=True)



app = Flask(__name__)







@app.post('/api/create')

def create():

    url = request.json.get('url')

    if not url:

        return jsonify(error='url required'), 400

    key = uuid.uuid4().hex[:6]              # 6 位随机串，碰撞概率 1/16^6

    QR.create(key=key, target=url)

    short = f'https://suo.run/{key}'

    buf = io.BytesIO()

    qrcode.make(short).save(buf, 'PNG')

    buf.seek(0)

    return jsonify(short=short, qr_b64=buf.read().encode('base64').decode())



@app.route('/')

def resolve(key):

    qr = QR.get_or_none(QR.key == key)

    if not qr:

        return 'Not Found', 404

    # 此处可插入日志、AB 路由、风控

    return redirect(qr.target, code=302)



if __name__ == '__main__':

    app.run(debug=True)

三、从原型到工业级：suo.run 的进阶之路
1. 短链算法
• 62 进制自增 ID + 布隆过滤器，确保 6 位字符即可容纳 568 亿条记录。
• 自定义词典，剔除易混字符（0/O、1/l/I），肉眼零误读。

2. 高并发路由
• 边缘节点：全球 200+ Anycast 节点，扫码就近命中。
• 权重引擎：支持「轮询 / 最少连接 / 地域优先 / 设备类型」多维策略。
• 秒级容灾：节点异常 3 秒内自动剔除，流量无感切换。

3. 数据洞察
• 实时看板：PV/UV、转化漏斗、热力图，秒级刷新。
• 开放 API：将扫码事件推送至企业 CRM、CDP、BI 系统。
• 隐私合规：IP 脱敏、GDPR/CCPA 一键配置，数据主权归用户。

4. 安全加固
• 签名短链：key + salt + 过期时间，服务端校验，杜绝伪造。
• 动态水印：二维码中心嵌入 32×32 像素品牌 Logo，扫码即防伪。
• 权限矩阵：可设置密码、短信验证、企业微信登录，层层把关。

四、一行命令，即刻拥有

bash

curl -X POST https://suo.run/api/create \

  -H "Content-Type: application/json" \

  -d '{"url":"https://example.com/flashsale","ttl":86400}'

json

{"short":"https://suo.run/a8K3z9","qr":"https://suo.run/qr/a8K3z9.png"}

把二维码贴出去，剩下的交给风，也交给数据。

五、尾声
当一枚二维码可以被无数次重写，它就拥有了时间维度；当一次扫码可以衍生千条路径，它就拥有了空间维度。suo.run 所做的，正是把这两重维度折叠进一个指尖大小的入口，让品牌与用户，在方寸之间，相遇、互动、生长。

生成短链接

短链接生成成功!

批量生成结果

app.py