@faable/faable

中文文档
4.41.0发布于 2026/11/13MITTypeScriptES Module构建来源已验证近 30 天下载 7907
中文使用文档
文档目录13 节
  1. 安装
  2. 快开始
  3. 图标
  4. MCP 服务器
  5. 脚本和代理
  6. 部署
  7. 名人奥特
  8. 文档
  9. 国 际
  10. 法可部署
  11. 名人奥特
  12. 支助
  13. 许可证

Faable CLI: deploy and run your apps from the terminal

npm version MIT license Documentation

异能的CLI

@faable/faable 是命令行接口 异类 平台。 这个 覆盖 法可部署 (船舶和操作应用程序) 名人奥特 (管理身份租户: 用户、登录流程动作、OAuth客户端和审计日志)从一个二进制.

全文 : faable.com/docs/cli (英语)。 。 。 .

安装

需要节点js 22.8 或以后.

npm i -g @faable/faable

快开始

faable login    # sign in from your browser
faable deploy   # deploy the current directory
faable deploy status

图标

组它会做什么文档
faable login 编号 : whoami 编号 : logout会话管理( 设备流; CI 使用 OIDC, 不需要登录)认证
faable project工程命令根据 : list, (中文(简体) ), use, (中文(简体) ), current, (中文(简体) ), clear (或 --project 在任何命令上)项目
faable organization公司下属的集团项目: list, (中文(简体) ), get, (中文(简体) ), create, (中文(简体) ), projects add编号 :rm, (中文(简体) ), admins add编号 :rm (单位:千美元)org 简称)组织
faable deploylaunch (默认:一赤出) faable deploy 部署当前目录),然后 status, (中文(简体) ), logs, (中文(简体) ), deployments, (中文(简体) ), inspect, (中文(简体) ), trigger, (中文(简体) ), redeploy, (中文(简体) ), cancel, (中文(简体) ), traffic, (中文(简体) ), usage, (中文(简体) ), quota, (中文(简体) ), open部署
faable deploy appslist, (中文(简体) ), get, (中文(简体) ), create (来自GitHub存储器,包括首次部署), set (分支、根目录、部署模式)应用程序
faable deploy secrets环境变量: list, (中文(简体) ), set (单位:千美元)KEY=VALUE, (中文(简体) ), --env-file,或 -f - 从斯丁, rm秘诀
faable deploy domains自定义域 : add (印刷国家妇女委员会), list, (中文(简体) ), check, (中文(简体) ), rm域数
faable deploy waf边缘规则 : block (403个), sink (404年没有唤醒应用程序), list, (中文(简体) ), rm边缘规则
faable auth userslist (可行的QL过滤器), get (包括联邦身份), suspend, (中文(简体) ), reinstate用户
faable auth actions登录流程钩 : list, (中文(简体) ), get --code, (中文(简体) ), create, (中文(简体) ), update, (中文(简体) ), rm行动
faable auth clientsOAuth 客户端: list, (中文(简体) ), get --secret, (中文(简体) ), create, (中文(简体) ), rm代理客户端
faable auth logs审计日志( 只读) : list 有过滤器, get审计记录

每个命令都有 --help 财务报告和审定财务报表 --json。 。 。 . --app 需要一个应用识别码,名称或弹壳. 完整的表格在 命令引用。 。 。 .

MCP 服务器

faable mcp 将 CLI 作为 MCP 磁共振 服务器结束 stdio,所以克劳德代码, Cursor 或任何 MCP 客户端都可以读取您的应用程序,部署 和日志——"为什么我最后一次部署失败了?"—— 和部署,与你 faable login 会议:

claude mcp add faable -- npx -y @faable/faable mcp

默认它会曝光读取加 deploy_app (建立最新的承诺服务器侧). faable mcp --writes 添加可逆写作: 从寄存器创建应用程序, 设置环境变量, 添加一个域, 重试或取消构建, 更改部署 设置。 没有破坏力暴露。 秘密值永远不会返回,而且 日志作为数据而不是指令返回.

脚本和代理

数据到 stdout,消息到 stderr. 与 --json数字 :

  • 每个列表是 {"object":"list","data":[…],"has_more","next_cursor"} (单位:千美元)--limit, (中文(简体) ), --starting-after, (中文(简体) ), --all(三);
  • 每次写回它所改变的东西 和无所事事的写回 {"result":"noop","reason"}· ;
  • 失败退出 1 与 {"error":{"message","code","status","action"}} 打开 师曰. 代码 : not_logged_in, (中文(简体) ), session_expired, (中文(简体) ), account_suspended, (中文(简体) ), apikey_session, (中文(简体) ), forbidden, (中文(简体) ), not_found, (中文(简体) ), confirmation_required, (中文(简体) ), app_required, (中文(简体) ), usage,或API自己的代码.

驱动 CLI 的程序应该设置 FAABLE_NONINTERACTIVE=1 (或通过) --non-interactive: 没有提示——没有确认 --yes 失败 与 confirmation_required —— 应用程序从不从工作的推断 目录,以及 faable deploy launch 需求 --app, (中文(简体) ), --workdir 财务报告和审定财务报表 --yes。 。 。 . 通过 stdin 上的秘密值 (faable deploy secrets set -f -),从来没有像 参数.

部署

faable login
faable deploy                       # deploy the current directory (= deploy launch)
faable deploy launch --app app_x    # deploy another app, from anywhere
faable deploy apps create --repo acme/web   # create, link, first deploy
faable deploy --create site --workdir ./public --yes   # a new app from a folder (git or not)
faable deploy link --app web --repo acme/web      # link a repository to an existing app
faable deploy apps rm --app app_x   # delete an app (asks first; --yes to skip)
faable deploy status                # phase, URL and detected stack
faable deploy logs --build -n 100   # end of the build output (--follow to tail)
faable deploy traffic --since 7d    # status codes, top and failing paths
faable deploy secrets set KEY=value
faable deploy domains add app.example.com

名人奥特

faable auth 管理 a 名人奥特 租户和 重用您的语言 faable login 届会。 指着房客 --auth-url https://<account>.auth.faable.link (或 FAABLE_AUTH_URL) (中文(简体) ).

faable auth users list --query email_verified:false --limit 50
faable auth users get user_abc123                   # includes GitHub/… identities
faable auth users suspend user_abc123 -r "abuse: crypto miner"

# Bulk: pipe ids from a filtered listing
faable auth users list --suspended --json | jq -r '.data[].id' | faable auth users reinstate -y

faable auth actions create -n add-claims -t post-login -f ./claims.js
faable auth clients create -n my-app --callback https://app.example.com/callback
faable auth logs list --origin oauth --status failed --since 2026-08-01

见 faable auth 文档中 页:1 每个旗帜。 每一组背后的概念见Faable Auth: 用户暂停( s), (中文(简体) ), 动作, (中文(简体) ), 登录流量, (中文(简体) ), 代理客户端 财务报告和审定财务报表 审计记录。 。 。 .

文档

CLI是一个很薄的客户端:它部署什么和管理什么被记录在其中 公众文件,不在这里.

国 际

法可部署

名人奥特

支助

许可证

麻省理工学院 飞云 SLU

版本与发布记录

@faable/faable 共发布 216 个版本,首次发布于 2022/12/21;过去 12 个月发布了 172 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
4.41.0latest2026/11/13今天
4.40.02026/11/121 天前
4.39.12026/11/112 天前
4.39.02026/11/112 天前
4.38.12026/11/113 天前
4.38.02026/11/113 天前

其他发布通道:next → 1.5.17-next.27。

关于 @faable/faable 的常见问题

如何安装 @faable/faable?

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

@faable/faable 支持 TypeScript 吗?

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

@faable/faable 支持 ESM 还是 CommonJS?

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

@faable/faable 需要什么版本的 Node.js?

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

@faable/faable 可以商用吗?

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

@faable/faable 的下载量有多少?

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

@faable/faable 还在维护吗?

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