Nginx报错“invalid server name or wildcard”的原因和解决方案_ar

很多人第一次给网站配置 https 时，会遇到一个看似奇怪的报错：

nginx: [emerg] invalid server name or wildcard "abc-*.example.cn" on 0.0.0.0:80

明明就是想用通配符匹配多个子域，结果保存不成功。

这其实不是语法写错，而是 nginx 对通配符的使用范围有限制。

本文就来一步步讲清楚，帮你从根本上解决这个问题。

一、问题场景复现

假设你有两个域名都在同一台服务器上：

https://api.example.cn
https://web.example.cn

你在 nginx 配置时，想着简单点，写成：

server_name abc-*.example.cn;

保存时却直接报错：

nginx: [emerg] invalid server name or wildcard "abc-*.example.cn"
nginx: configuration file test failed

这到底是哪里不对？

二、错误原因：nginx 不支持“中间通配”

nginx 的通配符（*）规则是有限制的：

写法	是否支持	示例	说明
`*.example.cn`	✅ 支持	匹配 `api.example.cn`、`web.example.cn`	✅ 通配符必须在最左边
`example.*`	✅ 支持	匹配 `example.cn`、`example.com`	✅ 通配符可以在最右边
`abc-*.example.cn`	❌ 不支持	想匹配 `abc-web.example.cn`、`abc-api.example.cn`	❌ 通配符不能出现在中间

也就是说，你写的 abc-*.example.cn 是 非法的写法。

nginx 不知道如何去匹配这类模式，因此直接拒绝加载。

三、正确写法与最佳实践

根据你的实际需求，有几种安全可行的方式：

方案一：直接列出多个域名（最推荐）

如果只是几个固定域名，比如：

api.example.cn
web.example.cn

那就直接列出来：

server_name api.example.cn web.example.cn;

这样写最清晰、兼容性最好，也不会报错。

方案二：使用标准通配符（同一层级）

如果你确实想让一个配置同时匹配多个子域（例如网站很多个）：

server_name *.example.cn;

这表示它可以匹配：

api.example.cnweb.example.cncdn.example.cn

但注意：

它只匹配一级子域（xxx.example.cn），
不会匹配多层结构（如 a.api.example.cn）。

方案三：多个项目共用证书但分开配置

比如你同一台服务器上部署了：

api.example.cnweb.example.cn

而另一台服务器有：

shop.example.cn

这种情况下，你可以让每台服务器都使用同一张通配符证书（*.example.cn），
但在各自的 nginx 里写独立配置：

在服务器 a

server_name api.example.cn web.example.cn;

在服务器 b

server_name shop.example.cn;

这样能共用证书，又不会让不同机器互相干扰。

四、完整可用示例（两个域名在同一台服务器）

下面这份配置可以直接用在宝塔或手动编辑中：

# http 自动跳转 https
server {
    listen 80;
    server_name api.example.cn web.example.cn;
    return 301 https://$host$request_uri;
}

# https 配置
server {
    listen 443 ssl http2;
    server_name api.example.cn web.example.cn;

    ssl_certificate     /www/server/panel/vhost/cert/example.cn/fullchain.pem;
    ssl_certificate_key /www/server/panel/vhost/cert/example.cn/privkey.pem;
    ssl_protocols tlsv1.2 tlsv1.3;

    add_header strict-transport-security "max-age=31536000";
    add_header x-frame-options sameorigin;
    add_header x-content-type-options nosniff;

    # 根据访问的域名切换网站目录
    if ($host = api.example.cn) {
        root /www/wwwroot/api.example.cn/dist;
    }

    if ($host = web.example.cn) {
        root /www/wwwroot/web.example.cn/dist;
    }

    index index.html index.htm;
    try_files $uri $uri/ /index.html;

    access_log /www/wwwlogs/https-access.log;
    error_log  /www/wwwlogs/https-error.log;
}

五、证书建议

为了同时支持多个子域名：

建议使用 通配符证书：*.example.cn
在签发时选择 dns 验证 模式（http 验证无法验证通配符）
同一张证书可以放在多台服务器上使用，只要路径一致即可。

六、总结

问题	原因	正确做法
报错 “invalid server name or wildcard”	通配符出现在中间（`abc-*.example.cn`）	改为具体域名或标准通配（`*.example.cn`）
想匹配多个域名	可以空格分开多个域名	`server_name api.example.cn web.example.cn;`
想共用 https 证书	使用 `*.example.cn` 通配符证书	多个子域共用
不同服务器不同站点	各自独立配置	不互相影响