跳到正文

将 Next.js 应用从 Vercel 迁移到 Arkor

从 Vercel 迁移,不必一步到位。在 Vercel 继续提供服务的同时,将同一个仓库部署到 Arkor,通过它的专属地址进行检查,等你准备好了再切换域名。

开始部署

开始之前

  • Next.js 16.3+。Arkor 使用 Turbopack 构建,这也是 Next.js 16 中 next build 默认使用的构建工具。
  • 需要修改的地方。移除 experimental.optimizeCss,使用 Turbopack 而不是 --webpack 进行构建,并替换 Node.js 原生插件、child_process 或 node:vm。不支持 WebSocket。完整列表请见 Next.js support(英文)。
  • 免费套餐或 Pro 套餐。个人团队可以使用免费套餐部署,无需信用卡:作为上线优惠,目前每月包含 10 美元用量(标准额度为 5 美元);如有变更,我们会提前通知。当月用量达到该额度后,团队的项目会暂停到下个月开始。免费套餐每个项目可使用 1 个自定义域名。其他团队需要 Pro 套餐:每个团队每月 20 美元,包含 20 美元用量,每个项目最多可使用 5 个自定义域名。

1. 与 Vercel 并行部署

使用 GitHub 登录,在仓库所属的账号上安装 Arkor 的 GitHub App,然后导入该仓库。个人团队可以使用免费套餐立即导入;其他团队请先选择 Pro 套餐。Arkor 会创建项目,并开始对你的生产分支进行首次构建。Vercel 上不会有任何变化。

构建、验证和已配置的 GitHub 检查通过后,应用会发布到 https://<项目名>.arkor.app。快速入门(英文)展示了每个界面。

arkor.app 地址用于检查部署。用于生产时,请配置你拥有的自定义域名。

2. 复制环境变量

打开项目的 Settings › Environment variables,选择 Paste .env 即可一次添加多个变量。将密码和 API 密钥标记为 Secret。更改会在下一次部署时生效,因此添加完成后请重新部署。

如果你从 Vercel 复制变量,请排除 NEXT_PUBLIC_VERCEL_OBSERVABILITY_BASEPATH 和 NEXT_PUBLIC_VERCEL_OBSERVABILITY_CLIENT_CONFIG:它们会把 Web Analytics 指向 Vercel 的路径。参见 Environment variables(英文)。

3. 保留 Vercel 为你运行的功能

  • 定时任务(cron jobs)在 vercel.json 中声明后,会按各自的计划运行。添加 CRON_SECRET 变量,即可让每次调用都经过授权。参见 Cron jobs(英文)。
  • Web Analytics 和 Speed Insights 搭配 @vercel/analytics 和 @vercel/speed-insights 可继续正常工作,其数据会显示在 Arkor 控制台中。参见 Web Analytics(英文)。
  • 访问者所在的国家/地区以 x-arkor-ip-country 传入;在原来读取 x-vercel-ip-country 的地方改为读取它。

4. 比较两者

分别通过 arkor.app 地址和 Vercel 打开你的页面,从访问者所在的地方比较它们的响应速度。控制台中团队的 Usage 页面会显示各项目的用量,这样你就可以在迁移前估算账单。

5. 迁移域名

在项目的 Settings › Domains 中添加你的主机名,并发布 Arkor 显示的 TXT 记录,以证明该主机名归你所有。然后,用一条 CNAME 记录将主机名指向 domains.arkor.app。记录配置好后,证书就会签发。参见 Custom domains(英文)。

在你有把握之前,请保留 Vercel 项目。将 DNS 记录指回原处,就是回滚的方法。

常见问题

从 Vercel 迁移,需要修改我的代码吗?

通常不需要。Arkor 会直接在你现有的仓库上运行 next build。部分应用需要做一些修改,例如不再使用 webpack 构建,这些修改都列在文档中的 Next.js 支持页面上。

测试 Arkor 期间,我可以让 Vercel 继续运行吗?

可以。在 Arkor 上,每个项目都通过各自的 arkor.app 地址提供服务,因此在你迁移域名之前,两者会并行运行。

如何回滚?

在你有把握之前,请保留 Vercel 项目的部署;如有需要,将域名的 DNS 记录重新指向 Vercel。

定时任务(cron jobs)和网站分析需要修改吗?

不需要。在 vercel.json 中声明的定时任务会在 Arkor 上运行,@vercel/analytics 和 @vercel/speed-insights 也无需修改即可向 Arkor 控制台上报数据。

开始部署