宝塔面板如何为Nuxt.js的服务端SSR项目配置持续长久运行_通过PM2启动程序并将其映射至外网真实域名

在文章实战开发的过程中，我们经常会遇到一些这样那样的问题，然后要卡好半天，等问题解决了才发现原来一些细节知识点还是没有掌握好。今天golang学习网就整理分享《宝塔面板如何为Nuxt.js的服务端SSR项目配置持续长久运行_通过PM2启动程序并将其映射至外网真实域名》，聊聊，希望可以帮助到正在努力赚钱的你。

宝塔面板不直接管理Nuxt.js SSR进程，须用PM2启动守护.output/server/index.mjs并配置NUXT_HOST=0.0.0.0和NODE_ENV=production，再通过Nginx反向代理（含X-Forwarded-Proto等关键头）对外提供服务，缺任一环节将导致进程退出或无法访问。

宝塔面板本身不直接管理 Nuxt.js 的 SSR 进程，必须靠 PM2 启动并守护 nuxt start（或 node .output/server/index.mjs），再用 Nginx 反向代理把域名流量导过去。漏掉任一环节，服务都会在终端关闭后退出，或无法被外网访问。

确认 Nuxt 项目已构建为 SSR 模式并生成 .output 目录

Nuxt 3 默认使用 nitro 构建器，SSR 输出路径是 .output，不是旧版的 .nuxt/dist/server。运行前必须先执行构建命令：

• nuxt build（开发机上执行，生成 .output）
• 上传整个项目目录（含 .output、package.json、nuxt.config.ts）到服务器，例如 /www/wwwroot/my-nuxt-app
• 确保服务器已安装 Node.js（≥18.12.0）且版本与本地开发一致，否则 .output/server/index.mjs 可能因 ESM 语法报错
• 不要上传 node_modules —— 宝塔的 PM2 管理器会自动根据 package.json 安装依赖，但需手动勾选“安装依赖”选项

用宝塔 PM2 管理器启动并守护 Nuxt SSR 进程

宝塔的 PM2 插件只是 UI 封装，底层仍调用 pm2 start。关键在于入口文件和环境变量：

• 在 PM2 管理器中，“应用路径”填 /www/wwwroot/my-nuxt-app（项目根目录，不是 .output）
• “启动脚本”填 .output/server/index.mjs（Nuxt 3.9+ 的标准 SSR 入口）
• 务必在“环境变量”栏添加：NODE_ENV=production 和 NUXT_HOST=0.0.0.0（否则默认只监听 127.0.0.1，PM2 启动后外部无法连通）
• “实例数”建议设为 1（SSR 不适合多进程共享端口，交由 Nginx 做负载）
• 启动后检查 PM2 日志：若报 ERR! Cannot find module 'vue'，说明 node_modules 缺失或未正确安装，需进终端手动 cd /www/wwwroot/my-nuxt-app && npm ci --omit=dev

Nginx 配置反向代理时必须透传 Host 和协议头

Nuxt SSR 依赖正确的 Host 和 X-Forwarded-Proto 头来生成绝对 URL（如 、跳转地址）。Nginx 默认不转发这些，会导致页面资源 404 或重定向循环：

• 在网站配置的「配置文件」中，定位到 location / { ... } 块
• 替换为以下内容（注意端口要和 .output/server/options.mjs 中的 port 一致，默认是 3000）：

location / {
  proxy_pass http://127.0.0.1:3000;
  proxy_http_version 1.1;
  proxy_set_header Host $host;
  proxy_set_header X-Real-IP $remote_addr;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header X-Forwarded-Proto $scheme;
  proxy_set_header Upgrade $http_upgrade;
  proxy_set_header Connection "upgrade";
}

• 删掉所有其他 location 规则（比如旧的 PHP 或静态文件规则），避免冲突
• 保存后点击「重载配置」，不要只点「保存」——否则 Nginx 不会生效

域名解析与 HTTPS 必须与 SSR 行为对齐

Nuxt 在 SSR 阶段就生成 HTML，如果域名解析未生效或 HTTPS 强制跳转配置不当，用户会看到空白页或混合内容警告：

• 确保域名已解析到服务器 IP，且宝塔「网站」列表里该站点状态为「已启动」
• 申请 SSL 证书时勾选「强制 HTTPS」，但必须等 Nginx 配置生效、PM2 进程稳定运行后再启用——否则 301 跳转会把健康检查请求也重定向，导致 PM2 误判进程异常
• 若使用泛域名（如 *.example.com），Nuxt 配置中需显式设置 app.baseURL = 'https://example.com'，否则 useRouter().currentRoute.value.fullPath 可能返回错误路径
• 检查浏览器开发者工具 Network 标签页：首屏 HTML 返回状态码应为 200，且响应头含 x-powered-by: Nitro，而非 x-powered-by: Express（后者说明你误用了开发服务器 nuxt dev）

最常被忽略的是 NUXT_HOST=0.0.0.0 和 proxy_set_header X-Forwarded-Proto 这两项。前者让进程监听所有网卡，后者让 Nuxt 知道当前是 HTTPS 请求——缺一不可，否则 SEO 友好链接和第三方登录回调大概率失败。

好了，本文到此结束，带大家了解了《宝塔面板如何为Nuxt.js的服务端SSR项目配置持续长久运行_通过PM2启动程序并将其映射至外网真实域名》，希望本文对你有所帮助！关注golang学习网公众号，给大家分享更多文章知识！