Linux 环境下运行 Next.js 最全指南-linux运维-PHP中文网

Linux 环境下运行 Next.js 最全指南

舞夢輝影

发布： 2025-12-04 20:48:07

原创

504人浏览过

答案：本文详细介绍在Linux环境下部署Next.js应用的完整流程，1. 更新系统并使用nvm安装Node.js；2. 通过create-next-app创建或克隆项目；3. 开发模式下运行并配置HOST=0.0.0.0支持局域网访问；4. 使用npm run build构建并npm start启动生产服务；5. 安装PM2实现进程守护与开机自启；6. 配置Nginx反向代理以域名访问；7. 使用Certbot免费配置HTTPS；8. 排查端口占用、权限、静态资源404等问题。强调环境稳定与细节配置如代理头设置，确保部署顺利。

linux 环境下运行 next.js 最全指南

在 Linux 环境下运行 Next.js 应用并不复杂，只要正确配置 Node.js 环境并掌握部署流程，无论是开发调试还是生产部署都能顺利进行。本文将一步步带你完成从环境准备到项目上线的全过程。

1. 准备 Linux 开发环境

确保你的 Linux 系统已安装必要的工具和依赖：

更新系统包：使用 sudo apt update && sudo apt upgrade（Debian/Ubuntu）或对应发行版命令
安装 Node.js：推荐使用 nvm 管理版本
安装 npm 或 yarn：Node.js 安装后自动包含 npm，也可额外安装 yarn 提升体验

通过 nvm 安装 Node.js 示例：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 18 # 推荐 LTS 版本
node -v # 验证安装

2. 创建或导入 Next.js 项目

如果你是新建项目，可以直接使用 create-next-app：

npx create-next-app@latest my-nextjs-app
cd my-nextjs-app

如果已有项目，克隆代码即可：

git clone https://your-repo-url.git
cd your-project-name
npm install

安装依赖时若遇到权限问题，避免使用 sudo，建议修复 npm 权限或改用 nvm 管理 Node。

3. 开发模式运行

启动开发服务器，默认监听 localhost:3000：

npm run dev

如需让其他设备访问（例如局域网调试），修改 next.config.js：

module.exports = {
  reactStrictMode: true,
  async redirects() {
    return [];
  }
};

// 添加自定义服务器配置（可选）

然后启动时绑定 0.0.0.0：

HOST=0.0.0.0 npm run dev

现在可通过 http://你的服务器IP:3000 访问开发页面。

4. 构建与生产部署

生产环境不建议直接用 dev 模式。应先构建再启动：

npm run build
npm start

构建会生成 .next 目录，start 命令启动的是基于 production mode 的服务器，性能更优。

WebService开发指南中文WORD版

本文档主要讲述的是WebService开发指南；WebService针对软件开发和系统集成商提供移动商务的接入WebService具有稳定、跨平台、跨开发语言、穿透防火墙等特点因此深受企业开发亲睐。适应 WEB、VB 、Delphi、.NET、VC 、 JAVA 等多种主流开发语言及 Windows 、Linux 、Unix 等运行环境的短信通讯开发接口，让企业的 OA 、CRM 、ERP 、SCM 等系统快速、轻松实现移动商务应用。希望本文档会给有需要的朋友带来帮助；感兴趣的朋友可以过来看看

查看详情

若想自定义端口：

PORT=4000 npm start

5. 使用 PM2 守护进程管理应用

为防止终端关闭导致服务中断，推荐使用 PM2：

npm install -g pm2
pm2 start "npm start" --name "my-nextjs" -- cwd=/path/to/your/app
pm2 startup # 设置开机自启
pm2 save

常用 PM2 命令：

pm2 logs my-nextjs —— 查看日志
pm2 restart my-nextjs —— 重启服务
pm2 list —— 查看运行进程

6. 配合 Nginx 反向代理（推荐用于生产）

安装 Nginx：

sudo apt install nginx

配置反向代理，编辑站点文件（如 /etc/nginx/sites-available/default）：

server {
listen 80;
server_name example.com;

  location / {
    proxy_pass https://www.php.cn/link/92cdc3666b7883ebeed2973e70725bb1;
    proxy_http_version 1.1;
    proxy_set_header Upgrade \$http_upgrade;
    proxy_set_header Connection 'upgrade';
    proxy_set_header Host \$host;
    proxy_set_header X-Real-IP \$remote_addr;
    proxy_set_header X-Forwarded-Proto \$scheme;
    proxy_set_header X-Forwarded-For \$proxy_add_x_forwarded_for;
    proxy_cache_bypass \$http_upgrade;
  }
}

测试配置并重启 Nginx：

sudo nginx -t
sudo systemctl reload nginx

此时可通过域名或 IP 直接访问 Next.js 应用。