Docker部署Next.js至OCI Ubuntu服务器后重定向至本地localhost求助

开发者阿泽

2026-7-1

解决Next.js Docker部署后重定向至localhost的问题

问题背景

使用Next.js官方提供的Dockerfile构建镜像，部署到OCI Ubuntu服务器后，容器正常运行且已暴露3000端口，但访问服务器公网IP时，页面会自动重定向至localhost，无法正常访问服务。

核心原因

Next.js应用内部的重定向逻辑或基础URL配置未适配服务器公网地址，导致生成的重定向链接指向本地localhost而非服务器公网IP/域名。

解决步骤

1. 配置Next.js基础URL环境变量

在项目根目录的next.config.js中添加公网地址环境变量，确保应用生成的链接使用正确的服务器地址：

/** @type {import('next').NextConfig} */
const nextConfig = {
  output: 'standalone', // 与Dockerfile中的standalone输出模式匹配
  env: {
    NEXT_PUBLIC_URL: 'http://你的服务器公网IP:3000', // 替换为实际公网IP或域名
  },
}

module.exports = nextConfig

2. 检查并修正应用内的重定向代码

排查项目中所有重定向、路由跳转逻辑，避免硬编码localhost：

错误示例：

// 硬编码localhost导致重定向错误
redirect('http://localhost:3000/dashboard')

正确写法：

// 使用相对路径（推荐）
redirect('/dashboard')

// 或使用环境变量拼接地址
import process from 'process'
redirect(`${process.env.NEXT_PUBLIC_URL}/dashboard`)

3. 重新构建并部署镜像

修改配置后，重新构建Docker镜像并启动容器：

# 重新构建镜像
docker build -t next-app .

# 停止并清理旧容器（若存在）
docker stop next-app-container && docker rm next-app-container

# 启动新容器，映射端口
docker run -d -p 3000:3000 --name next-app-container next-app