Deploy with Void

使用 Void 部署 | Cloudflare 博客

post

JavaScript

2026年10月15日

使用 Void 部署

Christoph Nakazawa 和 Michael Dong

7分钟阅读时间

复制链接

VoidZero 的工具（如 Vite、Vitest、Oxc 和 Rolldown）通过 Vite+ 工具链整合在一起，使前端开发更加高效。但构建全栈应用需要的不仅仅是工具链。这些应用需要服务器路由、数据库、本地开发环境，以及一种快速简便的方式将想法部署到生产环境。

我们很兴奋地开源了三项新产品，将服务器路由、类型化数据访问和 Cloudflare 部署整合到统一的 Vite 工作流中。

• Void 平台：团队用于在 Cloudflare 上托管 Void 应用的共享部署平台。
• Void SDK：用于通过 Vite 构建全栈应用的可组合 JavaScript SDK。
• Void CLI：用于配置资源并将 Vite 应用部署到 Cloudflare 的命令行工具。

CLI 将通过 SDK 构建的应用部署到平台。这三个产品作为单一的 JavaScript 包和 Vite 插件开源，可通过 npm install void 安装。使用 Void，您可以同时构建服务器和客户端，将数据库类型传递到 UI，并让 Void 自动为您应用使用的 Cloudflare 资源进行配置。

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

Void 平台：您公司的云平台

Void 平台完全开源，您可以对其进行分叉并根据需要进行调整，通过集成公司系统、自定义部署工作流程、为客户构建功能或在其他部署平台上使用来适配需求。您可以直接使用平台、通过上游贡献改进，或分叉平台仅构建所需功能。开源代码可以直接使用或作为起点。

作为 Void 平台的管理员，您可以控制访问权限、设置资源限制、通过 Void CLI 或管理仪表板检查部署和使用情况，并提供防护措施，让其他所有人能够将严肃的 vibe 编码应用部署到相同的共享平台。

通过安装 Void 平台，您的团队或客户可以在 Cloudflare 账户的 Workers for Platforms 之上拥有一个共享的部署环境。Void 平台实现以下目标：

• 更快的原型开发：您的团队可以快速构建原型，部署它们并分享可运行的应用以获取反馈，而无需为每个项目设置单独的 Cloudflare 账户或配置资源。这将内部应用的上线时间从天/周缩短到分钟。
• 非技术人员参与开发：此工作流程还允许不常编写代码的团队成员通过编码代理构建和分享自己的应用。设计师可以创建交互式原型，运维同事可以构建内部仪表板，然后将其部署到同一平台。所有操作都配有适当的安全措施。

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

• 启用 Workers for Platforms 和 R2 的 Cloudflare 账户
• 一个 PostgreSQL 数据库
• 您选择的登录提供商的账户
• 用于应用的域名

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

平台设置完成后，授权用户可通过 Void CLI 连接到平台进行部署。

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

开发者使用 Void SDK 构建应用，这正是 Void 平台实现身份验证、框架检测、资源分配等功能的核心。换句话说，Void 平台的运作完全依赖配套的 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 框架的适配器，提供基于文件的 API 路由、预渲染、缓存、岛屿模式以及从数据库到 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
}</
li
>
)
}
</
ul
>
);
}

通过导入 void/db，Void 在开发期间为应用提供本地数据库，并在生产环境自动为您分配 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 路由器专为异步 React 而设计，通过过渡和 Suspense 实现跨页面的响应式导航。当您将此路由器与现代数据框架（如 fate）和 UI 库（如 Astryx）结合使用时，可以通过 React 的过渡机制协调导航、数据获取和突变操作，并在整个应用中实现动作和乐观更新。这些组件共同协作，使您能够构建在快速网络上感觉同步、在较慢网络上优雅降级，并在昂贵的渲染更新期间保持交互响应性的应用。

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

Void CLI：一键部署命令

Void CLI 是 Void 的主要接口，用于管理平台和部署应用。它基于新的 cf CLI 构建，并与代理良好兼容。

使用 Void CLI，您可以让代理帮您调试失败的请求、读取部署日志、分析应用性能，或让代理为您处理完整生命周期，例如部署完成的应用。

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

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

与 CLI 及其代理一样，可以管理 Void 应用的完整生命周期，您也可以使用 CLI 管理 Void 平台：

• 管理用户、项目访问权限和资源
• 检查部署、日志和回滚
• 监控平台健康状况和使用情况

与我们联系

VoidZero 的使命是让 JavaScript 开发者比以往任何时候都更高效。我们将在 Vite+ 中整合 Vite、Rolldown、Oxlint、Oxfmt 和 Vitest，用于开发、打包、代码质量和测试。Void 将这一技术栈扩展到全栈应用开发，让您和您的代理构建、测试和部署完整应用。

我们已在 VoidZero 的生产环境中使用 Void SDK、CLI 和平台数月之久，我们很期待看到您用 Void 构建出什么。请与我们分享您的反馈：

• Discord：加入 Void 社区 Discord 服务器进行实时讨论
• GitHub：星标仓库、发起讨论并报告问题
• 使用 Void 部署应用：快速入门指南
• X / Bluesky：在 X 或 Bluesky 上关注 VoidZero 获取更新

目录列

讨论列

相关标签和社交媒体链接

相关标签

关注社交媒体

• Cloudflare

电子邮件注册