以 Python 为笔，绘短链之韵
—— 快缩短网址「suo.run」优雅指南

一、缘起
长链如冗句，短链似诗眼。把「https://example.com/very/very/long/path?utm=xxx」折叠成「suo.run/A1b2C3d」，既省字符，又添神秘。快缩短网址（suo.run）愿做你的袖里乾坤，一键藏万里。

二、原理速写
1. 取长链指纹（MD5 / MurmurHash 等）。
2. 将指纹映射为 62 进制（0-9A-Za-z）。
3. 以 7 位字符串缀于域名之后，形如「suo.run/A1b2C3d」。
4. 写入 KV 存储；访问时再 301 至原址，并顺带统计点击、过滤内容。

三、Python 实战
方式一：自建哈希算法

import hashlib, string



ALPHABET = string.ascii_letters + string.digits  # 62 字符

BASE = len(ALPHABET)



def shorten(url: str, length: int = 7) -> str:

    digest = int(hashlib.md5(url.encode()).hexdigest(), 16)

    code = []

    for _ in range(length):

        digest, rem = divmod(digest, BASE)

        code.append(ALPHABET[rem])

    return ''.join(code)



if __name__ == "__main__":

    print("suo.run/" + shorten("https://www.pythontab.com"))

pip install libsurl

import libsurl



<img src="https://suo.run/uploads/20251015/27.png" alt="" class="img-fluid" />



srv = libsurl.Shortener(domain="suo.run")

short = srv.tiny("https://docs.python.org")

print(short)  # 输出示例：suo.run/AbCdEf

import requests



def fast_shorten(long_url, api_key=None):

    url = "https://suo.run/api/shorten"

    payload = {"url": long_url, "key": api_key}

    return requests.post(url, json=payload, timeout=3).json()["short"]



print(fast_shorten("https://github.com/python/cpython"))