如何在Nginx中复用同一address:port对的listen参数？

你可以通过创建一个全局默认的Nginx Server块来一次性指定0.0.0.0:443的ssl、http2、reuseport参数，所有业务站点的配置无需再重复这些参数，完美适配Ansible单模板部署的需求。

步骤1：创建全局默认配置文件 #

在/etc/nginx/conf.d/目录下新建一个文件（比如global-443-config.conf），内容如下：

server {
    # 一次性指定所有需要的监听参数，并设置为默认server
    listen 443 ssl http2 reuseport default_server;
    listen [::]:443 ssl http2 reuseport default_server;
    server_name _; # 匹配所有未被其他server块匹配的请求

    # 配置占位SSL证书（防止Nginx启动报错，不影响业务站点）
    # 可以用自签证书，或者通配符证书（如果所有站点共用的话）
    ssl_certificate /etc/nginx/ssl/placeholder.crt;
    ssl_certificate_key /etc/nginx/ssl/placeholder.key;

    # 访问未匹配域名时直接关闭连接
    return 444;
}

步骤2：修改Ansible站点模板 #

将原来的站点模板简化为：

# 部署在/etc/nginx/sites-available/{{ domain }}.conf并软链至sites-enabled
server {
    # 仅监听443，无需重复参数
    listen 443;
    listen [::]:443;
    server_name {{ domain }};

    # 站点专属配置：SSL证书、根目录、反向代理等
    ssl_certificate /path/to/{{ domain }}.crt;
    ssl_certificate_key /path/to/{{ domain }}.key;

    ...
}

为什么这个方法可行？ #

根据Nginx的机制：

• 同一address:port组合的监听参数（如ssl、http2、reuseport）只需在一个Server块中指定一次，Nginx会为该端口初始化对应的套接字。
• 其他监听同一端口的Server块会复用这个套接字，自动继承其参数特性，无需重复声明。
• 默认Server块始终存在，不会因为移除某个业务站点导致监听参数失效，彻底解决了你的顾虑。

补充说明 #

• 占位SSL证书可以用openssl快速生成：

  mkdir -p /etc/nginx/ssl
  openssl req -x509 -nodes -days 3650 -newkey rsa:2048 -keyout /etc/nginx/ssl/placeholder.key -out /etc/nginx/ssl/placeholder.crt -subj "/CN=placeholder.local"
  

• 如果所有站点共用通配符证书，也可以把SSL证书配置在全局http块中，进一步简化站点模板。

内容的提问来源于stack exchange，提问作者bfontaine