宝塔面板不直接管理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（如 <link rel="canonical">、跳转地址）。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 友好链接和第三方登录回调大概率失败。
