宝塔配置Nuxt.js项目：PM2启动+Nginx反代教程

本文详解了在宝塔面板上正确部署Nuxt.js服务端渲染（SSR）项目的完整闭环流程：必须摒弃静态部署思维，严格采用npm start启动服务、PM2守护进程保障稳定性、Nginx反向代理（务必指向127.0.0.1并启用WebSocket支持）暴露域名，同时关键配置缺一不可——nuxt.config.js中显式声明host: '0.0.0.0'、防火墙开放对应端口、上传时包含隐藏的.nuxt目录但坚决不传node_modules，并通过ecosystem.config.js精准控制PM2行为；任何环节疏漏（如误写localhost、漏配X-Forwarded-Proto、忽略首次请求才触发的运行时错误）都会导致访问失败或闪退，堪称一份踩坑无数后淬炼出的高可靠性部署指南。

直接上结论：Nuxt.js SSR 项目在宝塔面板上不能当静态文件部署，必须用 npm start 或 nuxt start 启动服务进程，再通过 PM2 守护 + Nginx 反向代理暴露到 80/443 端口。漏掉任一环，域名访问就会失败或闪退。

确认 Nuxt 启动端口并开放防火墙

Nuxt 默认监听 localhost:3000，但宝塔外网访问需要两步放开：

• nuxt.config.js 中必须显式配置 server: { host: '0.0.0.0', port: 3000 }（仅写 port 不够，host 缺失会导致只响应本地请求）
• 宝塔「安全」菜单里手动放行该端口（如 3000），否则即使 PM2 跑着，Nginx 也 proxy_pass 不通
• 若改了端口（比如 6666），记得同步改 package.json 的 start 脚本和 Nginx 配置里的 proxy_pass

上传文件时别漏掉隐藏目录和关键配置

只传 .nuxt、static、nuxt.config.js、package.json、package-lock.json 就够了 —— node_modules 不用传，反而容易因平台差异出错。

• .nuxt 是隐藏目录，Xftp / FileZilla 默认不显示，需开启「显示隐藏文件」才传得上去
• ecosystem.config.js 推荐手写（哪怕只配最简版），比宝塔 PM2 管理器自动识别更稳：

  module.exports = {
    apps: [{
      name: 'my-nuxt',
      script: 'npm',
      args: 'start',
      cwd: '/www/wwwroot/your-domain.com',
      env: { NODE_ENV: 'production' }
    }]
  }

• 别传 node_modules 或整个源码（尤其含 pages、components），SSR 模式下只有 .nuxt 是运行时必需的产物

Nginx 反向代理必须指向 127.0.0.1，不能写 localhost

宝塔「网站 → 反向代理」里填目标 URL 时，务必写 http://127.0.0.1:3000，写 http://localhost:3000 会静默失败 —— 这是 Nginx 在容器/非交互环境下的解析限制。

• 代理规则里要加 WebSocket 支持（尤其用了 middleware 或实时功能）：

  proxy_http_version 1.1;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";

• 如果用 HTTPS，Nginx 配置顶部需补 proxy_set_header X-Forwarded-Proto $scheme;，否则 Nuxt 的 req.headers.host 可能拿不到正确协议
• 别在站点配置文件里手动写 upstream 块，宝塔反向代理已自动生成，重复写反而冲突

PM2 启动后必须验证进程状态和日志

执行 pm2 start ecosystem.config.js 后，光看「在线」状态不够，得立刻查真实输出：

• 运行 pm2 logs my-nuxt，确认没报 EADDRINUSE（端口被占）或 Cannot find module（路径/依赖问题）
• 若日志卡在 Listening on http://0.0.0.0:3000 但浏览器打不开，先 curl -v http://127.0.0.1:3000 测本地连通性，排除 Nginx 层问题
• 用 pm2 restart my-nuxt 替代 stop+start，避免进程残留；重启后仍异常，就删掉 .nuxt 重 npm run build 再试

最常被忽略的是：Nuxt 的 server 配置必须写死 host: '0.0.0.0'，且 PM2 日志里看不到错误不等于没错误 —— 有些模块（如 @nuxtjs/firebase）会在首次请求时才抛错，得真用浏览器触发一次路由才能暴露。

理论要掌握，实操不能落！以上关于《宝塔配置Nuxt.js项目：PM2启动+Nginx反代教程》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！