跳到正文

更新日志

Seed 现已支持 Deno、Node 和 Bun

发布于· 阅读约 2 分钟·

其他语言:العربية、Deutsch、English、Español、Français、日本語、Português (Brasil)和Русский

山丘顶上一盆紫色的嫩芽,三条小路通向它:一条是踏脚石,一条是木板,一条是碎石。

要点速览

  • Seed 的 API、后台 worker、数据库迁移和网站现在无需修改即可在 Deno、Node 和 Bun 上启动,CI 在每个 pull request 上都会在三种运行时上验证。
  • env 文件里的一行 APP_RUNTIME=node 或 bun 就能切换服务器的运行时。不写这一行就保持 Deno,所以什么都不改的产品照常运行。
  • 公开网站从 Fresh 换成了一个小巧的层,路由、页面和 island 都和原来一样,每个页面加载的 JavaScript 都更少了。
  • 任务和测试仍然跑在 Deno 上;npm 或 Bun 会帮你装好 Deno。

免费开源的 SaaS 模板 Seed 现在可以运行在 Deno、Node.js 和 Bun 上。API、后台 worker、数据库迁移和 公开网站在三种运行时上都无需修改一行代码即可启动,CI 会在每个 pull request 上把 API、worker 和 网站在三种运行时上各启动一遍。产品服务器用哪个运行时,由 env 文件里的一行决定;不写这一行,就 全部保持在 Deno 上。

这篇文章写给两类读者:一类正在挑选 SaaS 脚手架,不想把产品押在单一运行时上;另一类已经在用 Seed 做产品,下一次同步就会拿到这项改动。每一节回答一件你可能要做的事。迁移本身的经过,包括踩过 的坑,写在我的博客上(英文)。

怎样在我用的运行时上新建产品?

README 的快速开始现在为每个运行时各写了一节: Node、Bun 和 Deno。你需要 Docker,再加三者之一。用 Node 的话:

npm install -g deno
gh repo create my-product --template spy4x/seed --private --clone
cd my-product
npm run init
npm run dev

没错,第一行装的是 Deno。为了摆脱 Deno 先装上 Deno,这事比我希望的要好笑,但 Seed 自己的任务 目前还跑在 Deno 上(下文会讲),而 npm 上有 deno 包,所以只有 Node 的机器不需要再装别的。用 Bun 的话,第一行换成 bun add -g deno,最后两行换成 bun run init 和 bun run dev。gh 那一行可以 不用:在 GitHub 上点 "Use this template" 再 clone,效果一样。

这样你就在 Docker 里跑起了基于 Deno 的完整技术栈。如果想让产品的服务器也跑在 Node 或 Bun 上,在 运行 dev 之前往 infra/envs/.env 里加一行:

APP_RUNTIME=node   # 或 bun;写 deno、留空或不写这一行都保持 Deno

在 Node 或 Bun 上运行哪些部分,有什么不同?

设置 APP_RUNTIME=node 或 bun 后,API、worker、迁移和网站会各自从专门的 Docker 镜像运行在 Node 26 或 Bun 1.4 上。端口、环境变量和服务的启动顺序都不变。SPA 和管理后台是静态文件,不受影响。 完整说明见文档的运行时一节。

切换之前,最好先知道与 Deno 的三点不同:

  • 没有 watch 模式。 代码在镜像里打包,所以在 Node 或 Bun 上,即使是开发环境,改了代码也要 重新构建镜像才能看到。带热重载的开发仍然在 Deno 上进行。
  • worker 没有运行时权限限制。 在 Deno 上,worker 只能读写自己的图片目录,也只能运行 vips。 Node 和 Bun 没有这种限制,在那里约束 worker 的只有它的容器和非 root 用户。
  • 由你决定。 不写这一行、留空或写 deno,都保持在 Deno 上。

我已经有一个基于 Seed 的产品,该怎么做?

照常同步即可,按产品指南的步骤:拉取 Seed,应用补丁,记录提交:

git fetch https://github.com/spy4x/seed main
git diff --binary "$(cat .seed/commit)" FETCH_HEAD -- . ':!AGENTS.md' $(sed '/^$/d; s/^/:!/' .seed/skip) | git apply --3way && git rev-parse FETCH_HEAD > .seed/commit

然后在打开 pull request 之前运行 deno task check。我在一份运行时改动之前的 Seed 副本上试过这次 同步,补丁没有任何冲突就应用上了。你的产品在你有意改过 Seed 文件的地方可能会有冲突:按指南的说法, 保留你自己的版本。

这次同步会加入 Node 和 Bun 的 Docker 镜像、切换到它们的 Compose 文件,以及仓库根目录的 package.json。它不会改变你正在用的运行时。想切换时,在 infra/envs/.env 里设置 APP_RUNTIME=node(或 bun),然后重新构建镜像:

deno task compose up -d --build

在服务器上,把同一行写进服务器的 env 文件,然后照常部署(更新): 每次部署都会构建这一行指定的镜像。

公开网站有什么变化?

网站不再运行在 Fresh 上,而是换成了 @spy4x/preact-server。这是一个小巧的开源层,照搬了 Fresh 2 的路由、页面和 island,所以网站代码几乎没变。我在两个构建上请求了所有路由并比对响应: 423 个响应中有 419 个完全相同。不同的 4 个是某个视频的修改时间和 ETag,以及一个格式错误的地址: 以前它得到的是一个光秃秃的错误,现在得到的是网站自己的 404 页面。

页面也变轻了。每个页面经 gzip 压缩后的 JavaScript 体积,用 Lighthouse 移动端测得:

页面 新的层 Fresh
首页 24.0 KB 32.1 KB
带 island 的博客文章 29.9 KB 38.0 KB
文档 8.6 KB 19.4 KB

在带交互式滑块的那篇文章上,页面阻塞输入的时间是 5 毫秒,Fresh 则是 48 毫秒。这个层的第一个 版本恰恰在这里比 Fresh 慢,而 CI 没有发现;我是怎么发现的,写在 完整的故事里。

如果你改过自己产品的网站,同步之后可能还剩一些文件在从 Fresh 导入。在仓库根目录下这样找:

grep -rlE 'from "fresh' apps/mpa

把每个导入改成 @spy4x/preact-server(fresh/runtime 也一样),并把 FreshContext 改名为 Context。构建目录现在是 dist,不再是 _fresh。页面里不再有内联脚本,所以安全响应头也不再需要 每个请求一个 nonce。这个层还是第一个版本:它提供什么、省略了什么,见 它的文档。

哪些部分仍然需要 Deno?

工具链:格式化、lint、类型检查、测试,以及 deno task 背后的脚本。根目录的 package.json 会把 常用任务转交给 Deno,所以 npm run test 和 bun run dev 同样能用。测试仍然使用 Deno 的测试运行器。 这一点是否改变,由定在 2027 年 1 月 10 日的评审决定 (运行时策略)。这些都不会让用户 访问的服务器运行时被绑定在 Deno 上。

Seed 为什么不再依赖 Deno?

2026 年 10 月 9 日,Deno 团队宣布再提供一年的错误修复和安全 更新,之后停止自身的开发。Deno 仍然是开源的,我也依然喜欢它。但一个你要在上面做生意的模板,不该 把你的产品押在某一个运行时的路线图上,我自己的路线图也一样。Seed 本来就建立在 Web 标准之上 (Fetch、Web Crypto、WebSocket、ES 模块),所以真正难的是文件服务、公开函数签名里的 Deno 类型, 以及网站这一层,而不是推倒重写。

在你已经在用的运行时上试试快速开始。如果哪一步失败了, 带上你运行的命令提一个 issue,我来修。

通过邮件接收下一篇文章

有新文章发布或新功能上线时,给你发一封简短的邮件。通过邮件确认一次即可订阅,一键退订。

全部文章