服务器与大带宽专家 · 持牌IDC/CDN/ISP服务商
简米科技官网JIANMI TECH
资讯 2026-11-17 简米科技 4,585 字 11 分钟阅读

Nginx域名server_name和端口怎么设置?server_name端口指向怎么配

导读Nginx 配置域名时,server_name 只写域名本身——不带 http://、不带端口、不带路径;端口只由 listen 指令决定,一个 listen 端口搭配一组 server_name 构成一个虚拟主机,想让不同域名指向不同服务端口,要么给每个端口单独写 server 块,要么在同一个 80/443……

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 官方文档给出的顺序是:

  1. 精确名字,如 www.example.com
  2. 以星号开头的最长通配符,如 .example.com
  3. 以星号结尾的最长通配符,如 www.example.
  4. 第一个匹配的正则表达式(按配置出现顺序)
  5. 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 管"进来之后找谁",配置里的绝大多数疑难,都能顺着这条线捋清楚。

分享本文
本文为 简米科技官网 原创,已由运维技术专家审核。转载请注明来源:原文链接
售前咨询 服务热线 售后 邮箱