Nuxt 的部署方式非常灵活,这得益于其底层的 Nitro 服务器引擎。你可以选择传统的 Node.js 服务器渲染 (SSR)、静态站点生成 (SSG),也可以部署到现代化的 Serverless / Edge 平台或 Docker 容器中。下面根据不同的部署模式来梳理具体操作。

🖥️ 模式一:Node.js 服务器部署 (SSR / 默认模式)
这是 Nuxt 的默认部署方式,适合需要服务端渲染 (SSR) 或服务端 API 路由的应用。
1. 构建与启动
在项目根目录运行构建命令,会生成一个自包含的 .output 目录。
bash
npm run build
# 或 yarn build / pnpm build启动生产服务器:
bash
NODE_ENV=production node .output/server/index.mjs服务器默认监听 3000 端口。务必设置 NODE_ENV=production,否则 Vue Router 等依赖可能会在日志中输出大量开发警告。
2. 关键环境变量
你可以通过环境变量调整服务器行为:
- 端口:PORT 或 NITRO_PORT(默认 3000)
- 主机:HOST 或 NITRO_HOST(默认 0.0.0.0)
在生产环境中,通常建议不要直接在 Nitro 中启用 HTTPS,而是将应用运行在 Nginx 或 Cloudflare 等反向代理之后,由代理层来处理 SSL 终止。
3. 使用 PM2 进行进程管理
在 VPS 或独立服务器上,推荐使用 PM2 来守护进程和实现负载均衡。创建一个 ecosystem.config.cjs 文件:
javascript
// ecosystem.config.cjs
module.exports = {
apps: [
{
name: 'NuxtAppName',
port: '3000',
exec_mode: 'cluster',
instances: 'max',
script: './.output/server/index.mjs',
env: {
NODE_ENV: 'production',
},
},
],
}然后通过 pm2 start ecosystem.config.cjs 启动。
如果想直接利用 Node.js 的集群模块,也可以在构建时设置 NITRO_PRESET=node_cluster。
4. 子路径部署
如果应用需要部署在非根路径下(例如 https://example.com/my-app/),应设置 app.baseURL 或环境变量 NUXT_APP_BASE_URL。
📄 模式二:静态站点生成 (SSG)
如果你的站点内容相对固定,不需要服务端实时逻辑,SSG 是最佳选择,可以将生成的静态文件托管在任何静态服务器或 CDN 上。
1. 生成静态文件
运行以下命令,Nitro 的爬虫会预渲染应用的所有路由:
bash
npx nuxi generate生成结果位于 .output/public/ 目录。你可以将此目录下的全部内容上传到 Nginx、GitHub Pages、Netlify、Vercel 等任意静态托管服务。
2. 注意事项nuxi generate 是 nuxt build --prerender 的便捷方式。如果你的 nuxt.config 中设置了 target: 'static'(Nuxt 2 写法)或相关静态预设,确保构建脚本使用的是 nuxi generate 而非 nuxt build。
☁️ 模式三:Serverless / Edge 平台 (Vercel / Netlify / Cloudflare)
这些平台与 Nuxt 的 Nitro 引擎深度集成,通常能实现零配置或极少配置的自动化部署。
Vercel
Vercel 对 Nuxt 的支持非常完善,nuxt build 是其推荐方式,因为它同时支持 SSR、SSG 和 ISR (增量静态再生)。
- 将代码推送到 Git 仓库(GitHub/GitLab/Bitbucket)。
- 在 Vercel 中导入项目,它会自动检测 Nuxt 并配置好构建设置。
- 或者使用 CLI:npm i -g vercel 后,在项目根目录运行 vercel 即可。你可以在 nuxt.config.ts 的 nitro.preset 中显式指定 'vercel',或通过 NITRO_PRESET=vercel 环境变量来构建。
Netlify
Netlify 同样会自动检测 Nuxt 项目。对于 Nuxt 3,它通常会自动将构建命令设为 nuxt build,发布目录设为 dist。
- CLI 部署:netlify deploy --prod
- Edge Functions:如需使用 Netlify Edge Functions,需设置环境变量 SERVER_PRESET=netlify_edge。
- pnpm 用户注意:如果使用 pnpm,需要设置环境变量 PNPM_FLAGS=--shamefully-hoist。
Cloudflare Pages
Cloudflare Pages 提供免费的无限带宽和优秀的边缘性能,适合对全球访问速度和成本敏感的项目。
构建时指定预设:
bash
NITRO_PRESET=cloudflare-pages nuxt build需要注意 Workers 环境存在 CPU 时间限制,且并非所有 Node.js API 都可用。
🐳 模式四:Docker 容器化部署
nuxt build 生成的 .output 目录是自包含的,这使得 Docker 镜像可以非常精简——运行时阶段甚至不需要 node_modules 或源码。
多阶段构建 Dockerfile 示例 (npm)
dockerfile
# ---- 构建阶段 ----
FROM node:24-alpine AS build
WORKDIR /app
COPY --link package.json package-lock.json ./
RUN npm ci
COPY --link . .
RUN npm run build
# ---- 运行阶段 ----
FROM node:24-alpine AS runtime
WORKDIR /app
ENV NODE_ENV=production
COPY --link --from=build /app/.output ./.output
USER node
EXPOSE 3000
CMD ["node", ".output/server/index.mjs"]将上述内容保存为 Dockerfile,即可构建并运行镜像。建议同时添加 .dockerignore 文件(至少包含 node_modules、.nuxt、.output),以避免将本地依赖复制进构建上下文。
⚙️ 通用配置与选择建议
统一预设配置
无论选择哪个平台,都可以在 nuxt.config.ts 中通过 nitro.preset 统一指定部署目标,或者使用环境变量 NITRO_PRESET。
typescript
export default defineNuxtConfig({
nitro: {
preset: 'vercel', // 或 'netlify', 'cloudflare-pages', 'node-server' 等
},
})如何选择?
- 需要完整 SSR / API 且希望完全掌控:Node.js 服务器(配合 PM2 + Nginx)。
- 纯内容站、文档、博客:静态生成 (SSG),成本最低,速度最快。
- 追求零配置、优秀的开发体验和预览部署:Vercel(尤其适合 SaaS 或营销站)。
- JAMstack、需要内置表单/身份验证:Netlify。
- 全球边缘性能、对带宽成本敏感:Cloudflare Pages。
- 需要容器化、已有 Kubernetes 或 Docker 基础设施:Docker 部署。

暂无评论