动态短链与自有域名
按设备、地区和微信内外跳转,以及绑定已验证的短链域名
条件跳转
动态短链仍然走原来的 /s/{别名} 入口,并记录同样的扫码展示事件。规则按保存顺序匹配,命中第一条就使用它的目的地址。
| 条件 | 取值 | 依据 |
|---|---|---|
| 设备 | ios、android、desktop | User-Agent |
| 微信 | in 微信内,out 微信外 | User-Agent 中的 MicroMessenger |
| 地区 | 国家、省或城市,例如 CN 或 中国 | 扫码请求上已有的平台地理头 |
没有规则命中时打开短链原来的默认地址。
地区规则只在请求带有可用地理信息时生效。当前扫码记录在没有 Vercel x-vercel-ip-* 或 Cloudflare cf-ipcountry 时,仍写入原来的占位地区。这种占位结果视为地区不可用,地区规则会被跳过,访问回到默认链接。不会为此新增地理库。
目的地址必须是完整的 http 或 https 链接。javascript: 和其他协议会被拒绝。
在「我的二维码」里编辑一个已有动态码,打开「跳转」即可维护这份短列表。API Key 和 MCP update_link 也可以提交 routingRules。这项能力属于已经创建的动态码,不额外扣积分。
自有短链域名
登录后打开「短链域名」,添加例如 qr.example.com。验证通过前,这个域名不会解析短链。
所有权验证记录加在 _codebox-verify.qr.example.com,二选一:
- TXT:
codebox-verify=<令牌> - CNAME:指向页面给出的
<令牌>.verify.<站点后缀>
验证只查询 DNS,不会请求该域名上的网页。一个域名只能属于一个账号。平台自己的主机不能被绑定。
验证通过后,新创建的动态码会写成 https://qr.example.com/别名。原来的 https://www.codebox.club/s/别名 继续可用。自有域名上的 /别名 会在应用内改写到同一条短链,并且只有域名所有者的链接会被打开。
公网 HTTPS 还需要把该域名加到 Vercel 项目,并按 Vercel 给出的记录解析,常见是 CNAME 到 cname.vercel-dns.com。这个仓库没有安全的项目令牌,不会自动完成这一步。验证成功只表示应用认得这个 Host,不表示 Vercel 已经接入。