如何在生产环境中以HTTPS方式启动Next.js应用？

问题核心 #

--experimental-https是仅针对开发模式（next dev）的实验性参数，生产模式的next start并不支持该选项，因此会抛出error: unknown option '--experimental-https'错误。

基于现有Nginx代理的正确配置方案 #

你已经配置了支持HTTPS的Nginx，这是生产环境最合理的部署方式，无需让Next.js直接监听HTTPS端口，只需完成以下两步配置即可满足crypto模块的secureContext要求：

1. 确保Nginx的HTTPS反向代理配置正确 #

让Nginx处理SSL证书，将外部HTTPS请求转发到Next.js的HTTP端口（默认3000），示例配置片段：

server {
    listen 443 ssl;
    server_name your-domain.com;

    ssl_certificate /path/to/your/cert.pem;
    ssl_certificate_key /path/to/your/key.pem;

    location / {
        proxy_pass http://localhost: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;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

2. 配置Next.js信任代理并识别HTTPS环境 #

在next.config.js中添加配置，让Next.js识别到请求是通过HTTPS代理转发的，确保secureContext生效：

module.exports = {
    // 标记信任代理，让Next.js认可X-Forwarded-Proto头
    serverRuntimeConfig: {
        trustProxy: true,
    },
    // 或者直接强制设置X-Forwarded-Proto头为https
    async headers() {
        return [
            {
                source: '/(.*)',
                headers: [
                    { key: 'X-Forwarded-Proto', value: 'https' },
                ],
            },
        ];
    },
};

验证生效 #

直接运行next start启动生产服务（无需添加HTTPS相关参数），通过Nginx配置的HTTPS域名访问应用，此时crypto模块的secureContext会识别到当前为HTTPS环境，满足需求。

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