Nginx 怎么在 Nginx 中配置多端口统一启用 HTTPS 虚拟主机服务-Nginx-PHP中文网

nginx 不支持多端口统一启用 https，必须为每个 listen 指令显式添加 ssl 参数并绑定对应证书；可通过 include 复用 common 和 ssl-common 配置实现多端口 https 共享逻辑。

nginx 怎么在 nginx 中配置多端口统一启用 https 虚拟主机服务

Nginx 本身不支持“多端口统一启用 HTTPS”的抽象操作——HTTPS 是基于 SSL/TLS 的协议，必须为每个 listen 指令显式启用 ssl 参数，并绑定对应的证书。但你可以通过合理组织配置，实现在多个端口上分别启用 HTTPS，同时共享同一套虚拟主机逻辑（如复用 location、反向代理规则等），避免重复写配置。

关键在于：HTTPS 必须按端口+域名组合独立配置，不能跨端口共用一套证书或监听声明。

明确支持的 HTTPS 多端口方式

Nginx 允许你为不同端口（如 443、8443、8083）各自定义 listen ... ssl 的 server 块，每个块可服务相同或不同的域名，只要证书匹配即可：

# 端口 443（标准 HTTPS）
server {
    listen 443 ssl;
    server_name example.com;
    ssl_certificate /path/to/example.com.crt;
    ssl_certificate_key /path/to/example.com.key;
    root /var/www/example;
    index index.html;
}

# 端口 8443（非标 HTTPS）
server {
    listen 8443 ssl;
    server_name example.com;
    ssl_certificate /path/to/example.com.crt;   # 可复用同一证书
    ssl_certificate_key /path/to/example.com.key;
    root /var/www/example;
    index index.html;
}

# 端口 8083（另一个 HTTPS 端口）
server {
    listen 8083 ssl http2;  # 支持 HTTP/2
    server_name example.com;
    ssl_certificate /path/to/example.com.crt;
    ssl_certificate_key /path/to/example.com.key;
    # 可复用相同 root 和 location，也可差异化配置
    location /api {
        proxy_pass http://localhost:3001;
    }
}

✅ 这样就实现了「多个端口都启用 HTTPS」，且都指向同一个域名和站点内容（或按需分流）。

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

如何避免配置重复？用 include + 变量简化

把通用逻辑（如 root、index、常用 location、SSL 参数）抽离到单独文件，再用 include 引入：

创建 /nginx/conf.d/common.conf：

root /var/www/example;
index index.html;
location / {
  try_files $uri $uri/ =404;
}
location /static {
  alias /var/www/example/static/;
}

创建 /nginx/conf.d/ssl-common.conf（复用的 SSL 设置）：

ssl_protocols TLSv1.2 TLSv1.3;
ssl_ciphers ECDHE-ECDSA-AES128-GCM-SHA256:ECDHE-RSA-AES128-GCM-SHA256;
ssl_prefer_server_ciphers off;
ssl_session_cache shared:SSL:10m;
ssl_session_timeout 10m;

在各 server 块中引用：

server {
  listen 443 ssl;
  server_name example.com;
  ssl_certificate /certs/example.com.crt;
  ssl_certificate_key /certs/example.com.key;
  include /nginx/conf.d/common.conf;
  include /nginx/conf.d/ssl-common.conf;
}

server { listen 8443 ssl; server_name example.com; ssl_certificate /certs/example.com.crt; ssl_certificate_key /certs/example.com.key; include /nginx/conf.d/common.conf; include /nginx/conf.d/ssl-common.conf; }


这样既保持多端口 HTTPS 独立性，又大幅减少重复。

---

### <strong>注意：不能“统一启用”的常见误区</strong>

- ❌ 不能写 `listen 443 ssl; listen 8443 ssl;` 在同一个 `server` 块里 —— Nginx 不允许一个 `server` 监听多个 HTTPS 端口（会报错：`"ssl" parameter cannot be used with multiple listen options`）。
- ❌ 不能只配一次证书然后“全局生效”——每个 `listen ... ssl` 都必须显式指定 `ssl_certificate` 和 `ssl_certificate_key`。
- ❌ 不同端口若服务不同域名（如 `admin.example.com:8443` 和 `api.example.com:8083`），证书必须覆盖对应域名（SAN 或通配符证书更灵活）。

---

### <strong>实际部署建议</strong>

- 生产环境推荐主用 443（标准 HTTPS），其他端口仅用于特定场景（如内网调试、灰度发布、容器健康检查等）；
- 若需对外暴露多个 HTTPS 端口，务必在防火墙/安全组中放行对应端口；
- 使用通配符证书（`*.example.com`）或 SAN 证书，可让同一张证书适配多个子域名 + 多端口；
- 每次修改后运行 `nginx -t` 测试语法，再 `nginx -s reload` 生效。

不复杂但容易忽略细节。