SaasOne v2.0 Docs
三端通吃
2026-11-21·9 分钟

Workers 部署全指南

Cloudflare Workers (OpenNext)、Docker 容器编排与独立 Node.js 服务器三种部署拓扑的完整配置。

方式一:Cloudflare Workers 边缘极速部署#

通过 OpenNext 适配层将 Next.js 15 打包为 Cloudflare 边缘计算 Workers 脚本,在全球 300+ 数据中心毫秒级触达用户:

边缘数据库连接最佳实践
在 Cloudflare Workers 中建议启用 Cloudflare Hyperdrive 服务,将 PostgreSQL 数据库查询延迟从 200ms+ 降至个位数毫秒,极大提升边缘响应性能。资源绑定详见「Worker 配置」文档。
bashCloudflare 部署操作指引
# 1. 安装 OpenNext 与 Wrangler 边缘 CLI
pnpm add -D @opennextjs/cloudflare wrangler

# 2. 构建 Cloudflare 产物
pnpm cf:build

# 3. 部署上线到 Cloudflare
pnpm cf:deploy

方式二:Docker Compose 一键容器化编排#

适合部署在 AWS EC2、腾讯云 CVM、阿里云 ECS 或任何支持 Docker 的 Linux 服务器上,一键启动 Web 服务、PostgreSQL 与 MinIO:

bashDocker 生产运行指引
# 1. 配置生产 .env 文件
cp .env.example .env

# 2. 一键构建并启动后台容器
docker compose up -d --build

# 3. 检查容器运行状态与健康探针
docker compose ps
curl http://localhost:3000/api/ping

方式三:独立 Node.js Standalone + Systemd 部署#

适合已有自有数据库环境的企业私有化内网部署,生成仅数十兆的超精简 Standalone 运行包:

bashNode Standalone 部署步骤
# 1. 编译 Standalone 产物
NEXT_OUTPUT=standalone pnpm build

# 2. 拷贝静态资源(public 与 .next/static)
cp -r public .next/standalone/
cp -r .next/static .next/standalone/.next/

# 3. 运行服务
PORT=3000 node .next/standalone/server.js