边缘开发者平台
  • Pages
    • 产品简介
    • 快速开始
    • 框架指南
    • 项目指南
      • 项目管理
      • edgeone.json
      • 错误码
    • 构建指南
    • 部署指南
    • 域名管理
    • Pages Functions
    • KV 存储
    • EdgeOne CLI
    • 常见问题
    • 联系我们
    • 产品动态
    • 迁移指南
      • 从 Vercel 迁移至 EdgeOne Pages
      • 从 Cloudflare Pages 迁移至 EdgeOne Pages
      • 从 Netlify 迁移至 EdgeOne Pages
当前为国际站中文文档,如需访问中国站文档,请点击这里

从 Vercel 迁移至 EdgeOne Pages

本指南将帮助您将 Vercel 项目平滑迁移至 EdgeOne Pages。


1.准备工作:查找构建命令和输出目录

首先,我们需要找到您 Vercel 项目的构建命令和输出目录:
1. 登录仪表板,找到要迁移的项目。
2. 进入 Settings(项目设置),选择 General(通用) 选项卡。
3. 在 Build and Development Settings(编译与部署设置) 面板中,记录以下信息:
3.1 Build Command (构建命令)
3.2 Output Directory (输出目录)



例如:
构建命令: npm run build
输出目录: build

这些信息将在项目配置中使用。


2.配置迁移:处理重定向和标头

如果您的项目使用了 vercel.json 文件来配置重定向或自定义标头,需要将这些配置迁移到 EdgeOne Pages 的 edgeone.json 文件中。

以下是两者的对比示例:

Vercel 的 vercel.json 配置:
{
"redirects": [
{
"source": "/articles",
"destination": "/blog",
"statusCode": 301
}
],
"rewrites": [
{
"source": "/assets/*",
"destination": "/assets-new/:splat"
}
],
"headers": [
{
"source": "/(.*)",
"headers": [
{
"key": "X-Frame-Options",
"value": "DENY"
},
{
"key": "Cache-Control",
"value": "max-age=7200"
}
]
},
{
"source": "/assets/*",
"headers": [
{
"key": "Cache-Control",
"value": "max-age=31536000"
}
]
}
]
}

对应的 edgeone.json 配置:
{
"redirects": [
{
"source": "/articles",
"destination": "/blog",
"statusCode": 301
}
],
"rewrites": [
{
"source": "/assets/*",
"destination": "/assets-new/:splat"
}
],
"headers": [
{
"source": "/*",
"headers": [
{
"key": "X-Frame-Options",
"value": "DENY"
},
{
"key": "Cache-Control",
"value": "max-age=7200"
}
]
},
{
"source": "/assets/*",
"headers": [
{
"key": "Cache-Control",
"value": "max-age=31536000"
}
]
}
]
}
注意: EdgeOne Pages 的配置语法与 Vercel 非常相似,但可能存在一些细微差别。详细的配置选项请参考 edgeone.json 文档


3.函数迁移:从 Vercel 到 EdgeOne Pages

两个平台在语法和使用方式上有一些差异。以下是一个简单的对比示例:

Vercel Functions 的 Hello World:
export const dynamic = 'force-dynamic';
export function POST(request) {
return new Response(`Hello world`);
}

EdgeOne Pages Functions 的 Hello World:
export function onRequestPost(context) {
return new Response(`Hello world`);
}

主要差异:
Pages 使用 onRequest 系列函数(如 onRequestPost)来处理不同的 HTTP 方法。
Pages 函数接收一个 context 对象,包含了请求信息、环境变量等。
响应方式类似,都使用 Response 对象。

迁移建议:
将 Vercel 的导出函数改为 EdgeOne Pages 的 onRequest 系列函数。
如果使用了 Vercel 特有的功能,可能需要寻找其他方案,可通过社群联系我们。

详细的函数使用可以参考 Pages Functions 文档


4.项目部署:在 EdgeOne Pages 创建新项目

准备工作完成后,在 EdgeOne Pages 上创建并部署项目:
1. 登录腾讯云控制台,进入 Pages 服务。
2. 点击"创建项目",选择您的 GitHub 仓库。
3. 在项目配置中,填入之前记录的构建命令和输出目录。
4. 点击"开始部署"按钮,Pages 将自动构建和部署您的项目。


5.域名配置:添加自定义域名

迁移步骤:
1. 在项目设置中添加您的自定义域名,获取 CNAME 记录值。
2. 登录您的 DNS 服务商控制台。
3. 删除之前为 Vercel 设置的 A、AAAA 或 CNAME 记录。
4. 添加新的 CNAME 记录,指向 EdgeOne Pages 提供的新值。
5. 等待 DNS 更新生效(可能需要几分钟到几小时)。

注意: 如果您之前使用 Vercel DNS,需要将域名转移到其他 DNS 服务商,然后按上述步骤配置 CNAME 记录。

详细的域名添加过程可以参考 域名管理文档

通过完成上述步骤,您已经成功将 Vercel 项目迁移到了 EdgeOne Pages。两个平台在某些方面有相似之处,但在强大的基础设施上,我们针对 Pages 产品特点进行了智能刷新预热等优化,提供开箱即用的使用体验。此外,Pages 在公测阶段相对竞品限制更少,为开发者提供更多选择的灵活性。在客户支持上,我们提供更及时的响应,致力于为开发者打造优质的产品体验。

如果您在迁移过程中遇到任何问题,欢迎查阅 EdgeOne Pages 的官方文档