> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 云主机管理员权限

> 云主机管理员权限决定 Agent 能否在云主机上安装软件、修改系统配置。本页说明开关位置、风险确认、实际状态和首次在云主机上发起会话时的确认。

**云主机管理员权限**决定 Agent 能否在云主机上以管理员身份操作，例如安装系统软件、调整系统配置。它**默认开启**，作用于整台云主机。

## 入口

* 「设置 › 工作区 › 基本信息」中的「云主机」分组（桌面客户端、网页版、手机网页都可以设置）。
* 第一次在云主机上发起新会话时，会自动弹出风险确认（见下文）。

## 开启与关闭

「云主机」分组里有「云主机管理员权限」开关，下面一行「实际状态」显示云主机上真正生效的状态。

**开启**：

1. 打开开关，弹出「开启云主机管理员权限」确认，列出四条风险：
   * 开启后 Agent 在云主机上拥有管理员权限，云主机里保存的凭据可以被读取。
   * 审批和分支限制只是建议，不再强制。
   * 关闭不会撤销已经做过的改动；如需彻底恢复，请重建云主机。
   * 目前没有自动修复，误改系统文件可能需要重建云主机。
2. 点「我已了解，开启」保存；点「取消」不做改动。

**关闭**：直接关掉开关即可，不需要确认。关闭不会撤销 Agent 之前在云主机上做过的改动。

保存后实际状态先显示「应用中」，通常不到 1 分钟生效。

## 规则与状态

| 实际状态 | 你可以 |
| - | - |
| 「已生效」/「已关闭」 | 按需切换开关 |
| 「应用中」 | 稍等片刻，此时开关不可操作 |
| 「应用失败」（云主机保持之前的状态） | 点「重试」 |
| 「需要升级云主机」 | 无需操作，平台会在下次维护时自动升级 |
| 「还没有云主机，开通后按上面的设置生效」 | 照常切换开关，开通 [Plus](https://docs.aihubmix.com/cn/cloud/plus/plus-plan.md) 后按此设置应用 |

## 首次在云主机上发起会话时的确认

管理员权限默认开启，所以第一次在新会话页以云主机运行方式发起会话时，会先弹出同样的风险确认，按钮是「取消」和「我已了解，开始任务」。

* 点「我已了解，开始任务」：会话立即开始，之后不再询问。
* 点「取消」：消息不会发出。

如果已经在设置里确认过风险，或已关闭管理员权限，就不会弹出。换一台设备或清除浏览器数据后可能需要再确认一次。新会话流程见[新建会话](https://docs.aihubmix.com/cn/cloud/sessions/new-session.md)。

## 注意与限制

* 开启后 Agent 可以读取云主机上保存的凭据；需要给 Agent 用的密钥请放在「设置 › 工作区 › 密钥与环境变量」，不要用明文文件保存在云主机上。
* 关闭不能回滚已有改动；目前没有自动修复系统文件的能力。

## 常见问题

### 我关掉了管理员权限，为什么还显示「已生效」？

开关保存后要稍等片刻才会在云主机上生效，期间显示「应用中」，通常不到 1 分钟。如果变成了「应用失败」，点「重试」。

### 管理员权限是按项目设置的吗？

不是。它作用于整台云主机，放在工作区设置里。

## 相关

* [云主机概览](https://docs.aihubmix.com/cn/cloud/cloud-host/overview.md)
* [新建会话](https://docs.aihubmix.com/cn/cloud/sessions/new-session.md)
* [工作区设置](https://docs.aihubmix.com/cn/cloud/settings/workspace.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.