Nginx 配置域名时,server_name 只写域名本身不带 http://、不带端口、不带路径;端口只由 listen 指令决定,一个 listen 端口搭配一组 server_name 构成一个虚拟主机,想让不同域名指向不同服务端口,要么给每个端口单独写 server 块,要么在同一个 80/443 端口上按 server_name 分流后用 proxy_pass 转到后端端口。
这句话基本概括了整件事的核心,但真正落到线上的配置文件里,出错的地方往往不是这句结论,而是结论之外的细节:多写了一个冒号、漏了一个 www、default_server 被别的站点抢走、安全组没放行,下面按配置逻辑一层层拆开说。
nginx server_name 配置多个域名怎么写
server_name 的正确写法:只写主机名
server_name 的职责是"这个请求的 Host 头是哪个域名",它不负责传输层的事,所以下面这些写法全部是错的,而且错得很隐蔽,nginx -t 不一定报错,只是不生效:
| 写法 | 是否正确 | 问题在哪 |
|---|---|---|
server_name example.com; |
正确 | 标准写法 |
server_name www.example.com example.com; |
正确 | 多个域名空格分隔 |
server_name http://example.com; |
错误 | 协议不属于 Host 头 |
server_name example.com:80; |
错误 | 端口由 listen 决定 |
server_name example.com/; |
错误 | 路径不属于主机名 |
server_name .example.com; |
正确 | 泛域名,注意位置 |
多个域名共用一个站点配置时,直接在一条 server_name 后面空格分隔即可:
server {
listen 80;
server_name example.com www.example.com;
root /var/www/example;
}
如果域名数量多、又分散在不同业务里,更推荐按业务拆文件,用 include /etc/nginx/conf.d/.conf; 引入,改一个站点不用翻整份主配置。
泛域名和正则别乱用
.example.com 覆盖 a.example.com、b.example.com,但不覆盖 example.com 本身,也不覆盖多级子域 a.b.example.com,很多人在这一步踩坑,以为写了泛域名就完事了,正则匹配要写成 ~^www\d+\.example\.com$,并注意正则是按配置文件出现顺序取第一个命中的。
匹配优先级决定了谁先被选中
同一个端口上可能有多个 server 块都"看起来"能匹配请求,实际只有一个生效,Nginx 官方文档给出的顺序是:
- 精确名字,如
www.example.com - 以星号开头的最长通配符,如
.example.com - 以星号结尾的最长通配符,如
www.example. - 第一个匹配的正则表达式(按配置出现顺序)
default_server;没有指定时,取该端口上第一个server块
行业共识认为,绝大多数"域名指向了错误的站点"的故障,都出在第 5 条上主配置或某个后来引入的 conf.d 文件里,先声明的 server 块悄悄成了默认站点,把一个不相关的域名接了过去,所以养成习惯:给默认站点单独写一个块,显式加上 default_server,返回 444 或 301。
server {
listen 80 default_server;
server_name _;
return 444;
}
nginx 不同域名指向不同端口配置方法
这是实际工作里问得最多的一类需求:一台服务器上跑着官网、后台、接口三个服务,分别监听 3000、8080、9000,但用户只想通过域名访问,有两种做法,选哪种取决于你是否愿意把后端端口暴露出去。
每个端口各写一个 server 块
server {
listen 3000;
server_name www.example.com;
root /var/www/site;
}
server {
listen 8080;
server_name admin.example.com;
root /var/www/admin;
}
统一走 80/443,按域名反代到后端端口
server {
listen 80;
server_name www.example.com;
location / {
proxy_pass http://127.0.0.1:3000;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
}
}
server {
listen 80;
server_name admin.example.com;
location / {
proxy_pass http://127.0.0.1:8080;
proxy_set_header Host $host;
}
}
两种方案的差别很明确:
- 方案一改端口就要改用户访问的地址,只适合内网或调试环境
- 方案二用户始终访问 80/443,后端端口随便变,这是生产环境的主流做法
- 方案二里
proxy_set_header Host $host;不能省,否则后端拿到的 Host 是0.0.1:3000,做签名校验或生成绝对链接的框架会直接出问题 - 后端如果是 WebSocket,还要补
proxy_http_version 1.1;和Upgrade、Connection两个头部
域名带端口访问怎么配置
有些场景就是要让用户访问 example.com:8080,比如测试环境、某些管理后台、容器映射出来的服务,这时候 listen 8080;,server_name 照样只写域名:
server {
listen 8080;
server_name example.com;
}
用户访问 http://example.com:8080 即可,业内专家指出,带端口访问在搜索引擎收录和外部链接分享中体验很差,正式对外站点应该尽量避免,更推荐用子域名代替端口,例如把 blog.example.com:8080 改成 blog.example.com。
端口前面的三道门槛:listen、防火墙、安全组
配置无误却访问不通,问题通常不在 Nginx。
第一道是 listen 绑定地址。 listen 8080; 等价于 listen :8080;,监听所有网卡;写成 listen 127.0.0.1:8080; 就只有本机能访问,云服务器上如果只绑了回环地址,外网无论如何都连不上。
第二道是系统防火墙。 CentOS 系用 firewall-cmd --add-port=8080/tcp --permanent 后 --reload;Ubuntu 系用 ufw allow 8080/tcp。
第三道是云厂商的安全组。 这一层在操作系统之外,iptables 看是通的,访问照样超时。
排查顺序建议固定下来,能省大量时间:
ss -lntp | grep nginx # 端口是否真的监听 curl -I http://127.0.0.1:8080 # 本机能不能通 curl -I -H "Host: example.com" http://127.0.0.1 # server_name 是否命中 nginx -T | grep -n "server_name" # 看实际加载的完整配置 tail -f /var/log/nginx/error.log
nginx -T 比 nginx -t 更有用前者会把合并后的完整配置打印出来,能直接看出 include 的顺序和你以为的是不是一致。curl -H "Host: ..." 则是验证域名匹配最快的办法,不用改 hosts、不用换浏览器。
改完配置后必须做的几步验证
- 执行
nginx -t,语法通过再热加载 - 热加载用
systemctl reload nginx或nginx -s reload,不要用 restart,restart 会让正在处理的请求直接断开 - 用
curl -I分别带不同 Host 头测一遍,确认每个域名落到对应的server块 - 检查 301 跳转是否把端口写进了
Location,return 301 https://$host$request_uri;里$host不含端口,这是对的 - 有多台机器时,配置同步要跟着发布流程走,手工改单台是最常见的"配置漂移"来源
nginx配置域名时如何正确设置server_name和端口指向的常见疑问
Q:一个 server 块能写几个 server_name,有数量上限吗?
没有硬性上限,空格分隔写几十个都可以,但从可维护性考虑,同一站点的主域名、带 www 版本、常见旧域名放在一起就够了,业务差异大的域名应该拆成独立 server 块,否则后期改任何一处都要动整块配置。
Q:为什么域名明明配了,访问却跳到了别的站点?
九成是 default_server 的归属问题,先用 nginx -T | grep -B2 -A2 "listen" 看每个端口上谁是默认块,再确认你那段配置是否真的被 include 进来了、是否被后加载的文件覆盖。
Q:server_name 和 listen 到底谁决定端口?
端口完全由 listen 决定,server_name 只参与请求到达之后的主机匹配,把端口写进 server_name 不会报错,但也不会生效,请求仍然按 listen 的端口进来,再靠 Host 头去挑 server 块这也是为什么带端口的域名访问问题,最后都要回到 listen 和安全组上找原因。
把这两件事分清:listen 管"从哪个门进来",server_name 管"进来之后找谁",配置里的绝大多数疑难,都能顺着这条线捋清楚。