• 产品简介
  • 快速开始
    • 导入 Git 仓库
    • 从模板开始
    • 直接上传
    • 从 AI 开始
  • 框架指南
    • 前端
      • Vite
      • React
      • Vue
      • 其他框架
    • 后端
    • 全栈
      • Next.js
      • Nuxt
      • Astro
      • React Router
      • SvelteKit
    • 自定义 404 页面
  • 项目指南
    • 项目管理
    • edgeone.json
    • 缓存配置
    • 错误码
  • 构建指南
  • 部署指南
    • 概览
    • 触发部署
    • 管理部署
    • 部署按钮
    • 使用 Github Action
    • 使用 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
  • 排障指南
  • 常见问题
  • 联系我们
  • 产品动态

部署按钮

本小节将介绍如何在 GitHub 仓库中添加一键部署按钮,让用户能够快速将您的模板部署到 EdgeOne Pages。


部署按钮

Pages 部署按钮如下所示:

使用 EdgeOne Pages 部署


当用户点击此按钮时,他们将被引导至 Pages,并预先配置您的仓库作为部署源。


如何添加部署按钮

将以下 markdown 代码添加到您仓库的 README.md 文件中:
[![使用 EdgeOne Pages 部署](https://cdnstatic.tencentcs.com/edgeone/pages/deploy.svg)](https://edgeone.ai/pages/new?repository-url=YOUR_REPO_URL)

YOUR_REPO_URL 替换为您的 GitHub 仓库 URL,支持子路径。例如:
[![使用 EdgeOne Pages 部署](https://cdnstatic.tencentcs.com/edgeone/pages/deploy.svg)](https://edgeone.ai/pages/new?repository-url=https%3A%2F%2Fgithub.com%2FTencentEdgeOne%2Fpages-templates%2Ftree%2Fmain%2Fexamples%2Fvue-template)


URL Search 参数

部署按钮 URL 支持以下 Search 参数:
Search 参数名称
描述
template
通过 Pages 官方模板来部署的模板名称
repository-name
Github 仓库名称
repository-url
通过其他 GitHub 仓库来部署的仓库地址
project-name
项目名称
build-command
构建命令
install-command
安装命令
output-directory
构建后产物的输出目录
root-directory
构建根目录
env
仓库必要的环境变量,如需多个可用英文逗号连接,如:KEY1,KEY2,KEY3
env-description
跟环境变量相关的描述
env-link
跟环境变量相关的链接

注意:
参数值需使用 encodeURIComponent() 编码后再拼接进 URL,如 build-command=npm%20run%20build


示例

对于公共 GitHub 仓库:
[![使用 EdgeOne Pages 部署](https://cdnstatic.tencentcs.com/edgeone/pages/deploy.svg)](https://edgeone.ai/pages/new?repository-url=https%3A%2F%2Fgithub.com%2Fusername%2Frepository)

对于特定分支:
[![使用 EdgeOne Pages 部署](https://cdnstatic.tencentcs.com/edgeone/pages/deploy.svg)](https://edgeone.ai/pages/new?repository-url=https%3A%2F%2Fgithub.com%2Fusername%2Frepository%2Ftree%2Fbranch-name)

如何使用 URL Search 参数:
[![使用 EdgeOne Pages 部署](https://cdnstatic.tencentcs.com/edgeone/pages/deploy.svg)](https://edgeone.ai/pages/new?repository-url=https%3A%2F%2Fgithub.com%2FTencentEdgeOne%2Fpages-templates%2Ftree%2Fmain%2Fexamples%2Fvue-template&output-directory=.%2Fdist&install-command=npm%20install&build-command=npm%20run%20build)


用户体验

当用户点击部署按钮时:

1. 页面将被重定向到 Pages 控制台
2. GitHub 仓库将被作为默认的部署源
3. 支持调整项目的配置项
4. 点击“立即创建”后,项目就会被部署至 Pages

这为想要快速尝试或部署您模板的用户提供了无缝的体验。


更多配置

参考 edgeone.json 文档,您可以自定义项目的构建命令(buildCommand)、依赖安装命令(installCommand) 以及输出目录(outputDirectory)。建议根据项目实际情况配置这些参数,以确保其他人能够正确构建和部署您的项目。
ai-agent
你可以这样问我
如何开始使用 EdgeOne Pages?