边缘开发者平台
  • Pages
    • 产品简介
    • 快速开始
      • 导入 Git 仓库
      • 从模板开始
      • 直接上传
      • 从 AI 开始
    • 框架指南
      • 前端
        • Vite
        • React
        • Vue
        • 其他框架
      • 后端
      • 全栈
        • Next.js
        • Nuxt
        • Astro
        • React Router
        • SvelteKit
        • TanStack Start
        • Vike
      • 自定义 404 页面
    • 项目指南
      • 项目管理
      • edgeone.json
      • 缓存配置
      • 错误码
    • 构建指南
    • 部署指南
      • 概览
      • 触发部署
      • 管理部署
      • 部署按钮
      • 使用 Github Action
      • 使用 Gitlab CI/CD
      • 使用 CNB 插件
      • 使用 IDE 插件
      • 使用 CodeBuddy IDE
    • 域名管理
      • 概览
      • 自定义域名
      • 配置 HTTPS 证书
        • 概览
        • 申请免费证书
        • 使用 SSL 托管证书
      • 配置 DNS 的 CNAME 记录
    • 可观测性
      • 概览
      • 指标分析
      • 日志分析
    • Pages Functions
      • 概览
      • Edge Functions
      • Cloud Functions
        • 概览
        • Node Functions
    • 中间件
    • KV 存储
    • 边缘 AI
    • API Token
    • EdgeOne CLI
    • Pages MCP
    • 消息通知
    • 集成指南
      • AI
        • 对话型大模型集成
        • 图片大模型集成
      • 数据库
        • Supabase 集成
        • Pages KV 集成
      • 电商
        • Shopify 集成
        • WooCommerce 集成
      • 支付
        • Stripe 集成
        • Paddle 集成
      • CMS
        • WordPress 集成
        • Contentful 集成
        • Sanity 集成
        • Payload 集成
      • 身份验证
        • Supabase 集成
        • Clerk 集成
    • 最佳实践
      • 使用通用大模型快速搭建 AI 应用
      • 使用边缘 AI 模型快速搭建对话型 AI 站点
      • 使用 Shopify 搭建电商平台
      • 使用 Supabase 和 Stripe 搭建 SaaS 站点
      • 如何快速搭建公司品牌站点
      • 如何快速搭建博客站点
    • 迁移指南
      • 从 Vercel 迁移至 EdgeOne Pages
      • 从 Cloudflare Pages 迁移至 EdgeOne Pages
      • 从 Netlify 迁移至 EdgeOne Pages
    • 排障指南
    • 常见问题
    • 联系我们
    • 产品动态

Payload 集成

Payload CMS 是一款原生集成 Next.js 的现代化、开源 Headless CMS。它利用 Next.js App Router 和 React Server Components 技术,允许开发者将 CMS 直接嵌入到 Next.js 应用程序中,实现后端内容管理与前端展示的无缝融合,拥有极致的灵活性与开发者体验。
本文将介绍如何将 Payload 作为 Headless CMS,配合 MongoDB 数据库构建高性能网站。通过 EdgeOne Pages 的一键部署能力,您可以快速上线您的 Payload CMS 系统,同时获得全球 CDN 加速,实现网站的最佳性能和用户体验。


快速入门

EdgeOne Pages 提供了完整的 Payload + MongoDB 集成方案模版,您可以点击模版中的部署按钮进行快速部署。
Payload + MongoDB 集成主要包含四个关键步骤:MongoDB 准备、S3 对象存储准备、其他payload环境变量配置、部署到 EdgeOne Pages。下面将详细介绍每个步骤的具体操作。


MongoDB 准备

本方案中使用MongoDB作为数据库来存储内容数据,MongoDB 服务推荐使用MongoDB Atlas(提供免费额度)或腾讯云MongoDB。

1、注册并创建集群

登录 MongoDB Atlas,创建一个新的 Cluster。

2、创建数据库用户

在 “Database Access” 页面创建一个新用户,记录下 Username 和 Password。


3、配置网络访问

在 “Network Access” 页面,添加 IP 地址,以确保 EdgeOne Pages 的构建和运行环境可以连接到数据库。


4、获取连接字符串

点击 Cluster 上的 "Connect" 按钮。
选择 "Drivers"。
复制提供的 Connection String(通常以 mongodb+srv:// 开头)。
注意:将连接字符串中的 <password> 替换为您刚才创建的实际密码。
请记下这个连接字符串,稍后我们将把它填入环境变量 DATABASE_URI 中。




S3 对象存储准备

由于 Serverless 环境的文件系统通常是临时的(每次重新部署或冷启动后文件会丢失),我们需要将用户上传的图片、视频等媒体文件存储在外部对象存储服务中。Payload 支持任何兼容 S3 协议的存储(如腾讯云 COS、AWS S3、Cloudflare R2 等)。
以腾讯云 COS 为例:

1、创建存储桶

登录腾讯云控制台,进入对象存储(COS),创建一个新的存储桶(Bucket),并将访问权限设置为“公有读私有写”(以便前端可以公开访问图片)。

2、获取密钥

在访问管理(CAM)中获取 SecretId 和 SecretKey。稍后将填入环境变量 S3_ACCESS_KEY_ID 和 S3_SECRET_ACCESS_KEY 中。

3、记录配置信息

Bucket Name:存储桶名称。
Region:所属地域(例如 ap-shanghai)。
Endpoint:访问域名。
稍后将填入环境变量S3_BUCKET、S3_REGION、S3_ENDPOINT中。


其他 Payload 环境变量准备

1、PAYLOAD_SECRET

Payload 用于签署 JWT 令牌等密钥。
生成方法:您可以在终端运行 openssl rand -hex 32 生成,或者随意输入一串足够长且复杂的随机字符。

2、NEXT_PUBLIC_SERVER_URL

这是您的网站最终访问的域名。在初次部署时,如果还没有自定义域名,可以使用 EdgeOne Pages 提供的默认域名,或者先填入 http://localhost:3000 待部署完成后再更新。


部署到 EdgeOne Pages

1、使用模版

在EdgeOne Pages模版页面找到 Payload + MongoDB 集成方案模版,点击 Deploy 进入到部署页面。

2、关联代码仓库

授权并选择您的 Git 账户(GitHub/GitLab 等),EdgeOne 将会自动为您创建一个新的仓库。

3、配置环境变量

在部署配置页面的“环境变量”区域,填入前面准备好的信息:


4、点击部署

确认无误后,点击“创建”按钮开始部署。
部署完成后,您将获得一个访问域名。点击访问,在 URL 后加上 /admin(例如 https://your-site.edgeone.app/admin),即可看到 Payload CMS 的初始化界面,创建您的第一个管理员账号。
至此,我们已经完成了Payload方案的完整部署流程。通过这个方案,你可以:
使用Payload管理内容,享受其强大的Headless CMS功能。
通过EdgeOne Pages实现自动化部署,简化运维工作。
获得全球CDN加速,提升用户体验


更多相关内容

了解Payload更多功能:Payload官方文档