# @fastly/cli 中文文档

规范地址：https://npmcn.com/package/%40fastly/cli/

版本：17\.1\.0
npm 元数据更新时间：2026-11-12T16:34:39.207Z
中文译文更新时间：2026-11-14T11:17:46.058Z
软件包许可：Apache-2\.0

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

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

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

- 包体积（解压后）：24.3 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=16
- 运行依赖：0 个
- 首次发布：2024-08-15T14:12:13.681Z
- 最新版本发布：2026-11-12T16:34:38.805Z
- 近 30 天下载量：1111379（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：43（近 12 个月 23 个）

## 中文简介

从终端构建、部署和配置快速服务

## 安装

```sh
npm install @fastly/cli
```

也可以使用：`pnpm add @fastly/cli`、`yarn add @fastly/cli`、`bun add @fastly/cli`

## README

### 快速的 CLI

与快活平台互动的 CLI.

[![Documentation](https://img.shields.io/badge/cli-reference-yellow)](https://www.fastly.com/documentation/reference/cli) [![Latest release](https://img.shields.io/github/v/release/fastly/cli)](https://github.com/fastly/cli/releases/latest) [![Apache 2.0 License](https://img.shields.io/github/license/fastly/cli)](https://npmcn.com/package/%40fastly/cli/#readme-License) [![Go Report Card](https://goreportcard.com/badge/github.com/fastly/cli)](https://goreportcard.com/report/github.com/fastly/cli)

## 快速链接

-   [安装](https://www.fastly.com/documentation/reference/tools/cli#installing)
-   [壳牌自动补全](https://www.fastly.com/documentation/reference/tools/cli#shell-auto-completion)
-   [配置](https://www.fastly.com/documentation/reference/tools/cli#configuring)
-   [认证](https://fastly.help/cli/cli-auth) (单位:千美元)`fastly auth login`(中文(简体) )
-   [图标](https://www.fastly.com/documentation/reference/cli#command-groups)
-   [发展](https://github.com/fastly/cli/blob/main/DEVELOPMENT.md)
-   [测试](https://github.com/fastly/cli/blob/main/TESTING.md)
-   [问题](https://github.com/fastly/cli/blob/main/ISSUES.md)
-   [文档](https://github.com/fastly/cli/blob/main/DOCUMENTATION.md)

## 环境变量

| 变量 | 说明 |
| --- | --- |
| `FASTLY_API_TOKEN` | 用于认证的快速API令牌. |
| `FASTLY_DISABLE_AUTH_COMMAND` | 当设定( 任何非空值) 时, 所有与认证相关的命令 (`auth`, (中文(简体) ), `auth-token`, (中文(简体) ), `sso`, (中文(简体) ), `profile`, (中文(简体) ), `whoami`)和 `--token`编号 :`-t` 全球旗帜已禁用 。 认证是通过 `FASTLY_API_TOKEN` 或预配置的已存储的符号。 背景SSO流量不受影响. |

## 版本和发布时间表

本单元的维护者努力维护 [语义版本 (声)](https://semver.org/)。这意味着打破变化 (功能的去除,或与现有 功能)将随第一版一同发布 构成部分`major`)递增. 特性增加将增加 第二版组件`minor`),和不受影响的错误修正 兼容性将增加第三版组件(`patch`) (中文(简体) ).

每个月的第二个星期三,将出版一期 包括所有已准备好的断开、特性和错误修正更改 供释出. 如果星期三恰好是美国节日的话 释放将推迟到下一个工作日.

如果关键或紧急错误修复准备在两者之间释放 将视需要进行主要释放、补丁释放,以便 可用修正.

## 捐款

参见 [捐款额](https://github.com/fastly/cli/blob/main/CONTRIBUTING.md)

## 问题

如果你遇到任何与安全无关的错误或意外行为,请 [提交问题](https://github.com/fastly/cli/issues/new?labels=bug&template=bug_report.md) 使用错误报告模板.

请检查一下 [变化](https://github.com/fastly/cli/blob/main/CHANGELOG.md) 用于任何突破性改变或移民指导.

### 安全问题

请看我们的 [警卫](https://npmcn.com/package/%40fastly/cli/SECURITY.md) 指导如何报告与安全有关的问题.

## 未释放变化的二进制

二进制包含计划在下一期发布的合并更改 [这里](https://github.com/fastly/cli/actions/workflows/merge_to_main.yml)。 。 。 . 自己冒险使用. 更新将会将二进制重回最新发布的版本 .

## 许可证

[Apache 2.0 (英语)](https://npmcn.com/package/%40fastly/cli/LICENSE)。 。 。 .

## 常见问题

### @fastly/cli 是什么？

从终端构建、部署和配置快速服务

### 如何安装 @fastly/cli？

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

### @fastly/cli 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fastly/cli 支持 ESM 还是 CommonJS？

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

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

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

### @fastly/cli 可以商用吗？

@fastly/cli 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @fastly/cli 的下载量有多少？

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

### @fastly/cli 还在维护吗？

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