• 产品简介
  • 快速开始
    • 导入 Git 仓库
    • 从模板开始
    • 直接上传
  • 框架指南
    • 前端
    • 后端
    • 全栈
      • Next.js
  • 项目指南
    • 项目管理
    • edgeone.json
    • 缓存配置
    • 错误码
  • 构建指南
  • 部署指南
    • 概览
    • 触发部署
    • 管理部署
    • 部署按钮
    • 使用 Github Action
    • 使用 CNB 插件
    • 使用 IDE 插件
    • 使用 CodeBuddy IDE
  • 域名管理
    • 概览
    • 自定义域名
    • 配置 HTTPS 证书
    • 如何配置 DNS 的 CNAME 记录
  • Pages Functions
    • 概览
    • Edge Functions
    • Node Functions
  • 日志分析
  • KV 存储
  • 边缘 AI
  • API Token
  • EdgeOne CLI
  • Pages MCP
  • 集成指南
    • AI
      • 对话型大模型集成
      • 图片大模型集成
    • 数据库
      • Supabase 集成
      • Pages KV 集成
    • 电商
      • Shopify 集成
      • WooCommerce 集成
    • 支付
      • Stripe 集成
      • Paddle 集成
    • CMS
      • WordPress 集成
      • Contentful 集成
      • Sanity 集成
    • 身份验证
      • Supabase 集成
      • Clerk 集成
  • 最佳实践
    • 使用通用大模型快速搭建AI应用
    • 使用 Deepseek-R1 模型快速搭建对话型AI站点
    • 使用 WordPress + WooCommerce 和 GatsbyJS 搭建电商平台
    • 使用 Supabase 和 Stripe 搭建 SaaS 站点
    • 如何快速搭建公司品牌站点
    • 如何快速搭建博客站点
  • 迁移指南
    • 从 Vercel 迁移至 EdgeOne Pages
    • 从 Cloudflare Pages 迁移至 EdgeOne Pages
    • 从 Netlify 迁移至 EdgeOne Pages
  • 排障指南
  • 常见问题
  • 联系我们
  • 产品动态

后端

EdgeOne Pages 支持多种流行的后端框架,旨在优化您的后端开发和运行体验。我们为主流的后端框架提供优质支持,并且在许多情况下,您无需进行任何前期配置即可完成部署。

为了帮助您更快地开始,我们提供了一些现成的模板,创建项目时您可以一键部署,轻松构建您的应用程序。

接下来,我们将展示每个框架的基本配置,帮助您快速在 Pages 上进行部署。


Express.js

Express.js 是一个基于 Node.js 的 Web 应用程序框架,提供了一系列强大的功能,用于构建单页、多页和混合 Web 应用程序。它以其灵活性和最小化特性而闻名,允许开发者根据项目需求自由选择组件。

注意:
Express 框架的内置路由,默认挂载到 node-functions 配置的路由上,并且入口函数文件名必须是 [[]] 的格式,如 [[default]].js。

可参考如下示例来快速创建一个 Express.js 应用:
// ./node-functions/express/[[default]].js

import express from "express";
const app = express();

app.use((req, res, next) => {
console.log(`[Log] ${req.method} ${req.url}`);
next();
});

app.get("/", (req, res) => {
res.json({ message: "Hello from Express on Node Functions!" });
});

export default app;

确保在部署前安装所有依赖,并使用 edgeone pages dev 进行本地开发和测试。


Koa.js

Koa.js 是一个由 Express 团队开发的下一代 Node.js Web 框架。它利用 async/await 语法,通过中间件以更优雅的方式处理异步操作,从而实现更简洁、更具表现力的代码。Koa.js 更加轻量级,不捆绑任何中间件,提供了更大的自由度。

注意:
Koa 框架的内置路由,默认挂载到 node-functions 配置的路由上,并且入口函数文件名必须是 [[]] 的格式,如 [[default]].js。

可参考如下示例来快速创建一个 Koa.js 应用:
// ./node-functions/koa/[[default]].js
import Koa from 'koa';
import Router from '@koa/router';

const app = new Koa();
const router = new Router();

app.use(async (ctx, next) => {
const start = Date.now();
await next();
const ms = Date.now() - start;
ctx.set('X-Response-Time', `${ms}ms`);
});

router.get('/', async (ctx) => {
ctx.body = { message: 'Hello from Koa on Node Functions!' };
});

app.use(router.routes());
app.use(router.allowedMethods());

export default app;

Koa.js 适用于需要高度定制化和高性能的后端服务。在部署前,请确保所有依赖已安装,并使用 edgeone pages dev 进行本地开发和测试。