编码/解码

Punycode 编解码

域名与 Punycode(国际化域名)互转,如 中文.中国 ↔ xn--

Unicode 域名
Punycode 域名

什么是 Punycode?

Punycode 用于将国际化域名(含非 ASCII 字符)编码为仅含 ASCII 的 xn-- 形式,便于 DNS 解析与兼容。

使用场景

  • 国际化域名(IDN)与 ASCII 域名互转
  • DNS 配置、证书域名校验

Punycode 把域名中含非 ASCII 字符的标签转换为 RFC 3492 规定的 xn-- 形式,并支持反向还原。适合配置 DNS、TLS 证书或只收 ASCII 的 CDN 规则,也用于查清 xn-- 主机名的真实拼写。

按标签编码,而非按整串编码

整段都落在 U+0000–U+007F 内的标签原样输出,所以 中国.cn 只变成 xn--fiqs8s.cn,.cn 不会被改写。标签内的 ASCII 基础码点(basic code points)保留在前面,用单个 - 与编码尾部隔开:münchen 得到 mnchen-3ya;ü 单独出现时没有基础码点,输出 tda,连接符不出现。分隔符 U+002E、U+3002、U+FF0E、U+FF61 先统一为 ASCII 点号;邮箱输入时 @ 前的本地部分不转换。

尾部那串乱码来自 bootstring 参数

尾部是 RFC 3492 固定的 bootstring 序列:基数 36,数字先以 a–z 表示 0–25、再用 0–9 表示 26–35,起始码点 n = 128(U+0080),初始 bias 72,damp 700、skew 38,阈值 tmin = 1、tmax = 26。编码逐字符输出增量(到下一码点的距离加上已插入字符造成的索引位移),所以改一个字往往重写整段尾部:中文 是 xn--fiq228c,中国 是 xn--fiqs8s,只有开头的 fiq 相同。解码端参数必须完全一致,否则直接报无效输入。

输出是纯 Punycode,不是合法 A-label

本工具只做 RFC 3492 编码,不含 IDNA 处理:不做 NFC 归一化、不做大小写折叠、不查 UTS-46 映射表。Bücher.example 因此得到 xn--Bcher-kva.example,大写 B 原样进了标签,而规范化 A-label 是 xn--bcher-kva.example;café(U+00E9)与 cafe 加 U+0301 分别是 xn--caf-dma 与 xn--cafe-yvc。63 字节标签上限同样不校验。解码侧只认小写 xn--,XN--fiqs8s.cn 原样返回。

实操示例

用全角句号书写的域名

输入
中文。中国
输出
xn--fiq228c.xn--fiqs8s

全角句号 U+3002 在切分前被替换成 ASCII 点号,因此输出是两个各自带 xn-- 前缀的标签。两个标签都没有 ASCII 基础码点,前缀后面不会出现 - 分隔符,输出里唯一的连字符就是 xn-- 自带的那一个。尾部保存的是增量位置而不是逐字替换,所以把第二个字换成「国」会让整段重写:228c 变为 s8s。

边界与常见误用

  • 输入会先 trim,首尾空白被静默丢弃;但夹在标签中间的空白会被当作普通 ASCII 字符编进标签,中 国.cn 因此得到含空格的 xn-- -kq6az5z.cn,这种标签无法注册也无法解析。
  • 解码只匹配小写 xn-- 前缀,XN--fiqs8s.cn 与未加前缀的标签都原样返回,看起来像「没有解码」。
  • 非法载荷(如 xn--!!!!)内部会抛 RangeError,工具将其吞掉并显示空白,与真正的空输入无法区分。
  • 不做 IDNA 归一化:同一个域名的预组合与组合序列写法会得到不同的 A-label,与注册局数据比对前应先做 NFC。
  • 不校验 63 字节的标签上限,60 个 ü 会输出 66 字符的标签,只在注册或解析阶段才被拒绝。

相关工具

这个编解码器管到哪儿,UTS-46 从哪儿接手

你的情形本工具(纯 RFC 3492)替代做法
域名里带大写字母,或手机上输入法自动首字母大写这里一步都不折叠:Bücher.example 原样编成 xn--Bcher-kva.example,大写 B 进了基础码点前缀,尾部就是对这些码点算出来的。URL 解析器会先过一遍 UTS-46:new URL("https://Bücher.example").hostname 与 Node 的 url.domainToASCII 都给出 xn--bcher-kva.example。要拿去和注册局记录或证书里的字符串比对,走它们;只想知道自己实际输入的字符编出来长什么样,留在这里。
举报报告里抄来的域名是大写的 XN--fiqs8s.cn前缀判断按字面匹配小写,于是什么都没解出来,输出与输入一模一样——页面不是解错了,是根本没动手。先转小写:XN--fiqs8s.cn → xn--fiqs8s.cn → 中国.cn;或者整条交给 url.domainToUnicode,两种大小写都认,一次调用直接回 中国.cn。
粘贴时把整条网址贴了进来https://中国.cn 会得到 xn--https://-sd0mx14e.cn:RFC 3492 允许 : 和 / 作为基础码点留在标签内,而这个实现并不认识协议。让 URL 解析器先拆开:new URL("https://中国.cn").hostname 给出 xn--fiqs8s.cn。实操上更省事——地址栏里只复制主机名,本页只处理那一段。
想知道这个标签到底能不能过 DNS长度和字符都不校验:57 个「中」编成 63 个字符,58 个编成 64 个,页面照印不误,也不提示一句。把结果交给真实解析器验证,如 dig +short xn--fiqs8s.cn,或者让注册商的可用性检查去判——RFC 1035 的 63 字节标签上限是在那一层生效的,本页和 domainToASCII 都不管这件事。
CSV 里躺着两百个域名一次粘贴只换一次结果,没有列表入口,五分钟前转过什么也无处可查。用 Node 循环 url.domainToASCII:失败的名字返回空字符串,这是它唯一的失败信号。把非空结果写出来,先在本页抽查几行,再放心跑整批。

一个具体场景

把一个中文域名填进只收 ASCII 的解析字段

解析面板只收 ASCII,要迁的域名是 中文网.中国:6 个码点,连点号 16 个 UTF-8 字节。编码后是 xn--fiq228c5hs.xn--fiqs8s,25 个字符,两个标签分别是 14 与 10,离 63 字节上限还远。先把名字写成小写:DNS 不区分大小写,但白名单是按字符比的,本工具原样保留你的写法。点一次 ⇄,输出会搬进输入框并切到解码,确认回显正好是「中文网」;若多出大写字母,就改输入。

常见问题

为什么有些网址开头是 xn--?
这是国际化域名(IDN)的编码标记:DNS 体系只支持 ASCII,中文、日文等域名会被转换为 xn-- 开头的形式存储和解析。例如"中文.com"编码后是 xn--fiq228c.com。浏览器地址栏显示原文,实际请求用的是 punycode。
注册域名时应该填哪一种形式?
注册商通常两种都接受,但 WHOIS 记录和 DNS 配置里保存的是 xn-- 编码形式。做 DNS 解析、配置 CDN 或证书时,务必确认用的是编码形式还是 Unicode 形式,混用是常见故障源。
punycode 有安全风险吗?
有,主要是"同形异义字攻击":用西里尔字母 а 替换拉丁 a,注册肉眼难辨的假域名。现代浏览器只对高风险组合显示 punycode 原文。用本工具解码任何 xn-- 域名,可以快速核对真实拼写。

内容复核: