# @fonoster/ctl 中文文档

规范地址：https://npmcn.com/package/%40fonoster/ctl/

版本：0\.62\.0
npm 元数据更新时间：2026-11-15T18:00:31.353Z
中文译文更新时间：2026-11-15T04:22:01.817Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：596 kB，214 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：13 个
- 首次发布：2021-11-01T01:13:08.547Z
- 最新版本发布：2026-11-15T18:00:30.951Z
- 近 30 天下载量：6750（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：334（近 12 个月 68 个）

## 中文简介

长老会控制工具

## 安装

```sh
npm install @fonoster/ctl
```

也可以使用：`pnpm add @fonoster/ctl`、`yarn add @fonoster/ctl`、`bun add @fonoster/ctl`

## README

# 缩略语

长老会议指挥线

[![command-line tool](https://img.shields.io/badge/ctl-oclif-brightgreen.svg)](https://fonoster.com/) [![Version](https://img.shields.io/npm/v/@fonoster/ctl.svg)](https://npmjs.org/package/@fonoster/voice) [![Downloads/week](https://img.shields.io/npm/dw/@fonoster/ctl.svg)](https://npmjs.org/package/@fonoster/voice) [![License](https://img.shields.io/npm/l/@fonoster/ctl.svg)](https://github.com/fonoster/fonoster/blob/main/package.json)

使用此工具从命令行管理您的长老会资源 。 通过这个工具,您可以创建,更新,并删除应用程序,数字,SIP代理等资源,等等.

在新平台上: `applications:*` 管理流( 您的 WebSocket 服务器: URL, 协议, 语音默认为目录 ID, 收听者, 记录, 倒计时) 和 Autopilot 代理(`--agent`(三); `webhooks:*` 管理工作空间网点及其发送日志; `records:*` 搜索通话记录和下载录音及vCons; `providers:*` 列出供应商目录并管理工作空间的供应商密钥。 见 [尝试新平台](https://npmcn.com/package/docs/try-the-new-platform.md#from-the-terminal)。 。 。 .

> 连接到您自己的例子时, 请记住在登录时使用您的端点 。 如果您的安装使用了生成的证书, 请相信它 `--ca-file <path to its config/tls/ca.pem>` (或 `FONOSTER_CA_FILE`) (中文(简体) ). CLI总是使用TLS.

-   [使用量](https://npmcn.com/package/%40fonoster/ctl/#readme-usage)
-   [图标](https://npmcn.com/package/%40fonoster/ctl/#readme-commands)

# 使用量

```sh-session
$ npm install -g @fonoster/ctl
$ fonoster COMMAND
running command...
$ fonoster (--version)
@fonoster/ctl/0.52.1 darwin-arm64 node-v22.23.3
$ fonoster --help [COMMAND]
USAGE
  $ fonoster COMMAND
...
```

# 图标

-   [`fonoster apikeys:create`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-apikeyscreate)
-   [`fonoster apikeys:delete REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-apikeysdelete-ref)
-   [`fonoster apikeys:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-apikeyslist)
-   [`fonoster apikeys:rotate REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-apikeysrotate-ref)
-   [`fonoster applications:create`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-applicationscreate)
-   [`fonoster applications:delete REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-applicationsdelete-ref)
-   [`fonoster applications:eval`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-applicationseval)
-   [`fonoster applications:get REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-applicationsget-ref)
-   [`fonoster applications:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-applicationslist)
-   [`fonoster applications:rotate-secret REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-applicationsrotate-secret-ref)
-   [`fonoster applications:update [REF]`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-applicationsupdate-ref)
-   [`fonoster bug`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-bug)
-   [`fonoster feedback`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-feedback)
-   [`fonoster mcp:configure`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-mcpconfigure)
-   [`fonoster providers:catalog`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-providerscatalog)
-   [`fonoster providers:keys:delete PROVIDER`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-providerskeysdelete-provider)
-   [`fonoster providers:keys:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-providerskeyslist)
-   [`fonoster providers:keys:set PROVIDER`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-providerskeysset-provider)
-   [`fonoster records:download REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-recordsdownload-ref)
-   [`fonoster records:get REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-recordsget-ref)
-   [`fonoster records:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-recordslist)
-   [`fonoster secrets:create`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-secretscreate)
-   [`fonoster secrets:delete REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-secretsdelete-ref)
-   [`fonoster secrets:get REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-secretsget-ref)
-   [`fonoster secrets:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-secretslist)
-   [`fonoster secrets:update REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-secretsupdate-ref)
-   [`fonoster sipnet:acls:create`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetaclscreate)
-   [`fonoster sipnet:acls:delete REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetaclsdelete-ref)
-   [`fonoster sipnet:acls:get REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetaclsget-ref)
-   [`fonoster sipnet:acls:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetaclslist)
-   [`fonoster sipnet:acls:update REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetaclsupdate-ref)
-   [`fonoster sipnet:agents:create`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetagentscreate)
-   [`fonoster sipnet:agents:delete REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetagentsdelete-ref)
-   [`fonoster sipnet:agents:get REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetagentsget-ref)
-   [`fonoster sipnet:agents:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetagentslist)
-   [`fonoster sipnet:agents:update REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetagentsupdate-ref)
-   [`fonoster sipnet:calls:create`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetcallscreate)
-   [`fonoster sipnet:calls:get REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetcallsget-ref)
-   [`fonoster sipnet:calls:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetcallslist)
-   [`fonoster sipnet:credentials:create`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetcredentialscreate)
-   [`fonoster sipnet:credentials:delete REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetcredentialsdelete-ref)
-   [`fonoster sipnet:credentials:get REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetcredentialsget-ref)
-   [`fonoster sipnet:credentials:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetcredentialslist)
-   [`fonoster sipnet:credentials:update REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetcredentialsupdate-ref)
-   [`fonoster sipnet:domains:create`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetdomainscreate)
-   [`fonoster sipnet:domains:delete REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetdomainsdelete-ref)
-   [`fonoster sipnet:domains:get REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetdomainsget-ref)
-   [`fonoster sipnet:domains:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetdomainslist)
-   [`fonoster sipnet:domains:update REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetdomainsupdate-ref)
-   [`fonoster sipnet:numbers:create`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetnumberscreate)
-   [`fonoster sipnet:numbers:delete REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetnumbersdelete-ref)
-   [`fonoster sipnet:numbers:get REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetnumbersget-ref)
-   [`fonoster sipnet:numbers:linkTwilio PHONENUMBER`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetnumberslinktwilio-phonenumber)
-   [`fonoster sipnet:numbers:linkTwilioNumber PHONENUMBER`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetnumberslinktwilionumber-phonenumber)
-   [`fonoster sipnet:numbers:linkWhatsApp [PHONENUMBER]`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetnumberslinkwhatsapp-phonenumber)
-   [`fonoster sipnet:numbers:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetnumberslist)
-   [`fonoster sipnet:numbers:update REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnetnumbersupdate-ref)
-   [`fonoster sipnet:trunks:create`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnettrunkscreate)
-   [`fonoster sipnet:trunks:delete REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnettrunksdelete-ref)
-   [`fonoster sipnet:trunks:get REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnettrunksget-ref)
-   [`fonoster sipnet:trunks:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnettrunkslist)
-   [`fonoster sipnet:trunks:update REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-sipnettrunksupdate-ref)
-   [`fonoster webhooks:create`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-webhookscreate)
-   [`fonoster webhooks:delete REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-webhooksdelete-ref)
-   [`fonoster webhooks:deliveries [REF]`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-webhooksdeliveries-ref)
-   [`fonoster webhooks:get REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-webhooksget-ref)
-   [`fonoster webhooks:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-webhookslist)
-   [`fonoster webhooks:resend REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-webhooksresend-ref)
-   [`fonoster webhooks:rotate REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-webhooksrotate-ref)
-   [`fonoster webhooks:update REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-webhooksupdate-ref)
-   [`fonoster workspaces:active`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-workspacesactive)
-   [`fonoster workspaces:list`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-workspaceslist)
-   [`fonoster workspaces:login`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-workspaceslogin)
-   [`fonoster workspaces:logout REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-workspaceslogout-ref)
-   [`fonoster workspaces:use REF`](https://npmcn.com/package/%40fonoster/ctl/#readme-fonoster-workspacesuse-ref)

## `fonoster apikeys:create`

为活动的工作空间创建 API 密钥

```
USAGE
  $ fonoster apikeys:create [--ca-file <value>] [-e <value>] [-r <value>]

FLAGS
  -e, --expiration=<value>  API Key expiration time in days(e.g. 10d) or months(e.g. 10m)
  -r, --role=<value>        [default: WORKSPACE_ADMIN] API Key role
      --ca-file=<value>     a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                            (default: FONOSTER_CA_FILE)

DESCRIPTION
  create an API key for the active Workspace

EXAMPLES
  $ fonoster apikeys:create
```

_参见代码 : [dist/commands/ apikeys/create.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/apikeys/create.js)_

## `fonoster apikeys:delete REF`

从活动的工作空间中删除 API 密钥

```
USAGE
  $ fonoster apikeys:delete REF [--ca-file <value>]

ARGUMENTS
  REF  the ApiKey to delete from the Workspace

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  delete an API key from the active Workspace

EXAMPLES
  $ fonoster apikeys:delete
```

_参见代码 : [dist/commands/ apikeys/ delete.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/apikeys/delete.js)_

## `fonoster apikeys:list`

在活动的工作空间中显示全部 API 密钥

```
USAGE
  $ fonoster apikeys:list [--ca-file <value>] [-s <value>]

FLAGS
  -s, --page-size=<value>  [default: 1000] the number of items to show
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  display all API keys in the active Workspace

EXAMPLES
  $ fonoster apikeys:list
```

_参见代码 : [调离/命令/ apikeys/ list.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/apikeys/list.js)_

## `fonoster apikeys:rotate REF`

生成 API 密钥的新访问密钥

```
USAGE
  $ fonoster apikeys:rotate REF [--ca-file <value>]

ARGUMENTS
  REF  the API key to rotate

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  generate a new access key secret for an API key

EXAMPLES
  $ fonoster apikeys:rotate
```

_参见代码 : [dist/commands/ apikeys/ rotate.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/apikeys/rotate.js)_

## `fonoster applications:create`

为活动的工作空间添加新应用程序

```
USAGE
  $ fonoster applications:create [--ca-file <value>] [-f <value>] [-n <value>] [-u <value>] [--protocol fonoster|twilio]
    [-a <value>] [--voice <value>] [--language <value>] [--stt-model <value>] [--tts-model <value>] [--silence-timeout
    <value>] [--patience low|normal|high] [--speed <value>] [--audio-codec pcm16|pcmu] [--audio-rate <value>]
    [--fallback-app <value>] [--fallback-message <value>] [-l <value>...] [--clear-listeners] [--recording off|on]
    [--amd] [--amd-window <value>] [--noise-cancelling <value>]

FLAGS
  -a, --agent=<value>             a YAML or JSON agent file; makes it an Autopilot agent (hosted by Fonoster)
  -f, --from-file=<value>         a YAML or JSON file with the Application (an `agent` key makes it an Autopilot agent)
  -l, --listener=<value>...       a listen-only socket: <wss-url>[,inbound|outbound|both] (repeatable, at most 4)
  -n, --name=<value>              the Application name
  -u, --url=<value>               the stream's WebSocket URL (ws:// or wss://)
      --[no-]amd                  answering-machine detection: the app gets one amd.result per call (--no-amd turns it
                                  off)
      --amd-window=<value>        milliseconds of caller audio AMD classifies (500 to 15000, default 4000); implies
                                  --amd
      --audio-codec=<option>      audio frames for fonoster-protocol streams
                                  <options: pcm16|pcmu>
      --audio-rate=<value>        audio sample rate for fonoster-protocol streams: 8000, 16000 or 24000 (pcmu is 8000
                                  only)
      --ca-file=<value>           a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                                  (default: FONOSTER_CA_FILE)
      --clear-listeners           remove the current listeners (update; combine with --listener to replace)
      --fallback-app=<value>      the Application to hand the call to when this one fails
      --fallback-message=<value>  what the caller hears when the app fails and no fallback app answers
      --language=<value>          speech language (e.g. en-US)
      --noise-cancelling=<value>  noise cancelling on the caller's audio: none, or a noise-cancelling provider in your
                                  catalog (such as aicoustics)
      --patience=<option>         how long to wait before taking the turn
                                  <options: low|normal|high>
      --protocol=<option>         the protocol the stream speaks
                                  <options: fonoster|twilio>
      --recording=<option>        the recording policy
                                  <options: off|on>
      --silence-timeout=<value>   milliseconds of caller silence before a silence event
      --speed=<value>             speech speed, from 0.7 to 1.2; 1.0 is the voice's normal pace
      --stt-model=<value>         STT model as a catalog id (e.g. deepgram/nova-3)
      --tts-model=<value>         TTS model as a catalog id (e.g. deepgram/aura-2)
      --voice=<value>             TTS voice as a catalog id (e.g. deepgram/aura-2-thalia-en)

DESCRIPTION
  add a new Application to the active Workspace

EXAMPLES
  $ fonoster applications:create --name Bot --url wss://bot.example.com/session

  $ fonoster applications:create --name Bot --url wss://bot.example.com/media --protocol twilio

  $ fonoster applications:create --name Receptionist --agent agent.yaml --voice deepgram/aura-2-thalia-en

  $ fonoster applications:create --from-file app.yaml

  $ fonoster applications:create   # asks for the basics
```

_参见代码 : [命令/命令/应用程序/创建.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/applications/create.js)_

## `fonoster applications:delete REF`

从活动的工作空间删除应用程序

```
USAGE
  $ fonoster applications:delete REF [--ca-file <value>]

ARGUMENTS
  REF  the Application to delete

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  delete an Application from the active Workspace

EXAMPLES
  $ fonoster applications:delete
```

_参见代码 : [dent/命令/应用程序/删除.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/applications/delete.js)_

## `fonoster applications:eval`

测试自动驾驶代理的实验命令

```
USAGE
  $ fonoster applications:eval -f <value> [--ca-file <value>] [-o pretty|json] [--output-file <value>] [--model
    <value>] [--repeat <value>] [--max-first-token-p50 <value>] [--max-first-token-p95 <value>] [--min-tool-pass
    <value>] [--min-step-pass <value>]

FLAGS
  -f, --file=<value>                 (required) path to test cases file (json, yaml, or yml)
  -o, --output=<option>              [default: pretty] output format
                                     <options: pretty|json>
      --ca-file=<value>              a PEM file of certificate authorities to trust, such as an install's
                                     config/tls/ca.pem (default: FONOSTER_CA_FILE)
      --max-first-token-p50=<value>  fail if the median time to first token is above this, in ms
      --max-first-token-p95=<value>  fail if the p95 time to first token is above this, in ms
      --min-step-pass=<value>        fail if fewer than this percent of steps pass
      --min-tool-pass=<value>        fail if fewer than this percent of tool steps are right
      --model=<value>                catalog id of the language model to test, instead of the one in the file
      --output-file=<value>          write JSON summary to this file (with pretty: also show streamed output)
      --repeat=<value>               [default: 1] how many times to run the test cases; above 1, prints only the summary

DESCRIPTION
  experimental command to test an Autopilot agent

EXAMPLES
  $ fonoster applications:eval -f agent.json

  $ fonoster applications:eval -f agent.yaml

  $ fonoster applications:eval -f agent.yaml -o json

  $ fonoster applications:eval -f agent.yaml -o json --output-file results.json
```

_参见代码 : [命令/命令/应用程序/eval.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/applications/eval.js)_

## `fonoster applications:get REF`

通过引用获取应用程序的细节

```
USAGE
  $ fonoster applications:get REF [--ca-file <value>]

ARGUMENTS
  REF  The Application to show details about

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  retrieve details of an Application by reference

EXAMPLES
  $ fonoster applications:get <ref>
```

_参见代码 : [dist/命令/应用程序/get.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/applications/get.js)_

## `fonoster applications:list`

在活动的工作空间中显示所有应用程序

```
USAGE
  $ fonoster applications:list [--ca-file <value>] [-s <value>]

FLAGS
  -s, --page-size=<value>  [default: 1000] the number of items to show
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  display all Applications in the active Workspace

EXAMPLES
  $ fonoster applications:list
```

_参见代码 : [dist/命令/应用程序/列表.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/applications/list.js)_

## `fonoster applications:rotate-secret REF`

为应用程序发布新的签名秘密( 旧程序停止工作)

```
USAGE
  $ fonoster applications:rotate-secret REF [--ca-file <value>]

ARGUMENTS
  REF  the Application whose secret to rotate

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  issue a new signing secret for an Application (the old one stops working)

EXAMPLES
  $ fonoster applications:rotate-secret <ref>
```

_参见代码 : [dist/commands/应用程序/轮调-secret.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/applications/rotate-secret.js)_

## `fonoster applications:update [REF]`

修改应用程序(只有您通过更改的字段)

```
USAGE
  $ fonoster applications:update [REF] [--ca-file <value>] [-f <value>] [-n <value>] [-u <value>] [--protocol
    fonoster|twilio] [-a <value>] [--voice <value>] [--language <value>] [--stt-model <value>] [--tts-model <value>]
    [--silence-timeout <value>] [--patience low|normal|high] [--speed <value>] [--audio-codec pcm16|pcmu] [--audio-rate
    <value>] [--fallback-app <value>] [--fallback-message <value>] [-l <value>...] [--clear-listeners] [--recording
    off|on] [--amd] [--amd-window <value>] [--noise-cancelling <value>]

ARGUMENTS
  [REF]  the Application to update (optional when `ref` is set in --from-file)

FLAGS
  -a, --agent=<value>             a YAML or JSON agent file; makes it an Autopilot agent (hosted by Fonoster)
  -f, --from-file=<value>         a YAML or JSON file with the Application (an `agent` key makes it an Autopilot agent)
  -l, --listener=<value>...       a listen-only socket: <wss-url>[,inbound|outbound|both] (repeatable, at most 4)
  -n, --name=<value>              the Application name
  -u, --url=<value>               the stream's WebSocket URL (ws:// or wss://)
      --[no-]amd                  answering-machine detection: the app gets one amd.result per call (--no-amd turns it
                                  off)
      --amd-window=<value>        milliseconds of caller audio AMD classifies (500 to 15000, default 4000); implies
                                  --amd
      --audio-codec=<option>      audio frames for fonoster-protocol streams
                                  <options: pcm16|pcmu>
      --audio-rate=<value>        audio sample rate for fonoster-protocol streams: 8000, 16000 or 24000 (pcmu is 8000
                                  only)
      --ca-file=<value>           a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                                  (default: FONOSTER_CA_FILE)
      --clear-listeners           remove the current listeners (update; combine with --listener to replace)
      --fallback-app=<value>      the Application to hand the call to when this one fails
      --fallback-message=<value>  what the caller hears when the app fails and no fallback app answers
      --language=<value>          speech language (e.g. en-US)
      --noise-cancelling=<value>  noise cancelling on the caller's audio: none, or a noise-cancelling provider in your
                                  catalog (such as aicoustics)
      --patience=<option>         how long to wait before taking the turn
                                  <options: low|normal|high>
      --protocol=<option>         the protocol the stream speaks
                                  <options: fonoster|twilio>
      --recording=<option>        the recording policy
                                  <options: off|on>
      --silence-timeout=<value>   milliseconds of caller silence before a silence event
      --speed=<value>             speech speed, from 0.7 to 1.2; 1.0 is the voice's normal pace
      --stt-model=<value>         STT model as a catalog id (e.g. deepgram/nova-3)
      --tts-model=<value>         TTS model as a catalog id (e.g. deepgram/aura-2)
      --voice=<value>             TTS voice as a catalog id (e.g. deepgram/aura-2-thalia-en)

DESCRIPTION
  modify an Application (only the fields you pass change)

EXAMPLES
  $ fonoster applications:update <ref> --voice deepgram/aura-2-thalia-en --patience high

  $ fonoster applications:update <ref> --agent agent.yaml

  $ fonoster applications:update <ref> --clear-listeners --listener wss://rec.example.com/ws,inbound

  $ fonoster applications:update <ref> --noise-cancelling aicoustics

  $ fonoster applications:update --from-file app.yaml   # with `ref` in the file
```

_参见代码 : [dist/命令/应用程序/更新.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/applications/update.js)_

## `fonoster bug`

向开发团队报告错误qq

```
USAGE
  $ fonoster bug

DESCRIPTION
  report a bug to the development team 🐞

EXAMPLES
  $ fonoster bug
```

_参见代码 : [函数/命令/ bug.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/bug.js)_

## `fonoster feedback`

提供经验反馈

```
USAGE
  $ fonoster feedback

DESCRIPTION
  provide feedback on your experience
  ...
  Help us improve by providing some feedback


EXAMPLES
  $ fonoster feedback
```

_参见代码 : [脱发/命令/反馈.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/feedback.js)_

## `fonoster mcp:configure`

配置 MCP 客户端设置

```
USAGE
  $ fonoster mcp:configure [-c claude] [-w <value>]

FLAGS
  -c, --client=<option>    [default: claude] MCP client to configure
                           <options: claude>
  -w, --workspace=<value>  workspace reference

DESCRIPTION
  configure MCP client settings

EXAMPLES
  $ fonoster mcp:configure --client claude

  $ fonoster mcp:configure --client claude --workspace my-workspace
```

_参见代码 : [dist/ commands/ mcp/ 配置.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/mcp/configure.js)_

## `fonoster providers:catalog`

列出提供者目录: 提供者、 模型和语音应用程序可以使用( catalog ids)

```
USAGE
  $ fonoster providers:catalog [--ca-file <value>] [-k provider|model|voice] [-t stt|tts|llm|nc]

FLAGS
  -k, --kind=<option>    only this kind of item
                         <options: provider|model|voice>
  -t, --type=<option>    only this capability
                         <options: stt|tts|llm|nc>
      --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                         (default: FONOSTER_CA_FILE)

DESCRIPTION
  list the provider catalog: the providers, models and voices apps can use (catalog ids)

EXAMPLES
  $ fonoster providers:catalog

  $ fonoster providers:catalog --kind voice

  $ fonoster providers:catalog --kind model --type stt
```

_参见代码 : [dist/命令/提供者/目录.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/providers/catalog.js)_

## `fonoster providers:keys:delete PROVIDER`

移除销售商的工作空间的密钥( 如果有的话, 呼叫会回到平台的密钥)

```
USAGE
  $ fonoster providers:keys:delete PROVIDER [--ca-file <value>]

ARGUMENTS
  PROVIDER  the provider id

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  remove the Workspace's key for a vendor (calls fall back to the platform's key, if any)

EXAMPLES
  $ fonoster providers:keys:delete deepgram
```

_参见代码 : [dist/命令/提供者/钥匙/删除.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/providers/keys/delete.js)_

## `fonoster providers:keys:list`

列出工作空间拥有自己的密钥的供应商( 密钥从未显示)

```
USAGE
  $ fonoster providers:keys:list [--ca-file <value>]

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  list the vendors the Workspace has its own key for (keys are never shown)

EXAMPLES
  $ fonoster providers:keys:list
```

_参见代码 : [dist/命令/提供者/钥匙/清单.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/providers/keys/list.js)_

## `fonoster providers:keys:set PROVIDER`

设置语音或 LLM 供应商的 Workspace 自己的密钥( 替换任何先前的密钥)

```
USAGE
  $ fonoster providers:keys:set PROVIDER [--ca-file <value>] [--key <value>]

ARGUMENTS
  PROVIDER  the provider id (see providers:catalog --kind provider)

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)
  --key=<value>      the vendor key (omit to type it without echo)

DESCRIPTION
  set the Workspace's own key for a speech or LLM vendor (replaces any previous key)

EXAMPLES
  $ fonoster providers:keys:set deepgram            # asks for the key

  $ fonoster providers:keys:set elevenlabs --key $ELEVENLABS_API_KEY
```

_参见代码 : [dist/命令/提供者/钥匙/套件.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/providers/keys/set.js)_

## `fonoster records:download REF`

保存调用记录( WAV)、 vCon( JSON) 或签名的 vCon( JWS) 到文件

```
USAGE
  $ fonoster records:download REF [--ca-file <value>] [-p recording|vcon|signed] [-o <value>] [--version <value>]
    [--original]

ARGUMENTS
  REF  the call (callRef)

FLAGS
  -o, --output=<value>   the file to write (default <call-ref>.<ext>)
  -p, --part=<option>    [default: recording] what to download
                         <options: recording|vcon|signed>
      --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                         (default: FONOSTER_CA_FILE)
      --original         the unredacted record (owner or admin)
      --version=<value>  a record version (default latest)

DESCRIPTION
  save a call's recording (WAV), vCon (JSON) or signed vCon (JWS) to a file

EXAMPLES
  $ fonoster records:download <call-ref>                 # <call-ref>.wav

  $ fonoster records:download <call-ref> --part vcon -o call.json

  $ fonoster records:download <call-ref> --part signed   # verifiable JWS
```

_参见代码 : [dist/命令/记录/下载.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/records/download.js)_

## `fonoster records:get REF`

显示呼叫记录摘要( 文件使用记录:下载)

```
USAGE
  $ fonoster records:get REF [--ca-file <value>] [--version <value>] [--original]

ARGUMENTS
  REF  the call (callRef)

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)
  --original         the unredacted record (owner or admin)
  --version=<value>  a record version (default latest)

DESCRIPTION
  show the summary of a call record (use records:download for the files)

EXAMPLES
  $ fonoster records:get <call-ref>

  $ fonoster records:get <call-ref> --original --version 1
```

_参见代码 : [dist/命令/记录/get.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/records/get.js)_

## `fonoster records:list`

搜索当前工作空间的呼叫记录( vCon), 首先是

```
USAGE
  $ fonoster records:list [--ca-file <value>] [--after <value>] [--before <value>] [--number <value>] [--app
    <value>] [--status <value>] [-s <value>] [-t <value>]

FLAGS
  -s, --page-size=<value>   [default: 50] the number of items to show
  -t, --page-token=<value>  the token for the next page (printed after a full page)
      --after=<value>       started at or after (ISO date/time)
      --app=<value>         calls handled by this Application
      --before=<value>      started before (ISO date/time)
      --ca-file=<value>     a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                            (default: FONOSTER_CA_FILE)
      --number=<value>      calls from or to this number
      --status=<value>      record status (e.g. sealed, failed)

DESCRIPTION
  search the call records (vCon) of the active Workspace, newest first

EXAMPLES
  $ fonoster records:list

  $ fonoster records:list --after 2026-10-01 --number +17853178070

  $ fonoster records:list --app <app-ref> --status failed
```

_参见代码 : [dist/命令/记录/列表.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/records/list.js)_

## `fonoster secrets:create`

在活动的工作空间中添加新密钥

```
USAGE
  $ fonoster secrets:create [--ca-file <value>]

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  add a new Secret to the active Workspace

EXAMPLES
  $ fonoster secrets:create
```

_参见代码 : [dist/commands/secrets/create.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/secrets/create.js)_

## `fonoster secrets:delete REF`

从活动的工作空间删除密件

```
USAGE
  $ fonoster secrets:delete REF [--ca-file <value>]

ARGUMENTS
  REF  the Secret reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  delete a Secret from the active Workspace

EXAMPLES
  $ fonoster secrets:delete
```

_参见代码 : [命令/机密/删除](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/secrets/delete.js)_

## `fonoster secrets:get REF`

通过引用获取机密的细节

```
USAGE
  $ fonoster secrets:get REF [--ca-file <value>]

ARGUMENTS
  REF  The Secret to show details about

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  retrieve details of a Secret by reference

EXAMPLES
  $ fonoster secrets:get
```

_参见代码 : [dist/commands/secrets/get.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/secrets/get.js)_

## `fonoster secrets:list`

显示当前工作空间中的所有密件

```
USAGE
  $ fonoster secrets:list [--ca-file <value>] [-s <value>]

FLAGS
  -s, --page-size=<value>  [default: 1000] the number of items to show
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  display all Secrets in the active Workspace

EXAMPLES
  $ fonoster secrets:list
```

_参见代码 : [命令/机密/名单.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/secrets/list.js)_

## `fonoster secrets:update REF`

修改密钥的值或元数据

```
USAGE
  $ fonoster secrets:update REF [--ca-file <value>]

ARGUMENTS
  REF  the Secret to update

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  modify the value or metadata of a Secret

EXAMPLES
  $ fonoster secrets:update
```

_参见代码 : [命令/机密/更新.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/secrets/update.js)_

## `fonoster sipnet:acls:create`

创建新的访问控制列表( ACL)

```
USAGE
  $ fonoster sipnet:acls:create [--ca-file <value>]

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  create a new Access Control List (ACL)

EXAMPLES
  $ fonoster sipnet:acls:create
```

_参见代码 : [dist/commands/sipnet/acls/create.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/acls/create.js)_

## `fonoster sipnet:acls:delete REF`

从工作空间中删除访问控制列表( ACL)

```
USAGE
  $ fonoster sipnet:acls:delete REF [--ca-file <value>]

ARGUMENTS
  REF  the ACL reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  remove an Access Control List (ACL) from the Workspace

EXAMPLES
  $ fonoster sipnet:acls:delete
```

_参见代码 : [dist/commands/sipnet/acls/delete.js (中文(简体) )](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/acls/delete.js)_

## `fonoster sipnet:acls:get REF`

获取特定访问控制列表(ACL)

```
USAGE
  $ fonoster sipnet:acls:get REF [--ca-file <value>]

ARGUMENTS
  REF  The ACL reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  get a specific Access Control List (ACL)

EXAMPLES
  $ fonoster sipnet:acls:get
```

_参见代码 : [移动/命令/sipnet/acls/get.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/acls/get.js)_

## `fonoster sipnet:acls:list`

列出所有访问控制列表

```
USAGE
  $ fonoster sipnet:acls:list [--ca-file <value>] [-s <value>]

FLAGS
  -s, --page-size=<value>  [default: 1000] the number of items to show
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  list all Access Control Lists (ACLs)

EXAMPLES
  $ fonoster sipnet:acls:list
```

_参见代码 : [dist/commands/sipnet/acls/list.js 存档副本](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/acls/list.js)_

## `fonoster sipnet:acls:update REF`

更新现有的访问控制清单(ACL)

```
USAGE
  $ fonoster sipnet:acls:update REF [--ca-file <value>]

ARGUMENTS
  REF  the ACL reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  update an existing Access Control List (ACL)

EXAMPLES
  $ fonoster sipnet:acls:update
```

_参见代码 : [dist/commands/sipnet/acls/update.js 存档副本](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/acls/update.js)_

## `fonoster sipnet:agents:create`

在网络中添加一个新的 SIP 代理

```
USAGE
  $ fonoster sipnet:agents:create [--ca-file <value>]

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  add a new SIP Agent to the network

EXAMPLES
  $ fonoster sipnet:agents:create
```

_参见代码 : [dist/commands/sipnet/代理/创建.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/agents/create.js)_

## `fonoster sipnet:agents:delete REF`

删除 SIP 网络代理

```
USAGE
  $ fonoster sipnet:agents:delete REF [--ca-file <value>]

ARGUMENTS
  REF  the Agent reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  delete a SIP Agent from the network

EXAMPLES
  $ fonoster sipnet:agents:delete
```

_参见代码 : [dist/commands/sipnet/代理/删除](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/agents/delete.js)_

## `fonoster sipnet:agents:get REF`

获取 SIP 代理的详细信息

```
USAGE
  $ fonoster sipnet:agents:get REF [--ca-file <value>]

ARGUMENTS
  REF  The Agent reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  retrieve details of a SIP Agent

EXAMPLES
  $ fonoster sipnet:agents:get
```

_参见代码 : [调度/命令/新闻网/代理/get.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/agents/get.js)_

## `fonoster sipnet:agents:list`

在网络中显示全部 SIP 代理

```
USAGE
  $ fonoster sipnet:agents:list [--ca-file <value>] [-s <value>]

FLAGS
  -s, --page-size=<value>  [default: 1000] the number of items to show
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  display all SIP Agents in the network

EXAMPLES
  $ fonoster sipnet:agents:list
```

_参见代码 : [调度/命令/新闻网/代理/名单.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/agents/list.js)_

## `fonoster sipnet:agents:update REF`

在网络中添加一个新的 SIP 代理

```
USAGE
  $ fonoster sipnet:agents:update REF [--ca-file <value>]

ARGUMENTS
  REF  the ACL reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  add a new SIP Agent to the network

EXAMPLES
  $ fonoster sipnet:agents:update
```

_参见代码 : [调度/命令/新闻网/代理/更新.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/agents/update.js)_

## `fonoster sipnet:calls:create`

给一个电话号码或SIP URI打外出电话,并跟踪其状态

```
USAGE
  $ fonoster sipnet:calls:create -f <value> -t <value> -a <value> [--ca-file <value>] [-o <value>] [-m <value>] [-d]

FLAGS
  -a, --app-ref=<value>   (required) the Application that handles the call
  -d, --detach            print the call ref and return without following the status
  -f, --from=<value>      (required) the number to make the call from
  -m, --metadata=<value>  a JSON object the app receives with the session (e.g. '{"name": "John Doe"}')
  -o, --timeout=<value>   [default: 30] seconds to wait for an answer
  -t, --to=<value>        (required) the number or SIP URI to call
      --ca-file=<value>   a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                          (default: FONOSTER_CA_FILE)

DESCRIPTION
  place an outbound call to a phone number or SIP URI and follow its status

EXAMPLES
  $ fonoster sipnet:calls:create -f +17853178070 -t +18287854037 -a <app-ref>

  $ fonoster sipnet:calls:create -f +17853178070 -t +18287854037 -a <app-ref> --detach

  $ fonoster sipnet:calls:create -f +17853178070 -t +18287854037 -a <app-ref> -m '{"name":"Jane"}'
```

_参见代码 : [dist/commands/sipnet/ calls/create.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/calls/create.js)_

## `fonoster sipnet:calls:get REF`

获取特定访问控制列表(ACL)

```
USAGE
  $ fonoster sipnet:calls:get REF [--ca-file <value>]

ARGUMENTS
  REF  The ACL reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  get a specific Access Control List (ACL)

EXAMPLES
  $ fonoster sipnet:calls:get
```

_参见代码 : [调度/命令/西普网/呼叫/get.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/calls/get.js)_

## `fonoster sipnet:calls:list`

显示当前工作空间中的所有调用

```
USAGE
  $ fonoster sipnet:calls:list [--ca-file <value>] [-s <value>]

FLAGS
  -s, --page-size=<value>  [default: 1000] the number of items to show
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  display all calls made in the active Workspace

EXAMPLES
  $ fonoster sipnet:calls:list
```

_参见代码 : [dist/commands/sipnet/ calls/list.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/calls/list.js)_

## `fonoster sipnet:credentials:create`

向网络添加一套新的证书

```
USAGE
  $ fonoster sipnet:credentials:create [--ca-file <value>]

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  add a new set of Credentials to the network

EXAMPLES
  $ fonoster sipnet:credentials:create
```

_参见代码 : [dist/commands/sipnet/证书/创建.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/credentials/create.js)_

## `fonoster sipnet:credentials:delete REF`

从活动的工作空间删除一组证书

```
USAGE
  $ fonoster sipnet:credentials:delete REF [--ca-file <value>]

ARGUMENTS
  REF  the Credentials reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  delete a set of Credentials from the active Workspace

EXAMPLES
  $ fonoster sipnet:credentials:delete
```

_参见代码 : [发送/命令/短信/证书/删除](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/credentials/delete.js)_

## `fonoster sipnet:credentials:get REF`

通过参考检索一套全权证书的细节

```
USAGE
  $ fonoster sipnet:credentials:get REF [--ca-file <value>]

ARGUMENTS
  REF  The Credentials reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  retrieve details of a set of Credentials by reference

EXAMPLES
  $ fonoster sipnet:credentials:get
```

_参见代码 : [移动/命令/网信/证书/get.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/credentials/get.js)_

## `fonoster sipnet:credentials:list`

在活动的工作空间中显示所有证书

```
USAGE
  $ fonoster sipnet:credentials:list [--ca-file <value>] [-s <value>]

FLAGS
  -s, --page-size=<value>  [default: 1000] the number of items to show
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  display all Credentials in the active Workspace

EXAMPLES
  $ fonoster sipnet:credentials:list
```

_参见代码 : [分散/命令/sipnet/证书/list.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/credentials/list.js)_

## `fonoster sipnet:credentials:update REF`

修改一组证书的值或元数据

```
USAGE
  $ fonoster sipnet:credentials:update REF [--ca-file <value>]

ARGUMENTS
  REF  the Credentials reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  modify the values or metadata of a set of Credentials

EXAMPLES
  $ fonoster sipnet:credentials:update
```

_参见代码 : [转移/命令/新闻网/证书/更新](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/credentials/update.js)_

## `fonoster sipnet:domains:create`

向 SIP 网络添加新域名

```
USAGE
  $ fonoster sipnet:domains:create [--ca-file <value>]

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  add a new Domain to the SIP network

EXAMPLES
  $ fonoster sipnet:domains:create
```

_参见代码 : [dits/commands/sipnet/域名/创建.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/domains/create.js)_

## `fonoster sipnet:domains:delete REF`

删除活动工作空间中的域

```
USAGE
  $ fonoster sipnet:domains:delete REF [--ca-file <value>]

ARGUMENTS
  REF  the Domain reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  delete a Domain from the active Workspace

EXAMPLES
  $ fonoster sipnet:domains:delete
```

_参见代码 : [dist/commands/sipnet/域名/删除.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/domains/delete.js)_

## `fonoster sipnet:domains:get REF`

通过引用获取域的细节

```
USAGE
  $ fonoster sipnet:domains:get REF [--ca-file <value>]

ARGUMENTS
  REF  The Domain reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  retrieve details of a Domain by reference

EXAMPLES
  $ fonoster sipnet:domains:get
```

_参见代码 : [dist/commands/sipnet/域名/get.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/domains/get.js)_

## `fonoster sipnet:domains:list`

在 SIP 网络中显示全部域

```
USAGE
  $ fonoster sipnet:domains:list [--ca-file <value>] [-s <value>]

FLAGS
  -s, --page-size=<value>  [default: 1000] the number of items to show
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  display all Domains in the SIP network

EXAMPLES
  $ fonoster sipnet:domains:list
```

_参见代码 : [dist/commands/sipnet/域名/list.js (中文(简体) )](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/domains/list.js)_

## `fonoster sipnet:domains:update REF`

修改域的配置

```
USAGE
  $ fonoster sipnet:domains:update REF [--ca-file <value>]

ARGUMENTS
  REF  the Domain reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  modify the configuration of a Domain

EXAMPLES
  $ fonoster sipnet:domains:update
```

_参见代码 : [dist/commands/sipnet/域名/上册.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/domains/update.js)_

## `fonoster sipnet:numbers:create`

在 SIP 网络中添加新编号

```
USAGE
  $ fonoster sipnet:numbers:create [--ca-file <value>]

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  add a new Number to the SIP network

EXAMPLES
  $ fonoster sipnet:numbers:create
```

_参见代码 : [dist/commands/sipnet/数字/创建.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/numbers/create.js)_

## `fonoster sipnet:numbers:delete REF`

从活动的工作空间删除数字

```
USAGE
  $ fonoster sipnet:numbers:delete REF [--ca-file <value>]

ARGUMENTS
  REF  the Numbers's reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  delete a Number from the active Workspace

EXAMPLES
  $ fonoster sipnet:numbers:delete
```

_参见代码 : [dist/commands/sipnet/数字/删除.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/numbers/delete.js)_

## `fonoster sipnet:numbers:get REF`

通过引用获取数字的细节

```
USAGE
  $ fonoster sipnet:numbers:get REF [--ca-file <value>]

ARGUMENTS
  REF  the Number to show details about

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  retrieve details of a Number by reference

EXAMPLES
  $ fonoster sipnet:numbers:get
```

_参见代码 : [dist/commands/sipnet/数字/get.js 数据](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/numbers/get.js)_

## `fonoster sipnet:numbers:linkTwilio PHONENUMBER`

将您 Twilio 账户中的数字链接到活动的工作空间

```
USAGE
  $ fonoster sipnet:numbers:linkTwilio PHONENUMBER [--ca-file <value>] [--name <value>] [--app <value> | --agent <value>]
    [--account-sid <value>] [--api-key-sid <value> | --auth-token] [--yes]

ARGUMENTS
  PHONENUMBER  the number to link, in E.164 (it must be in your Twilio account)

FLAGS
  --account-sid=<value>  the Twilio Account SID (AC...)
  --agent=<value>        the SIP agent (AOR) that answers the number
  --api-key-sid=<value>  a Twilio Standard API key SID (SK...); the secret is read from TWILIO_API_KEY_SECRET or a
                         masked prompt
  --app=<value>          the Application that answers the number
  --auth-token           sign in with the Auth Token instead of an API key; it is read from TWILIO_AUTH_TOKEN or a
                         masked prompt
  --ca-file=<value>      a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                         (default: FONOSTER_CA_FILE)
  --name=<value>         the Number's name (default: the phone number)
  --yes                  link without asking, replacing the trunk and route of a number already in the workspace

DESCRIPTION
  link a number from your Twilio account to the active workspace

ALIASES
  $ fonoster sipnet:numbers:linkTwilioNumber

EXAMPLES
  $ fonoster sipnet:numbers:linkTwilio +18095550123 --app <ref>   # asks for what's missing

  TWILIO_API_KEY_SECRET=... fonoster sipnet:numbers:linkTwilio +18095550123 --account-sid AC... --api-key-sid SK... --app <ref> --yes
```

_参见代码 : [dist/commands/sipnet/numbers/linkTwilio.js 页面存档备份,存于互联网档案馆](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/numbers/linkTwilio.js)_

## `fonoster sipnet:numbers:linkTwilioNumber PHONENUMBER`

将您 Twilio 账户中的数字链接到活动的工作空间

```
USAGE
  $ fonoster sipnet:numbers:linkTwilioNumber PHONENUMBER [--ca-file <value>] [--name <value>] [--app <value> | --agent <value>]
    [--account-sid <value>] [--api-key-sid <value> | --auth-token] [--yes]

ARGUMENTS
  PHONENUMBER  the number to link, in E.164 (it must be in your Twilio account)

FLAGS
  --account-sid=<value>  the Twilio Account SID (AC...)
  --agent=<value>        the SIP agent (AOR) that answers the number
  --api-key-sid=<value>  a Twilio Standard API key SID (SK...); the secret is read from TWILIO_API_KEY_SECRET or a
                         masked prompt
  --app=<value>          the Application that answers the number
  --auth-token           sign in with the Auth Token instead of an API key; it is read from TWILIO_AUTH_TOKEN or a
                         masked prompt
  --ca-file=<value>      a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                         (default: FONOSTER_CA_FILE)
  --name=<value>         the Number's name (default: the phone number)
  --yes                  link without asking, replacing the trunk and route of a number already in the workspace

DESCRIPTION
  link a number from your Twilio account to the active workspace

ALIASES
  $ fonoster sipnet:numbers:linkTwilioNumber

EXAMPLES
  $ fonoster sipnet:numbers:linkTwilioNumber +18095550123 --app <ref>   # asks for what's missing

  TWILIO_API_KEY_SECRET=... fonoster sipnet:numbers:linkTwilioNumber +18095550123 --account-sid AC... --api-key-sid SK... --app <ref> --yes
```

## `fonoster sipnet:numbers:linkWhatsApp [PHONENUMBER]`

将 WhatsApp 业务编号链接到活动的工作空间

```
USAGE
  $ fonoster sipnet:numbers:linkWhatsApp [PHONENUMBER] [--ca-file <value>] [--phone-number-id <value>] [--name <value>] [--app
    <value> | --agent <value>] [--yes]

ARGUMENTS
  [PHONENUMBER]  the WhatsApp Business number, in E.164; only when you set up Meta yourself (no --phone-number-id)

FLAGS
  --agent=<value>            the SIP agent (AOR) that answers the number
  --app=<value>              the Application that answers the number
  --ca-file=<value>          a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                             (default: FONOSTER_CA_FILE)
  --name=<value>             the Number's name (default: Meta's verified name, or the phone number)
  --phone-number-id=<value>  Meta's id of the phone number (WhatsApp Manager > Phone numbers); Fonoster then sets up
                             Meta with a token read from META_ACCESS_TOKEN or a masked prompt
  --yes                      skip the confirmation; required without a terminal

DESCRIPTION
  link a WhatsApp Business number to the active workspace

EXAMPLES
  $ fonoster sipnet:numbers:linkWhatsApp --phone-number-id 106612345678901 --app <ref>   # asks for the token and what's missing

  META_ACCESS_TOKEN=... fonoster sipnet:numbers:linkWhatsApp --phone-number-id 106612345678901 --app <ref> --yes

  WHATSAPP_SIP_PASSWORD=... fonoster sipnet:numbers:linkWhatsApp +525512345678 --app <ref> --yes   # you set up Meta yourself
```

_参见代码 : [dist/commands/sipnet/numbers/linkWhatsApp.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/numbers/linkWhatsApp.js)_

## `fonoster sipnet:numbers:list`

显示当前工作空间中的所有数字

```
USAGE
  $ fonoster sipnet:numbers:list [--ca-file <value>] [-s <value>]

FLAGS
  -s, --page-size=<value>  [default: 1000] the number of items to return
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  display all Numbers in the active Workspace

EXAMPLES
  $ fonoster sipnet:numbers:list
```

_参见代码 : [dist/commands/sipnet/数字/list.js 数据](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/numbers/list.js)_

## `fonoster sipnet:numbers:update REF`

修改数字的配置

```
USAGE
  $ fonoster sipnet:numbers:update REF [--ca-file <value>]

ARGUMENTS
  REF  the Number to update

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  modify the configuration of a Number

EXAMPLES
  $ fonoster sipnet:numbers:update
```

_参见代码 : [dist/commands/sipnet/数字/更新.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/numbers/update.js)_

## `fonoster sipnet:trunks:create`

在 SIP 网络中添加新的 Trunk

```
USAGE
  $ fonoster sipnet:trunks:create [--ca-file <value>]

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  add a new Trunk to the SIP network

EXAMPLES
  $ fonoster sipnet:trunks:create
```

_参见代码 : [dist/commands/sipnet/trunks/create.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/trunks/create.js)_

## `fonoster sipnet:trunks:delete REF`

从活动的工作空间中删除 Trunk

```
USAGE
  $ fonoster sipnet:trunks:delete REF [--ca-file <value>]

ARGUMENTS
  REF  the Trunk's reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  remove a Trunk from the active Workspace

EXAMPLES
  $ fonoster sipnet:trunks:delete
```

_参见代码 : [散装/命令/sipnet/trunks/删除.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/trunks/delete.js)_

## `fonoster sipnet:trunks:get REF`

以引用方式获取 Trunk 的细节

```
USAGE
  $ fonoster sipnet:trunks:get REF [--ca-file <value>]

ARGUMENTS
  REF  The Trunk's reference

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  retrieve details of a Trunk by reference

EXAMPLES
  $ fonoster sipnet:trunks:get
```

_参见代码 : [dist/commands/sipnet/trunks/get.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/trunks/get.js)_

## `fonoster sipnet:trunks:list`

在活动的工作空间中显示全部 Trunks

```
USAGE
  $ fonoster sipnet:trunks:list [--ca-file <value>] [-s <value>]

FLAGS
  -s, --page-size=<value>  [default: 1000] the number of items to show
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  display all Trunks in the active Workspace

EXAMPLES
  $ fonoster sipnet:trunks:list
```

_参见代码 : [dist/commands/sipnet/trunks/list.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/trunks/list.js)_

## `fonoster sipnet:trunks:update REF`

修改 Trunk 的配置

```
USAGE
  $ fonoster sipnet:trunks:update REF [--ca-file <value>]

ARGUMENTS
  REF  the Trunk to update

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  modify the configuration of a Trunk

EXAMPLES
  $ fonoster sipnet:trunks:update
```

_参见代码 : [散会/命令/sipnet/trunks/update.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/sipnet/trunks/update.js)_

## `fonoster webhooks:create`

为工作空间活动订阅 HTTPS 端点

```
USAGE
  $ fonoster webhooks:create -u <value> -e
    call.started|call.ended|call.failed|call_record.sealed|provider.deprecated... [--ca-file <value>]

FLAGS
  -e, --event=<option>...  (required) an event to receive (repeatable)
                           <options: call.started|call.ended|call.failed|call_record.sealed|provider.deprecated>
  -u, --url=<value>        (required) the endpoint that receives the events (https://)
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  subscribe an HTTPS endpoint to Workspace events

EXAMPLES
  $ fonoster webhooks:create --url https://example.com/hooks -e call.ended -e call_record.sealed
```

_参见代码 : [dist/commands/webhooks/create.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/webhooks/create.js)_

## `fonoster webhooks:delete REF`

从活动的工作空间中删除 Webhook

```
USAGE
  $ fonoster webhooks:delete REF [--ca-file <value>]

ARGUMENTS
  REF  the Webhook to delete

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  delete a Webhook from the active Workspace

EXAMPLES
  $ fonoster webhooks:delete <ref>
```

_参见代码 : [dist/commands/webhooks/delete.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/webhooks/delete.js)_

## `fonoster webhooks:deliveries [REF]`

显示发送日志( 所有 Webhooks, 或一个)

```
USAGE
  $ fonoster webhooks:deliveries [REF] [--ca-file <value>] [-s <value>]

ARGUMENTS
  [REF]  only this Webhook's deliveries

FLAGS
  -s, --page-size=<value>  [default: 50] the number of items to show
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  show the delivery log (all Webhooks, or one)

EXAMPLES
  $ fonoster webhooks:deliveries

  $ fonoster webhooks:deliveries <webhook-ref> -s 20
```

_参见代码 : [dist/commands/webhooks/deliveries.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/webhooks/deliveries.js)_

## `fonoster webhooks:get REF`

通过引用获取 Webhook 的细节

```
USAGE
  $ fonoster webhooks:get REF [--ca-file <value>]

ARGUMENTS
  REF  the Webhook to show details about

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  retrieve details of a Webhook by reference

EXAMPLES
  $ fonoster webhooks:get <ref>
```

_参见代码 : [dist/ commands/webhooks/ get.js 命令/网络用户](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/webhooks/get.js)_

## `fonoster webhooks:list`

在活动的工作空间中显示所有 Webhooks

```
USAGE
  $ fonoster webhooks:list [--ca-file <value>] [-s <value>]

FLAGS
  -s, --page-size=<value>  [default: 1000] the number of items to show
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  display all Webhooks in the active Workspace

EXAMPLES
  $ fonoster webhooks:list
```

_参见代码 : [dist/commands/webhooks/list.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/webhooks/list.js)_

## `fonoster webhooks:resend REF`

再次发送邮件( 相同的事件 id, 所以接收器可以去dupe)

```
USAGE
  $ fonoster webhooks:resend REF [--ca-file <value>]

ARGUMENTS
  REF  the delivery to resend (see webhooks:deliveries)

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  send a delivery again (same event id, so receivers can dedupe)

EXAMPLES
  $ fonoster webhooks:resend <delivery-ref>
```

_参见代码 : [dist/commands/webhooks/resend.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/webhooks/resend.js)_

## `fonoster webhooks:rotate REF`

为 Webhook 发布新的签名秘密( 旧的继续工作一段时间)

```
USAGE
  $ fonoster webhooks:rotate REF [--ca-file <value>]

ARGUMENTS
  REF  the Webhook whose secret to rotate

FLAGS
  --ca-file=<value>  a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem (default:
                     FONOSTER_CA_FILE)

DESCRIPTION
  issue a new signing secret for a Webhook (the old one keeps working for a while)

EXAMPLES
  $ fonoster webhooks:rotate <ref>
```

_参见代码 : [dist/commands/webhooks/rotate.js 互联网档案馆的存檔,存档日期2013-12-02](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/webhooks/rotate.js)_

## `fonoster webhooks:update REF`

更改 Webhook 的 URL 或事件( - 事件替换列表)

```
USAGE
  $ fonoster webhooks:update REF [--ca-file <value>] [-u <value>] [-e
    call.started|call.ended|call.failed|call_record.sealed|provider.deprecated...]

ARGUMENTS
  REF  the Webhook to update

FLAGS
  -e, --event=<option>...  an event to receive (repeatable)
                           <options: call.started|call.ended|call.failed|call_record.sealed|provider.deprecated>
  -u, --url=<value>        the new endpoint
      --ca-file=<value>    a PEM file of certificate authorities to trust, such as an install's config/tls/ca.pem
                           (default: FONOSTER_CA_FILE)

DESCRIPTION
  change a Webhook's URL or events (--event replaces the list)

EXAMPLES
  $ fonoster webhooks:update <ref> -e call.started -e call.ended

  $ fonoster webhooks:update <ref> --url https://example.com/new
```

_参见代码 : [dist/commands/webhooks/update.js (英语)](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/webhooks/update.js)_

## `fonoster workspaces:active`

显示活动工作空间的名称

```
USAGE
  $ fonoster workspaces:active

DESCRIPTION
  display the name of the active Workspace

EXAMPLES
  $ fonoster workspaces:active
```

_参见代码 : [磁盘/命令/工作空间/活性.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/workspaces/active.js)_

## `fonoster workspaces:list`

显示所有链接的工作空间

```
USAGE
  $ fonoster workspaces:list

DESCRIPTION
  display all linked Workspaces

EXAMPLES
  $ fonoster workspaces:list
```

_参见代码 : [dist/ 命令/ 工作空间/ list.js](https://github.com/fonoster/fonoster/blob/v0.52.1/dist/commands/workspaces/list.js)_

## `fonoster workspaces:login`

a 工作空间与本地环境的联系

```
USAGE
  $ fonoster workspaces:login [--ca-file <value>] [-e <value>] [--access-key-id <value>] [--access-key-secret <value>]

FLAGS
  -e, --endpoint=<value>           the API endpoint (skips the questions with the key flags)
      --access-key-id=<value>      a Workspace API key id
      --access-key-secret=<value>  the API key secret
      --ca-file=<value>            a PEM file of certificate authorities to trust, such as an install's
                                   config/tls/ca.pem (default: FONOSTER_CA_FILE)

DESCRIPTION
  link a Workspace to the local environment

EXAMPLES
  $ fonoster workspaces:login

  $ fonoster wor
```

## 常见问题

### @fonoster/ctl 是什么？

长老会控制工具

### 如何安装 @fonoster/ctl？

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

### @fonoster/ctl 支持 TypeScript 吗？

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

### @fonoster/ctl 支持 ESM 还是 CommonJS？

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

### @fonoster/ctl 可以商用吗？

@fonoster/ctl 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fonoster/ctl 的下载量有多少？

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

### @fonoster/ctl 还在维护吗？

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