从 Deploy Classic 迁移到 Deno Deploy
Deno Deploy Classic（dash.deno.com）和 subhosting v1 API（apidocs.deno.com） 将于 2026 年 7 月 20 日 停止服务。本指南介绍如何将您的 应用程序和 API 集成迁移到新的 Deno Deploy 平台。如果您正在从 subhosting v1 API 迁移，请参阅 subhosting API 迁移指南。
创建新组织 Jump to heading
新的 Deno Deploy 使用独立的账号系统。开始使用：
- 前往 console.deno.com 并登录
- 创建一个新组织（如果您还没有）——这是在部署任何应用程序之前 必需的
- 根据需要邀请团队成员加入您的组织
您在 dash.deno.com 上的 Deploy Classic 项目不会自动 转移。 您需要创建新应用并重新部署。
创建并部署您的应用 Jump to heading
在新的 Deno Deploy 控制台中，在您的组织内创建一个新应用。您 可以通过 GitHub 集成或 CLI 进行部署。
GitHub 集成 Jump to heading
在控制台中的应用设置里连接您的 GitHub 仓库。新的 Deploy 已完全集成构建流程——不再需要 GitHub Actions YAML 配置。 构建日志会直接在控制台中实时流式显示。
CLI 部署 Jump to heading
deployctl CLI 也将逐步停用。请改用 deno deploy
子命令：
deno deploy
有关详细设置说明，请参阅 入门指南。
环境变量 Jump to heading
Deploy Classic 为所有部署使用同一组环境变量。 新的 Deploy 支持分别设置 生产、开发 和 构建 上下文。
请检查您的环境变量，并在新控制台中应用设置下进行配置。有关详细信息，请参阅 环境变量和上下文。
自定义域名 Jump to heading
迁移自定义域名：
- 在控制台中将域名添加到您的新 Deploy 应用
- 为 TLS 证书签发配置
_acme-challengeCNAME 记录 - 更新您的 DNS 记录（CNAME 或 ANAME）指向新的 Deploy
- 在从 Deploy Classic 中移除该域名之前，最多允许 48 小时用于 DNS 传播
有关逐步操作说明，请参阅 自定义域名迁移教程。
Cron 任务 Jump to heading
Deno.cron() API 在新的 Deploy 上的工作方式相同。您现有的 cron
任务代码应可直接运行，无需修改。有关详细信息，请参阅
cron 参考。
队列 Jump to heading
Deno 队列（Deno.Kv.enqueue() / Deno.Kv.listenQueue()）在新的
Deno Deploy 上不受支持。如果您的应用依赖队列，您需要采用替代方案——例如，
外部消息队列服务或基于数据库的任务队列。
KV 数据库 Jump to heading
新的 Deploy 提供 Deno KV，但您现有的 KV 数据不会 自动迁移。请联系 support@deno.com 寻求迁移 KV 数据库的帮助。
有关 KV 在新平台上的工作方式，包括按上下文隔离数据库的信息，请参阅 Deploy 上的 Deno KV。
Subhosting API 迁移 Jump to heading
位于 apidocs.deno.com 的 subhosting v1 API 将与 Deploy
Classic 一同于 2026 年 7 月 20 日停止服务。请将您的集成迁移到
v2 API。
v2 API 在架构上有重大变化——项目变为应用，部署变为修订， 每个应用代表一个可部署的单一服务。有关详细的端点映射、请求/响应 变化，以及标签和层等新功能，请参阅 subhosting API 迁移指南。
v2 API 的官方 SDK：
- TypeScript/JavaScript： @deno/sandbox
- Python: deno-sandbox
区域 Jump to heading
Deploy Classic 在 6 个区域提供服务。新的 Deploy 目前有 2 个区域， 并且可以在您自己的基础设施上自托管额外区域。如果您的应用对延迟敏感并依赖特定区域，请 提前做好相应规划。
新功能 Jump to heading
新的 Deploy 包含 Deploy Classic 中没有的几个功能：
- 完整的 Deno 2.0 运行时 — FFI、子进程、文件系统写入权限，以及 改进的 npm 兼容性
- 集成构建 — 构建步骤在 Deno Deploy 上运行，并实时流式传输 日志，无需 GitHub Actions YAML
- 一流的框架支持 — Next.js、Astro、SvelteKit、Fresh 等 可开箱即用
- CDN 缓存 — 内置边缘缓存，支持
Cache-Control头和 程序化缓存失效 - 可观测性 — 控制台中的日志、追踪和指标
- 静态站点支持 — 可直接部署静态站点
- 独立的开发/生产环境 — 不同上下文使用不同的环境变量和 数据库
如果您有任何问题或需要帮助，请联系 support@deno.com。