Docker中运行Next.js使用非3000端口失效问题排查与解决

我有一个Next.js项目，希望将其运行在8080端口（而非默认的3000端口）。本地执行命令next dev -p 8080时，可通过localhost:8080正常访问，但在Docker容器中却无法实现该效果。

相关配置 #

Dockerfile内容

# 使用官方Node.js 18镜像作为基础
# 构建阶段
FROM node:18-alpine AS build
WORKDIR /app/
COPY ./nextjs/package.json ./nextjs/package-lock.json ./
RUN npm install
COPY ./nextjs .
RUN npm run build

# 运行阶段
FROM node:18-alpine
WORKDIR /app/
ENV NEXT_TELEMETRY_DISABLED 1
ENV NODE_ENV production

# 仅从构建镜像复制已构建的应用
COPY --from=build /app/public ./public
COPY --from=build /app/package.json ./package.json
COPY --from=build /app/.next ./.next
COPY --from=build /app/node_modules ./node_modules

EXPOSE 8080
ENV PORT 8080
CMD ["npm", "run", "start"]

package.json脚本命令

"scripts": {
    "dev": "next dev -p 8080",
    "build": "next build",
    "start": "next start -p 8080",
    "lint": "next lint"
}

补充信息 #

• 本地执行npx next dev -p 8080可正常通过localhost:8080访问项目
• 所有配置改用3000端口时（包括Dockerfile的EXPOSE和ENV），Docker运行正常
• 本地执行npx next start -p 8080也能正常访问页面

使用的Docker命令 #

docker build -t demo-nextjs:$(TAG) -f Dockerfile.nextjs .
docker run -it demo-nextjs:$(TAG)

仅在Docker容器中使用非3000端口时出现访问问题，请问原因是什么？如何解决？

原因分析 #

核心问题是Docker端口未做映射：

• EXPOSE 8080只是镜像的声明性指令，仅用于说明容器内服务监听的端口，不会自动将容器端口映射到宿主机端口。
• 之前用3000端口正常，大概率是当时的docker run命令加了-p 3000:3000映射参数，而这次改用8080端口时遗漏了该参数，导致宿主机无法访问容器内的8080端口。
• 你的Next.js配置本身没有问题：start脚本指定-p 8080、Dockerfile设置ENV PORT 8080，确保了容器内的服务确实在监听8080端口，但宿主机和容器网络隔离，必须显式映射才能打通。

解决方法 #

修改docker run命令，添加端口映射参数-p 8080:8080，将宿主机的8080端口与容器内的8080端口绑定：

docker run -it -p 8080:8080 demo-nextjs:$(TAG)

如果想使用宿主机的其他端口（比如9090）访问容器服务，可调整为：

docker run -it -p 9090:8080 demo-nextjs:$(TAG)

执行修改后的命令后，即可通过localhost:8080（或你指定的宿主机端口）访问容器中的Next.js项目。

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