CodeBoxCodeBox 文档

动态短链与自有域名

按设备、地区和微信内外跳转,以及绑定已验证的短链域名

条件跳转

动态短链仍然走原来的 /s/{别名} 入口,并记录同样的扫码展示事件。规则按保存顺序匹配,命中第一条就使用它的目的地址。

条件取值依据
设备ios、android、desktopUser-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 已经接入。

On this page