VoidZero 的工具，如 Vite、Vitest、Oxc 和 Rolldown——作为 Vite+ 打包在一个工具链中——使前端开发更快，但构建全栈应用需要的不仅仅是一个工具栈。这些应用需要服务器路由、数据库、本地开发环境，以及一种快速简便的方式将想法部署到生产环境。

我们很高兴开源三个新产品，将服务器路由、类型化数据访问和 Cloudflare 部署带入统一的 Vite 工作流。

• Void Platform：一个共享部署平台，供团队在 Cloudflare 上托管 Void 应用。

• Void SDK（软件开发工具包）：一个可组合的 JavaScript SDK，用于使用 Vite 构建全栈应用。

• Void CLI：一个 CLI，用于配置资源并将 Vite 应用部署到 Cloudflare。

CLI 将使用 SDK 构建的应用部署到 Platform。所有三个产品都作为一个 JavaScript 包和 Vite 插件开源，你可以通过 npm install void 安装。使用 Void，你可以一起构建服务器和客户端，将类型从数据库传递到 UI，并让 Void 自动配置你的应用使用的 Cloudflare 资源。

我们最初的目标是构建一个单一的私有平台，供所有用户部署应用。在 VoidZero 加入 Cloudflare 后，我们调整了方向，将平台开源并允许任何人安装，因为我们看到了一个日益增长的需求：公司希望鼓励 vibe-coded 内部应用，但担心安全问题，不想给每个员工云访问权限。Void 解决了这个问题。

Void Platform：面向公司的云平台

Void Platform 完全开源，你可以 fork 它并根据需要调整，集成公司系统、自定义部署工作流、为客户构建功能，或使其在其他部署平台上运行。按原样使用平台、向上游贡献改进，或 fork 它并只构建你需要的功能。开源代码可以开箱即用，也可以作为起点。

作为 Void Platform 的管理员，你控制访问权限、设置资源限制、通过 Void CLI 或管理仪表板检查部署和使用情况，并提供护栏，以便其他所有人都可以将严肃的和 vibe coded 的应用发布到同一个共享平台。

通过安装 Void Platform，你的团队或客户在你的 Cloudflare 账户中，基于 Workers for Platforms 拥有一个共享部署环境。Void Platform 支持：

• 更快的原型设计。你的团队可以快速构建原型、部署它们并分享可用的应用以获取反馈，而无需为每个项目设置单独的 Cloudflare 账户或配置资源。这将内部应用的交付时间从数天/数周缩短到数分钟。

• 非技术团队构建。此工作流还允许通常不编写代码的队友与编码智能体合作，构建和分享他们自己的应用。设计师可以创建交互式原型，或运营队友可以构建内部仪表板，然后将其部署到同一平台。所有这些都在适当的安全措施到位的情况下完成。

要自托管 Void 平台，你需要：

• 一个启用了 Workers for Platforms 和 R2 的 Cloudflare 账户

• 一个 PostgreSQL（开源关系型数据库） 数据库

• 一个已选择登录提供商的账户

• 一个用于你的应用的域名

然后通过运行一条命令将 Void 安装为云平台：

平台搭建完成后，已获批准的用户可以通过 Void CLI 连接到平台进行部署。

void connect https://api.orange-company.dev

用户使用 Void SDK 构建应用，Void Platform 的身份验证、框架检测、资源预配等功能正是由该 SDK 提供支持。换言之，Void Platform 之所以能工作，正是因为配套的 SDK 和 CLI。

Void SDK：零配置基础设施

Void 可将 Vite 应用转变为全栈 Cloudflare Workers 应用。你或你的智能体可以编写代码，Void 会在部署期间自动推断资源绑定并预配数据库、队列或 AI 绑定等资源。

要开始使用，请将 Void 添加为 Vite 插件：

import
{ defineConfig }
from
"vite"
;
import
{ voidPlugin }
from
"void"
;
import
{ voidReact }
from
"@void/react/plugin"
;
export
default
defineConfig
({
plugins: [
voidPlugin
(),
voidReact
()],
});

Void SDK 附带适用于 React 和 Vue 等流行 JavaScript UI 框架的适配器，提供基于文件的路由、预渲染、缓存、孤岛（islands）以及从数据库到 UI 的端到端类型安全。

Void 的所有功能都是可选的且可组合的。Void 可与 Vinext、React Router、SvelteKit、Nuxt、TanStack Start 和 Astro 等现有应用框架集成。你可以使用这些框架进行路由和渲染，而 Void 使用 Hono 处理资源 API（应用程序编程接口）、迁移、部署，并使用 Better Auth 处理身份验证。

让我们来看一个构建服务端渲染页面的示例，其类型从数据库查询一直推断到客户端：

// pages/blog.server.ts
import
{ defineHandler,
type
InferProps }
from
'void'
;
import
{ db }
from
'void/db'
;
import
{ posts }
from
'@schema'
;
export
const
loader
=
defineHandler
(
async
()
=>
({
posts:
await
db.
select
().
from
(posts),
}));
export
type
Props
=
InferProps
<
typeof
loader>;

// pages/blog.tsx
export
default
function
Blog
({
posts
}
:
Props
) {
return
(
<
ul
>
{
posts.
map
((
post
)
=><
li
key
=
{
post.id
}>{
post.title
}
)
}

);
}

通过导入 void/db，Void 在开发期间为你的应用提供本地数据库，并让 void deploy 在生产环境中自动为你预配 D1。这同样适用于通过 Cloudflare 的 AI Gateway 使用 AI：只需导入 void/ai，一切都会自动为你配置好。

// routes/api/decide.ts
import
{ defineHandler }
from
'void'
;
import
{ ai }
from
'void/ai'
;
export
const
POST
=
defineHandler
(
async
(
c
)
=>
{
const
{
question
}
=
await
c.req.
json
();
const
result
=
await
ai.
run
(
'@cf/cloudflare/clef'
, {
model:
'clef'
,
state: {},
questions: {
decision: { type:
'noul'
, instructions: question },
},
});
const
probability
=
result.answers.decision.noul;
return
c.
json
({
answer: probability
>=
0.5
?
'yes'
:
'no'
,
probability,
});
});

Void 的 React 路由专为 Async React 构建，使用 transitions 和 Suspense 实现跨屏幕的响应式导航。当你将此路由与 fate 等现代数据框架以及 Astryx 等 UI 库配合使用时，你可以通过 React 的 transitions 协调导航、数据获取和变更，以及在整个应用中实现 actions 和乐观更新。这些部分结合在一起，让你能够构建在快速网络上感觉同步、在较慢网络上优雅降级，并在昂贵的渲染更新期间保持交互响应的应用。

如果用户不需要 Void Platform 的团队管理功能，可以使用自己的 Cloudflare 账户。Void SDK 也可以直接部署到 Cloudflare。

Void CLI：一条部署命令

Void CLI 是 Void 的主要接口。CLI 负责管理平台并部署应用。它构建于新的 cf CLI 之上，并且与智能体配合良好。

使用 Void CLI，你可以让智能体调试失败的请求、读取部署日志、分析应用运行状况，或者让它们负责完整生命周期，为你部署已完成的应用。

当你的应用准备好部署到 Cloudflare 时，可以运行：

首次运行 void deploy 时，CLI 会提示你登录 Cloudflare 账户。Void 使用 Vite 构建应用、应用迁移、自动配置资源，并部署到 Cloudflare 或 Void Platform。它可用于处理项目的完整生命周期，例如构建、部署以及管理资源和项目，例如：

与 CLI（以及由此扩展的智能体）管理 Void 应用完整生命周期的方式类似，你也可以使用 CLI 管理 Void Platform：

• 管理用户、项目访问权限和资源

• 检查部署、日志和回滚

• 监控平台健康状况和使用情况

转载声明：本文为转载整理，原文版权归原作者及原站点所有。

原文来源：Cloudflare Blog

原创地址：https://blog.cloudflare.com/deploy-with-void/