这是什么
Deno Deploy 是 Deno 官方的边缘部署平台,把 Deno/TypeScript 应用和函数分发到全球边缘节点,冷启动快、自带 Deno KV 键值数据库。本站 2026-11-17 按官方定价页核实:Free 档 $0,每月 100 万请求、20 GiB 出口流量、10 小时主动 CPU 时间,还给 1 GiB 的 KV 存储和每月 100 万次 KV 读取。对个人项目、API 小服务、Webhook 中转这类轻量场景,这个量级相当宽裕。
怎么申请
- 打开 deno.com/deploy,点 Start free 进控制台(console.deno.com),注册或登录账号,然后先创建组织(Organization)。组织名和 slug 创建后不能改,先想好再提交。
- 在组织下点 + New App 新建应用,选 GitHub 仓库关联自动部署(也可以用命令行或在控制台里直接写代码部署)。仓库不出现在列表里,是 Deno Deploy 的 GitHub App 还没拿到该仓库权限,去选仓库页的「Configure GitHub App permissions」补授权。应用放在子目录里的单体仓库(monorepo)官方暂不支持,先把应用放仓库根目录。免费档最多同时 10 个应用。
- 核对平台自动生成的构建配置(框架预设、安装/构建命令、动态入口文件路径),再点 Create App 触发首次构建;构建日志分段显示,其中 Warm up 阶段是应用启动的运行时日志,不是构建日志,别看混。部署完成后先到控制台用量页确认当前套餐显示 Free,并看一眼各项额度计数(请求、流量、CPU、KV),再开始正式用。
拿到后怎么用
- 三种部署方式挑顺手的。 关联 GitHub 仓库后每次推送自动构建部署,适合长期项目;本地用官方 CLI 部署适合快速迭代;控制台里直接写代码部署适合小函数和临时试验。构建配置(入口文件、构建命令、环境变量)都在应用设置里改,环境变量可区分 Production 和 Development 两套上下文,别把测试用的值写进生产。
- 额度怎么扣,心里要有账。 请求数按入站 HTTP 请求计,静态资源请求和 API 调用都算;CPU 只算代码主动运行的时间,等网络、等 I/O 不计;流量只算出口。控制台用量页能看每项已用多少,接近上限前先优化,别等超了才发现。
- KV 当轻量数据库用。 代码里用
Deno.openKv()打开,适合存配置、计数、会话这类小数据;读写按单元计(一个读单元 4 KiB),查列表用批量接口,别在循环里逐条 get。还有一条关键的:本地开发的 KV 和线上是两套数据,本地测通不等于线上已有数据,上线后先在云端写一条验证。 - 出问题先回滚,别硬改线上。 每次构建都有独立预览地址,生产出问题先在控制台切回上一个正常构建,再慢慢查原因。日志免费档只保留 1 天,排障要趁早看,重要日志自己转存到外部。
额度
| 项目 | 内容 |
|---|---|
| 请求 | 每月 100 万次入站 HTTP 请求 |
| 出口流量 | 每月 20 GiB(入站流量不计) |
| 计算 | 主动 CPU 10 小时/月;内存时间 150 GiB·小时/月;版本存储 10 GiB |
| 应用与域名 | 最多 10 个应用;自定义域名 5 个;团队成员 3 人 |
| Deno KV | 存储 1 GiB;读单元 100 万/月;写单元 50 万/月 |
| 构建 | 同时构建 1 个;每小时构建 15 次 |
限制
- 只跑 Deno 运行时:代码要按 Deno 的 API 和权限模型写,Node 项目迁过来要先做兼容性检查,别默认 npm 生态全无痛。
- CPU 按「主动运行时间」计:等网络、等 I/O 不烧 CPU,但死循环和重计算会很快吃掉 10 小时。
- 免费档日志只保留 1 天,指标历史 1 个月;要长期留痕自己接外部日志。
容易卡住的地方
- GitHub 仓库选不到:是 Deno Deploy 的 GitHub App 没被授权到那个仓库(或那个 GitHub 账号),在选仓库页用「Add another GitHub account / Configure GitHub App permissions」补授权,不是账号坏了。
- 应用在子目录里部署不了:单体仓库(monorepo)官方明确暂不支持子目录应用,先把应用移到仓库根目录,或者单独拆一个仓库。
- 构建失败先看入口文件:构建配置里的 Dynamic Entrypoint 路径不对是最常见原因——它要写你本地会传给
deno run的那个文件的相对路径。还有 Warm up 阶段的报错是应用启动时的运行时日志,说明构建已过、是代码启动失败,两个阶段别混着排查。 - 本地能跑、线上报错:多半是 Node 兼容差异或环境变量没配对。先在本地用 Deno 本身跑一遍(用 Node 跑通不算数),再去控制台确认环境变量写在了对的上下文(Production / Development)里。
- KV 本地有数据、线上读不到:本地 KV 与云端 KV 是两套存储,本地写入不会同步上云;上线后要在云端重新初始化数据,别对着空库查代码。
- 额度莫名涨得快:先查是不是把大文件走 Deploy 出口在烧流量,或者循环里逐条读 KV 在烧读单元——到用量页按项看,哪项涨得异常就先定位哪项。
避坑
- 20 GiB 是出口流量:拿它当图床或文件分发会很快见底,它适合 API 和动态页面,不适合大文件分发。
- KV 读写按单元计费:一次 get 算一个读单元(4 KiB),循环里逐条读 KV 是烧额度的典型姿势,能批量就批量。
以上信息以官方页面为准,申请前请打开官网再核对一次。
常见问题
Deno Deploy 免费档每月多少额度?
官方定价页口径:每月 100 万请求、20 GiB 出口流量、10 小时主动 CPU、150 GiB·小时内存时间,另带 1 GiB KV 存储(本站 2026-11-17 核实)。
Deno Deploy 要绑卡吗?
免费档 $0,官方定价页未要求绑卡;注册开通即可用,超额想继续才需要升 Pro($20/月)。
Deno Deploy 能跑 Node 项目吗?
它跑的是 Deno 运行时,对 npm 包有兼容层,但不是原样跑 Node。迁项目先在本地用 Deno 跑通再部署。
免费档能绑自己的域名吗?
能,最多 5 个自定义域名(官方定价页口径)。
部署方式有哪几种?
三种:关联 GitHub 仓库推送自动部署、官方 CLI 本地部署、控制台在线写代码部署。长期项目推荐 GitHub 关联,改完推送就自动构建上线。
构建失败最常见的原因是什么?
构建配置里的入口文件(Dynamic Entrypoint)路径写错;其次是 GitHub App 没授权到仓库、选不到仓库。构建日志是分段的,先定位卡在哪一段再查。
本地开发的数据会同步到线上 KV 吗?
不会。本地 KV 和云端 KV 是两套存储,本地写入不自动上云,上线后要在云端重新初始化数据。
免费档的日志能保留多久?
日志只保留 1 天,指标历史 1 个月(官方定价页口径)。需要长期留排障记录的,自己接外部日志服务转存。