将 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 控制台上报数据。