# @k2b/cloud 中文文档

规范地址：https://npmcn.com/package/%40k2b/cloud/

版本：0\.52\.0
npm 元数据更新时间：2026-11-01T11:32:55.069Z
中文译文更新时间：2026-11-01T15:00:22.515Z
软件包许可：AGPL-3\.0-or-later

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40k2b/cloud
原文对照：https://npmcn.com/package/%40k2b/cloud/?lang=original
项目主页：https://github.com/k2b-dev/cloud
源码仓库：https://github.com/k2b-dev/cloud

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：9.4 MB，1193 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：42 个
- peer 依赖：zod ^4\.3\.4，hono ^4\.12\.25，solid-js ^1\.9\.10
- 首次发布：2026-09-09T20:27:44.024Z
- 最新版本发布：2026-11-01T11:32:54.757Z
- 已发布版本数：54（近 12 个月 54 个）

## 中文简介

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

## 安装

```sh
npm install @k2b/cloud
```

也可以使用：`pnpm add @k2b/cloud`、`yarn add @k2b/cloud`、`bun add @k2b/cloud`

## README

![Cloud](https://raw.githubusercontent.com/k2b-dev/cloud/main/packages/cloud/public/logo.svg)

# @k2b /云

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

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

## 安装

```bash
bun add @k2b/cloud
```

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

## 快速启动

```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;
```

```ts
// 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/cloud` | `defineApp`，常见类型 |
| `@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.css` | base Tailwind样式表 |

## 文档

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

-   **[创建第一个应用程序](https://github.com/k2b-dev/cloud/blob/main/docs-site/docs/en/build/getting-started.md)** -独立项目设置和经过验证的API端点
-   **[github.com/k2b-dev/cloud](https://github.com/k2b-dev/cloud)** -平台单orepo（网关，核心，所有平台应用）

## 安全

通过私下报告漏洞 [GitHub安全公告](https://github.com/k2b-dev/cloud/security/advisories/new)， 从来没有在公共问题上。安全补丁出现在此包的变更日志中， 一份公布的公告称第一个补丁版本。看到 [安全策略](https://github.com/k2b-dev/cloud/blob/main/SECURITY.md).

## 许可证

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

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

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

请参阅存储库 `LICENSE` 文件。

## 常见问题

### @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 和提交记录判断。