Konsolity CLI 安全

更新于 2026年11月10日

复制到另一台机器上的令牌能否使用?

不能。每次调用都会发送根据系统标识符计算得出的机器指纹。在另一台电脑上使用的令牌会被拒绝,该事件会被写入安全日志,您也会收到警报。本地机密文件还会用根据机器标识符派生的密钥加密:复制到别处将无法读取。

唯一的例外:konsolity setup-token 生成的长期令牌专为临时机器设计,不绑定指纹。请将其保存在 CI 的密钥管理器中,为其设置尽可能窄的范围和较短的有效期。

激活时显示的指纹有什么作用?

它可以证明您批准的请求确实来自您面前的这台机器。指纹根据机器的公钥计算得出;您的设备会自行重新计算,不依赖服务器。如果两个指纹不一致,请拒绝。

Konsolity 服务器能看到什么?

服务器能看到机器的名称、系统、IP 地址、范围(域,只读或完全访问)、会话以及命令日志(命令文本、主机、决定、退出码、耗时)。对于 Claude 连接器(konsolity serve),服务器还会传递 Claude 调用的参数和结果,这些内容以静态加密方式存储,并在回复一小时后删除,与 Claude 连接器相同。

服务器从不能看到您保险库的密钥、机器密钥、您的 SSH 密钥、您的密码或机器的规则:机器保险库的副本经过端到端加密,服务器只将其作为不透明数据块存储。在终端中运行的命令的输出不经过服务器。

机器能访问我的整个保险库吗?

不能。它从不接收保险库密钥,只接收一把机器密钥以及您所选主机和代码片段的加密副本。范围之外的主机没有副本:其 SSH 密钥不会离开您的保险库。机器既不能写入保险库,也不能修改自身的范围,更无法触及您的账户或订阅。

如果机器被入侵怎么办?

完全控制该机器的人可以使用它所收到的内容:其范围内的主机和 SSH 密钥,并受其规则约束。破坏性命令仍然需要您的确认。遇到这种情况:

  1. 撤销该机器(设置 › CLI 机器):它会在 5 秒内被切断,服务器会删除其机器保险库的副本。
  2. 更换它能访问的主机的 SSH 密钥。
  3. 查看其命令日志。
  4. 如果怀疑账户本身有问题,请修改密码并退出其他设备:所有 CLI 机器都会被撤销。

为从一开始就降低风险:使用尽可能窄的范围,只读能满足需求时就用只读,优先使用代码片段而非自由命令,不启用“任意命令”,设置较短的有效期,使用专用且保持更新的机器。

撤销多快生效?

不超过 5 秒。每条正在运行的命令每 2 秒向服务器报告一次状态;撤销后,下一次报告会被拒绝,CLI 会切断 SSH 连接,停止命令,清除其机密,并以代码 77 退出。

手机丢失了,该怎么办?

您的 CLI 机器不依赖手机:它们会继续工作。从另一台设备或 app.konsolity.com:

  1. 在设备列表中撤销该手机。
  2. 如果该手机上有您的 TOTP 应用或通行密钥,请使用恢复码,然后在“安全”中注册新的第二重验证方式。
  3. 如有疑虑,请同时撤销 CLI 机器(全部撤销),然后重新激活您需要的机器。

没有第二重验证,任何人都无法批准新机器,也无法扩大现有机器的范围,即使您的手机已解锁也一样。

为什么批准时需要第二重验证?

因为 CLI 机器可以在无人值守的情况下操作您的服务器。TOTP 代码或通行密钥会在处理批准的同一请求中校验:仅凭未退出的浏览器会话或被截获的激活代码是不够的。扩大范围时同样需要验证;缩小范围则不需要。

与应用有什么区别?

桌面应用 Konsolity CLI
界面 图形界面 命令行
保险库访问 整个保险库 仅限所选主机和代码片段
必须保持打开 是 否,konsolity serve 可作为服务运行
Claude 命令的批准 “允许一次”,或始终允许 范围和规则,破坏性命令需要确认
交互式终端、文件 是 否
系统 macOS、Windows、Linux、iOS、Android Linux、macOS、Windows

请勿与远程终端的中继混淆,后者是一项内部服务,用于在您的设备之间传输加密的 SSH 字节。

需要哪个套餐?

Studio 套餐或其免费试用。服务器会在机器每次调用时检查套餐;机器列表和撤销功能始终可用。konsolity serve 还会使用 Studio 中包含的 Claude 连接器。