Node.js、Next.js 和 Nuxt 应用。
Node.js 项目的识别和启动方式:Node 版本、包管理器、Next.js 和 Nuxt(服务端或静态)、SvelteKit、Astro、Express 等,PORT 变量和 Prisma 迁移。
包含 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 服务运行——请参阅项目服务。