@k2b/cloud

中文文档
0.52.0发布于 2026/11/01AGPL-3.0-or-laterES Module构建来源已验证

应用程序平台库,用于独立部署Hono和SolidJS服务,背后是一个动态网关。

中文使用文档
文档目录6 节
  1. 安装
  2. 快速启动
  3. 公共建筑模块
  4. 文档
  5. 安全
  6. 许可证

Cloud

@k2b /云

模块化Hono+SolidJS框架,用于在动态网关后构建每个应用的docker服务。

运行时为 github.com/k2b-dev/cloud -一个运行在你运营的基础设施上的应用程序平台,其中每个功能都作为自己的Bun容器发布,通过Redis向网关注册,并继承共享会话、UI工具包、设置存储、搜索、日志、电子邮件、websockets和管理界面。

安装

bun add @k2b/cloud

包发布为 .ts 源。它的目的是 包子 消费者。

快速启动

// packages/my-app/src/config.ts
import { defineApp } from "@k2b/cloud";

export const app = defineApp({
  id: "my-app",
  name: "My App",
  icon: "ti ti-rocket",
  description: "What this app does",
  basePath: "/app/my-app",
  baseUrl: "http://app-my-app:3000",
  nav: { href: "/app/my-app", section: "more", requiresAuth: true },
  routes: ["/api/my-app", "/app/my-app", "/admin/my-app", "/public/my-app"],
});

export const { ssr, plugin } = app;
// packages/my-app/src/index.ts
import { app } from "./config";
import { Hono } from "hono";

export default await app.start({
  routes: {
    api: new Hono().get("/", (c) => c.json({ ok: true })),
    pages: new Hono().get("/", ...ssr(() => () => <div>hello</div>)),
  },
});

一个标准的应用程序声明四个前缀(/api/<id>, /app/<id>, /admin/<id>, /public/<id>);网关通过URL前缀将它们从redis支持的注册表路由到您的容器。

公共建筑模块

进口使用
@k2b/clouddefineApp,常见类型
@k2b/cloud/server服务器上下文,授权,路由助手
@k2b/cloud/browser键入浏览器客户端
@k2b/cloud/services设置,日志,通知,搜索
@k2b/cloud/contracts共享公共合同
@k2b/cloud/ssr云SSR助手和岛屿
@k2b/cloud/workflows持久的、可检查的应用程序工作流
@k2b/cloud/ai人工智能和工具调用契约
@k2b/cloud/cli应用命令行
@k2b/cloud/config文档化的配置助手
@k2b/ui可移植UI组件和应用程序布局
@k2b/stdlib/solid所有者本地查询、突变和交互原语
@k2b/ssr便携式SolidJS SSR,岛屿和导航
@k2b/sync分布式协调、作业、队列和调度器
@k2b/cloud/access/ui云访问和资源密钥控制
@k2b/cloud/account/ui云帐户选择器和头像
@k2b/cloud/ai/ui云AI协议适配器
@k2b/cloud/styles/global.cssbase Tailwind样式表

文档

应用程序设置、公共契约和部署指导:

安全

通过私下报告漏洞 GitHub安全公告, 从来没有在公共问题上。安全补丁出现在此包的变更日志中, 一份公布的公告称第一个补丁版本。看到 安全策略.

许可证

GNU Affero通用公共许可证v3.0或更高版本。

商业使用、托管、修改和再分发是被允许的 AGPL。如果你修改Cloud,让用户通过网络与它互动, 类下的相应源代码的访问权限必须提供给这些用户 相同的许可。

单独的商业许可用于专有,转售,管理服务, 通过联系维护人员,可以使用白标或嵌入式产品。

请参阅存储库 LICENSE 文件。

版本与发布记录

@k2b/cloud 共发布 54 个版本,首次发布于 2026/09/10;过去 12 个月发布了 54 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.52.0latest2026/11/012 天前
0.51.02026/11/012 天前
0.50.02026/11/012 天前
0.49.02026/11/012 天前
0.48.02026/10/313 天前
0.47.02026/10/313 天前

关于 @k2b/cloud 的常见问题

@k2b/cloud 是什么?

应用程序平台库,用于独立部署Hono和SolidJS服务,背后是一个动态网关。

如何安装 @k2b/cloud?

在项目目录运行 npm install @k2b/cloud,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:zod(^4.3.4)、hono(^4.12.25)、solid-js(^1.9.10)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@k2b/cloud 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/k2b__cloud 是否存在。

@k2b/cloud 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@k2b/cloud 可以商用吗?

@k2b/cloud 使用 AGPL-3.0-or-later 许可。最严格的 Copyleft:除分发外,通过网络向用户提供基于它的服务也需要开源对应源码。闭源 SaaS 使用前务必评估。以上为概括,不构成法律意见,请以许可原文为准。

@k2b/cloud 还在维护吗?

最新版本 0.52.0 发布于 2026/11/01(2 天前);至今共发布 54 个版本,其中过去 12 个月发布了 54 个;首次发布于 2026/09/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。