# @flui-cloud/cli 中文文档

规范地址：https://npmcn.com/package/%40flui-cloud/cli/

版本：0\.14\.0
npm 元数据更新时间：2026-11-03T20:41:27.510Z
中文译文更新时间：2026-11-15T02:38:59.929Z
软件包许可：AGPL-3\.0-or-later

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

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

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

- 包体积（解压后）：14.3 MB，2075 个文件
- 模块格式：CommonJS
- TypeScript 类型：未声明
- Node.js 要求：\>=18\.0\.0
- 运行依赖：37 个
- 首次发布：2026-05-18T16:56:30.624Z
- 最新版本发布：2026-11-03T20:41:27.239Z
- 近 30 天下载量：2969（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：35（近 12 个月 35 个）

## 中文简介

Flui的命令行接口——开源平台,在云供应商和自有服务器之间部署应用程序.

## 安装

```sh
npm install @flui-cloud/cli
```

也可以使用：`pnpm add @flui-cloud/cli`、`yarn add @flui-cloud/cli`、`bun add @flui-cloud/cli`

## README

# @flui-cloud/cli (英语)

命令行接口 [流线](https://flui.cloud/) - 开放的 位于您的云端提供者上方的平台层。 创建集群, 部署 来自a的申请 `flui.yaml` 显示,在设施之间切换, 并运行寿命周期结束到从一个二进制结束.

全文 : **[文件:flui.cloud/cli](https://docs.flui.cloud/cli/)**。 。 。 .

## 安装

```bash
npm install -g @flui-cloud/cli       # or: pnpm add -g, yarn global add
flui --version
```

稍后升级,运行 `flui update` ——它自我取代了全球 安装最新发布的版本.

## 快速启动

Flui 是一个现代多云平台层,会变成平地云 服务器进入一个完整的应用程序平台——您保留该软件的所有权 基础设施,没有供应商锁定。 在其中创建您的安装 交互式命令——它需要管理电子邮件和证书 支持的云提供商之一(今天的赫兹纳和斯莱克威; 更多的供应商和在路线图上安装自己的服务器, 然后在几分钟内返回一个环境 准备托管 应用:集群、入侵、TLS、身份、可观察性、, 仪表板 已经接通了.

```bash
flui env create
```

命令流 安装日志直到平台可以到达, 然后打印仪表板、API和OIDC URL。 整个路过 生活状况 [开始](https://docs.flui.cloud/cli/getting-started/)。 。 。 .

## 接下来你能做什么

一旦组群升起,大量工作就不需要额外的整合—— 日常运行安装,检查资源,以及 部署预建的应用程序 :

```bash
flui auth login                              # OIDC against the freshly created installation

flui env status                              # control-cluster health, nodes, capacity
flui env credentials --test                  # print + probe the dashboard / API / OIDC / Grafana URLs

flui app list                                # all apps on the installation
flui app status <name>                       # rollout state, replicas, image
flui app logs <name> --tail 200              # recent logs
flui app metrics <name>                      # CPU / memory / network

flui deploy                                  # deploy a flui.yaml from the current directory
```

用于源创建的应用程序( :`kind: Application`, 由 GitHub 重排建造) 您还需要先连接 GitHub `flui integration connect github` 带有个人进入标志的,建议设置——见 [一体化](https://docs.flui.cloud/cli/integrations/)。 。 。 . 预建目录`kind: CatalogApp`)跳过所有这一切并部署 直接从 `flui deploy` 与任何公共图像注册。 这个 明显参考 [部署](https://docs.flui.cloud/cli/deploy/)。 。 。 .

## 专题

命令分为主题;每个动词都有自己的 `--help`。 。 。 .

| 专题 | 它会做什么 |
| --- | --- |
| `env` | 寿命周期 **控制集群** ——创造,检查,规模,破坏. |
| `cluster` 编号 : `node` | 工作量 -- -- 组群销毁和工人 -- -- 节点增加/删除/列表. |
| `app` | 查看、缩放、重启、快照、重新部署和删除应用程序;读取日志、度量衡和崩溃报告. |
| `deploy` 编号 : `catalog` | 从a部署 `flui.yaml` 显示; 验证下线的显示. |
| `integration` 编号 : `repo` | 连接 GitHub(个人访问符,或Flui GitHub App)并导入寄存器——第一个源建部署的先决条件. |
| `template` | 从 Flui 框架模板创建新寄存器 . |
| `backup` | 管理备份目的地、政策、工作和恢复. |
| `auth` | OIDC登录和长寿的M2M API密钥. |
| `context` 编号 : `config` | 剖面图(同质装置)和分层配置. |
| `server-types` 编号 : `ssh` | 列表提供者服务器大小; SSH 为节点. |
| `dev` | 帮助Flui贡献者(出口机密,SSH隧道). |
| `dns` 编号 : `reconcile` 编号 : `update` | 维修费. |

专题参考页:见 [文件:flui.cloud/cli](https://docs.flui.cloud/cli/)。 。 。 .

## 共同公约

少数旗帜在CLI上反复出现:

-   `-c, --cluster <name|id>` 明确的目标集群。 自动检测 当只有一个人在场的时候.
-   `-o, --output <format>` —— 说 `json` 总是可供脚本使用; 人类形态 `text` 或者说 `table` 取决于命令.
-   `--no-wait` 编号 : `--detach` ——任务排队后立即返回.
-   `-f, --force` 编号 : `-y, --yes` ——在破坏性上跳过确认 操作.
-   `--dry-run` - 打印什么 _将_ 发生在突变的子集上 命令.

与 API 交谈的指令在前列印一个短上下文横幅 运行(活动配置文件 + API URL).

## 磁盘上的配置文件

CLI将每个安装状态保持在 `~/.flui/profiles/<name>/`。一个 profile 持有 API 令牌 需要加密证书才能与提供者交谈, SSH CA 使用 用于集群节点,以及配置文件所知道的本地目录. 路径可以随 `FLUI_DIR` 环境变量.

设施间切换: `flui context use <name>`。 。 。 .

## 链接

-   **联合国** [文件:flui.cloud](https://docs.flui.cloud/)
-   **项目地点:** [风云](https://flui.cloud/)
-   **来源/问题:** [github.com/flui-cloud/core (中文(简体) )](https://github.com/flui-cloud/core)
-   **显示谱 :** [`@flui-cloud/spec`](https://www.npmjs.com/package/@flui-cloud/spec) (单位:千美元)[还原](https://github.com/flui-cloud/flui-spec)(中文(简体) )

## 许可证

AGPL-3.0-或-后传. 见 [`LICENSE`](https://npmcn.com/package/%40flui-cloud/cli/LICENSE)。 。 。 .

## 常见问题

### @flui-cloud/cli 是什么？

Flui的命令行接口——开源平台,在云供应商和自有服务器之间部署应用程序\.

### 如何安装 @flui-cloud/cli？

在项目目录运行 npm install @flui-cloud/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 flui，可以用 npx flui 直接运行。

### @flui-cloud/cli 支持 TypeScript 吗？

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

### @flui-cloud/cli 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @flui-cloud/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @flui-cloud/cli 可以商用吗？

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

### @flui-cloud/cli 的下载量有多少？

根据 npm 官方下载统计，@flui-cloud/cli 在 2026/10/15 – 2026/11/13 这 30 天内被下载 2,969 次，日均约 99 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @flui-cloud/cli 还在维护吗？

最新版本 0\.14\.0 发布于 2026/11/04（12 天前）；至今共发布 35 个版本，其中过去 12 个月发布了 35 个；首次发布于 2026/05/19。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。