Nuxt.js SSR项目在宝塔面板上必须通过npm start启动服务、PM2守护进程、Nginx反向代理（指向127.0.0.1）暴露端口，且nuxt.config.js需显式配置host:'0.0.0.0'并开放防火墙对应端口，缺一不可。
直接上结论：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）会在首次请求时才抛错，得真用浏览器触发一次路由才能暴露。
