在 nginx 中配置国际化域名(idn)时,必须将域名转换为 punycode 格式(即以 xn-- 开头的 ascii 字符串),因为 nginx 的 server_name 指令仅支持标准的 ascii 字符集。直接使用中文或其他非 ascii 字符会导致配置解析失败或无法匹配请求。

Punycode 转换的具体方法是什么
要将国际化域名转换为 Nginx 可用的 Punycode 格式,可以使用 Python 等工具调用 idna 库进行编码。例如,域名 例子.com 会被转换为 xn--0zwm56d.com。在 Nginx 配置文件中,直接使用该 Punycode 字符串作为 server_name 的值即可。

import idna
domain = "例子.com"
punycode_domain = idna.encode(domain).decode('ascii')
print(punycode_domain) # 输出: xn--0zwm56d.com
假设你的 Nginx 配置如下:
server {
listen 80;
server_name xn--0zwm56d.com;
root /var/www/html;
}
当用户通过浏览器访问 http://例子.com 时,浏览器会自动将其转换为 http://xn--0zwm56d.com 并发送请求,Nginx 能够正确匹配该 server_name 并处理请求。
如何处理多个国际化域名的映射
如果需要为多个不同的国际化域名提供服务,可以在同一个 server 块中使用空格分隔多个 Punycode 域名,或者使用通配符模式。每个域名都必须单独转换为 Punycode 格式。

server {
listen 80;
server_name xn--0zwm56d.com xn--fsq.com;
root /var/www/html;
}
在这个配置中,xn--0zwm56d.com 对应 例子.com,而 xn--fsq.com 对应另一个国际化域名如 测试.com。Nginx 会根据请求头中的 Host 字段匹配这些 Punycode 域名。
如果请求头中包含原始国际化域名会怎样
如果客户端发送的请求头中 Host 字段包含原始的国际化域名(如 例子.com)而非 Punycode 格式,Nginx 将无法匹配任何 server_name,从而回退到默认服务器块。这是因为 Nginx 内部对 server_name 的比较是基于 ASCII 字符串的,不支持直接的 Unicode 匹配。


















