立即开始

Node.js、Next.js 和 Nuxt 应用。

Node.js 项目的识别和启动方式:Node 版本、包管理器、Next.js 和 Nuxt(服务端或静态)、SvelteKit、Astro、Express 等,PORT 变量和 Prisma 迁移。

1 分钟阅读

包含 package.json 的仓库即为 Node.js 项目。我们会自动选择框架、包管理器和 Node 版本,完成构建和启动——您只需推送代码。

Node 版本和包管理器

  • Node.js——取自 package.json 中的 engines.node 或 .nvmrc:在 24、22、20、18 和 16 中选择符合要求的最新版本。两者都没有时,使用 Node.js 22。
  • 包管理器——根据锁文件判断:pnpm-lock.yaml → pnpm,yarn.lock → yarn,否则使用 npm(有 package-lock.json 时执行 npm ci)。
  • 构建——package.json 中有 build 脚本时执行该脚本。

框架

框架运行方式
Next.js作为服务器运行(next start)——服务端渲染、API 路由和中间件照常工作
Next.js,使用 output: 'export'作为静态网站,从 out 提供
Nuxt作为服务器运行(.output/server/index.mjs)
Nuxt,使用 ssr: false 和 generate 脚本作为静态网站,从 .output/public 提供
SvelteKit使用 adapter-node 时作为服务器运行;使用 adapter-static 时作为静态网站
Astro作为静态网站;使用 @astrojs/node 时作为服务器运行
NestJS构建后运行 dist/main.js
Express、Fastify、Koa、Hono 及其他服务器运行 scripts.start 中的文件(node server.js),否则为 main,再否则为 server.js、app.js、index.js 或 main.js

纯前端项目——Vite、Create React App、Angular、Vue CLI 等——作为静态网站提供;请参阅静态网站。

监听 PORT

服务器必须在所有网络接口上监听 PORT 变量中的端口:

const port = process.env.PORT || 3000
app.listen(port, '0.0.0.0')

Next.js 和 Nuxt 会自动完成这一点。如果您的应用监听固定端口,将无法接收访问——部署会在启动检查时停止,上一版本继续运行。

构建时的值

变量 标签页中的变量会传递给运行中的应用,而不是构建过程。构建时写入客户端代码的值——例如 Next.js 中的 NEXT_PUBLIC_… 或 VITE_…——从您的仓库读取,例如从已提交的 .env.production 文件中读取。服务端代码照常读取 变量 标签页。

自定义启动命令

如果自动识别的启动方式不符合需要,请设置 设置 → 构建设置 → 启动命令,例如 node dist/server.js 或 npm run start:prod。安装和构建命令也可以在此修改。

数据库和 Prisma

向项目添加 PostgreSQL 或 MySQL,并读取 DATABASE_URL——该变量会自动设置。依赖中包含 Prisma 时,推荐的 发布命令 是 npx prisma migrate deploy:它在每次部署时、新版本接收访问之前运行。请参阅部署。

如需使用 BullMQ 队列,请添加 Valkey 并使用 REDIS_URL。将队列 Worker 作为 后台 Worker 运行——在 进程 标签页中,或作为拥有独立资源的单独服务。请参阅项目服务。

部署后保留的文件

每次部署都从仓库的全新副本开始。应用写入 /data 的文件会在部署之间保留并每日备份;写入其他位置的内容在下一次部署后会丢失。对于上传文件和媒体,通常更适合使用对象存储。

Monorepo

对于包含多个项目的仓库,请在创建应用时设置 项目文件夹(例如 apps/web)。同一仓库的其他文件夹可以作为单独的 Web 服务运行——请参阅项目服务。

还有疑问?

和我们聊聊——AI 即时回答,需要时工程师加入,全天候在线。

联系技术支持