Docker容器内NextJS自定义HTTPS服务器异常转为HTTP服务问题

背景 #

我用NextJS和Docker搭建网站，通过npx create-next-app初始化项目，基于Vercel官方Dockerfile（稍作修改）做容器化。为了无需配置代理直接启用SSL，搭建了自定义HTTPS服务器。

问题现象 #

• 容器外运行时，服务器正常提供HTTPS服务，无法通过HTTP访问
• 容器化后，HTTPS访问报SSL_ERROR_RX_RECORD_TOO_LONG错误，但能通过HTTP访问，推测容器内服务器自动转为HTTP服务（代码无修改）
• 容器内日志无法看到自定义的console.log输出，仅能看到第三方库的日志：Listening on port 3000 url: http://localhost:3000，调试困难

已尝试的调试步骤 #

• 检查httpsOptions中的key和cert文件，未发现问题
• 将Docker基础镜像从node:alpine-16改为node:latest，无效果

自定义服务器代码 #

const https = require('https');
const fs = require('fs');
const { parse } = require('url');
const next = require('next');

const dev = process.env.NODE_ENV !== 'production';
const hostname = "127.0.0.1";
const port = process.env.PORT || 3000
const app = next({ dev, hostname, port })
const handle = app.getRequestHandler()

const httpsOptions = {
    key: fs.readFileSync('./cert/privkey.pem'),
    cert: fs.readFileSync('./cert/fullchain.pem')
};


app.prepare().then(() => {
    https.createServer(httpsOptions, async (req, res) => { // 容器内运行时这里似乎创建的是HTTP服务器而非HTTPS
        const parsedUrl = parse(req.url, true)
        const { pathname, query } = parsedUrl

        await handle(req, res, parsedUrl)
    }).listen(port, (err) => {
        if(err) throw err
        console.log(`Ready on https://localhost:${port}`)
    })
})

问题1：容器内HTTPS转HTTP的解决 #

核心原因是Dockerfile大概率启动的是NextJS默认开发服务器，而非你的自定义HTTPS服务器。

解决步骤：

1. 修改package.json脚本，指定启动自定义服务器（假设你的服务器文件是server.js）：

   "scripts": {
     "dev": "node server.js",
     "build": "next build",
     "start": "node server.js"
   }
   

2. 调整Dockerfile中的启动指令，确保使用修改后的脚本：

   CMD ["npm", "run", "dev"]
   

3. 确认容器内证书路径正确：在Dockerfile中添加证书复制指令，避免相对路径问题：

   COPY ./cert /app/cert
   

   同步修改代码中的证书路径：

   key: fs.readFileSync('/app/cert/privkey.pem'),
   cert: fs.readFileSync('/app/cert/fullchain.pem')
   

问题2：容器日志看不到console.log的解决 #

NextJS在部分模式下会拦截日志输出，或Docker存在输出缓冲问题，解决方法：

1. 启动时强制指定环境变量，让日志输出到标准输出：

   ENV NODE_ENV=development
   CMD ["node", "server.js"]
   

   或在package.json脚本中配置：

   "dev": "NODE_ENV=development node server.js"
   

2. 生产模式下，确保自定义服务器的console.log直接指向process.stdout，规避NextJS的日志拦截。

额外注意点 #

• 容器端口映射时，确保映射的是自定义服务器监听的端口（默认3000），不要混淆HTTP/HTTPS端口
• 本地测试容器HTTPS时，浏览器会提示证书不安全，需手动信任本地生成的证书

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