本指南将帮助您将 Vercel 项目平滑迁移至 EdgeOne Pages。
1. 准备工作：查找构建命令和输出目录
首先，我们需要找到您 Vercel 项目的构建命令和输出目录：
1. 登录仪表板，找到要迁移的项目。
2. 进入 Settings（项目设置），选择 General（通用）选项卡。
3. 在 Build and Development Settings（编译与部署设置） 面板中，记录以下信息：
Build Command （构建命令）
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"}]}]}
3. 函数迁移：从 Vercel 到 EdgeOne Pages
两个平台在语法和使用方式上有一些差异。以下是一个简单的对比示例：
Vercel Functions 的 Hello World：
export const dynamic = 'force-dynamic';export function POST(request) {return new Response(`Hello world`);}
Pages Functions 的 Hello World：
export default function onRequestPost(context) {return new Response(`Hello world`);}
主要差异：
Pages 使用 onRequest 系列函数（如 onRequestPost）来处理不同的 HTTP 方法。
Pages Functions 接收一个 context 对象，包含了请求信息、环境变量等。
响应方式类似，都使用 Response 对象。
说明：
Pages Functions 支持 Node Functions 跟 Edge Functions，两者在特性上会有些许差异，例如 context 对象，可根据您的具体需求进行选择。
迁移建议：
将导出函数改为 onRequest 系列函数。
如果使用了 Vercel 特有的功能，可能需要寻找其他方案，可通过社群联系我们。
4. 项目部署：在 EdgeOne Pages 创建新项目
准备工作完成后，在 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 产品特点进行了智能刷新预热等优化，提供开箱即用的使用体验。此外，Pages 在公测阶段相对竞品限制更少，为开发者提供更多选择的灵活性。在客户支持上，我们提供更及时的响应，致力于为开发者打造优质的产品体验。
