停下 Agent，暂停一切
读完这一页，你就知道 Beacon 的每一个刹车，以及每一个会关掉什么：停下单个 Agent 的那些开关——吊销令牌、吊销登录、删除密钥、收窄预设、停用所有者——和一次停下全部的那一个：通道暂停。哪一个都不靠运气：Agent 能做什么在每个请求上重新计算，答案一变，它在机器上打开着的一切立刻关闭。
你需要一个所有者账号，或一个角色带 machines:write、能扳暂停开关的人（邀请你的团队）；命令在中心上执行，参考部署里是 docker exec beacon beacon …。
停下一个 Agent
想停多少，就选哪个开关：
| 开关 | 怎么扳 | 会关掉什么 |
|---|---|---|
| 吊销令牌 | Agent 页面上的Revoke，或 beacon token revoke NAME（控制台的Tokens页可吊销任何能到达机器的令牌） | 令牌从下一个请求起被拒绝；用它打开的——连接、转发端口、工具调用——立刻关闭，Agent 用它登记的密钥一并消失 |
| 吊销 OAuth 登录 | Agent 页面上的Revoke，或客户端自己登出（claude mcp logout beacon） | 同上，作用于这次登录打开的东西；客户端得重新登录 |
| 删除 SSH 密钥 | remove_ssh_key，或 Agent 的页面 | 用这把密钥登录的连接关闭 |
| 删除 Agent | beacon agent remove NAME，或它的页面 | 它的全部凭据——令牌、登录、密钥——及这些凭据打开的一切；它做过的事留在记录里 |
| 收窄 Agent | 它的页面，或中心上的 beacon agent：从其机器清单里去掉一台，或把预设降到 machines:ssh 以下 | 它在不再能到达的机器上打开的东西关闭；其余照常 |
| 停下所有者 | beacon user disable NAME，或 beacon user role NAME viewer（改角色、停用某个成员） | 其登录结束、Agent 停下，这些 Agent 在机器上打开的一切关闭 |
吊销令牌也会结束用它登录的控制台会话——吊销你正用来登录的那个令牌，你会被登出。Agent 做过的事——会话、录像、备注——保留 ssh.keep（180 天）；停下 Agent 永远不会删除记录。
Beacon 每分钟还会检查一遍期间过期的凭据，所以过了有效期的令牌不需要谁动手，也会关掉它打开着的东西。
暂停整条通道
要一次停下所有 Agent——出了安全事件、要变更冻结、想歇一晚——就暂停 SSH 通道。它立刻关闭所有进行中的会话、拒绝新会话，直到恢复；三个地方都能扳：
docker exec beacon beacon ssh pause # 恢复是 ssh resume你会看到 agents' access to machines is paused since …（ssh status 显示当前状态，控制台Machines页机器列表上方的开关也一样）。暂停期间，Agent 自己的 ssh 会收到 beacon: agents' access to machines is paused since …; a person resumes it with beacon ssh resume，MCP 工具和 API 也被同样的话拒绝。监控不受影响：检测点照常汇报，告警照常到达；暂停记入审计日志。API 路由是 POST /api/v1/ssh/pause 和 /resume，MCP 工具是 pause_ssh——都要 machines:write，并回显到告警群，暂停不会被悄悄进行。
暂停是整个机群的刹车；上面的开关只停一个 Agent，不停别人。
关掉什么，什么时候关
上面所有开关底下是同一个机制：Beacon 重新读一遍谁现在能做什么——令牌或登录的 scope、Agent 的预设、所有者的角色、机器清单——答案不再允许的部分（连接、转发端口、工具调用）立刻关闭，不等 Agent 下一次请求。正在执行命令的 Agent 会发现应答被截断；再试下一条命令则被拒绝，原因写在拒绝里。
这里的任何一项都不会停掉录像和审计：被开关关掉的会话保有其记录和回放；扳了哪个开关，审计日志里就有谁扳的——revoke_token、ssh_pause、user_disable。
检查一下
暂停通道，让 Agent 执行一条命令：它会被上面那句话拒绝，Machines页和 beacon ssh status 都显示自何时起暂停。恢复之后，吊销某个 Agent 手里的一把令牌，在Sessions页上看它打开着的会话关闭、标记为已结束、回放完好。Agent 因为别的原因连不上机器时，Agent 连不上机器列出了每条消息和对应的处理。
下一步
- 邀请你的团队：这些开关所收窄的角色与预设。
- 给 Agent 一台机器：被暂停的那条通道，以及它期间的记录。
- 复查 Agent 做了什么：被停下的 Agent 留下的会话，回放也在。