> ## 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.

# 클라우드 서버 관리자 권한

> 클라우드 서버 관리자 권한은 에이전트가 클라우드 서버에서 소프트웨어를 설치하고 시스템 설정을 변경할 수 있는지를 결정합니다. 이 페이지에서는 스위치 위치, 위험 확인, 현재 상태, 클라우드 서버에서 처음 세션을 시작할 때의 확인을 설명합니다.

**클라우드 서버 관리자 권한** 은 에이전트가 클라우드 서버에서 관리자로 작업할 수 있는지를 결정합니다. 예를 들어 시스템 소프트웨어 설치나 시스템 설정 변경이 여기에 해당합니다. **기본값은 켜짐** 이며 클라우드 서버 전체에 적용됩니다.

## 진입 위치

* **Settings › Workspace › Overview** 의 **Cloud server** 그룹(데스크톱 앱, 웹 앱, 모바일 웹에서 사용 가능).
* 클라우드 서버에서 처음 새 세션을 시작하면 위험 확인이 자동으로 표시됩니다(아래 참고).

## 켜기와 끄기

**Cloud server** 그룹에 **Admin access on cloud server** 스위치가 있습니다. 그 아래의 **Current state** 행에는 클라우드 서버에 실제로 적용된 상태가 표시됩니다.

**켜기**:

1. 스위치를 켭니다. **Turn on admin access on cloud server** 확인 창이 나타나며 다음 네 가지 위험을 안내합니다.
   * 에이전트가 클라우드 서버의 관리자 권한을 얻고, 그곳에 저장된 자격 증명을 읽을 수 있습니다.
   * 승인과 브랜치 제한은 권고 사항이 되며 강제되지 않습니다.
   * 끄더라도 이미 적용된 변경 사항은 되돌려지지 않습니다. 완전히 초기화하려면 클라우드 서버를 다시 빌드합니다.
   * 아직 자동 복구 기능이 없습니다. 시스템 파일이 손상되면 클라우드 서버를 다시 빌드해야 할 수 있습니다.
2. **Got it, turn on** 을 클릭하면 저장되고, **Cancel** 을 클릭하면 변경되지 않습니다.

**끄기**: 스위치를 끄기만 하면 됩니다. 확인이 필요 없습니다. 끄더라도 에이전트가 이전에 클라우드 서버에서 변경한 내용은 되돌려지지 않습니다.

저장하면 현재 상태에 먼저 **Applying** 이 표시되며, 보통 1분 이내에 적용됩니다.

## 규칙과 상태

| 현재 상태 | 할 수 있는 작업 |
| - | - |
| **In effect** / **Off** | 필요에 따라 스위치를 변경합니다 |
| **Applying** | 잠시 기다립니다. 이 동안에는 스위치를 변경할 수 없습니다 |
| **Failed**(클라우드 서버는 이전 상태를 유지) | **Retry** 를 클릭합니다 |
| **Cloud server needs an upgrade** | 할 일이 없습니다. 플랫폼이 다음 유지보수 때 자동으로 업그레이드합니다 |
| **No cloud server yet. These settings apply once you get one.** | 평소처럼 스위치를 변경합니다. 설정은 [Plus](https://docs.aihubmix.com/ko/cloud/plus/plus-plan.md)를 사용하게 된 후 적용됩니다 |

## 클라우드 서버에서 처음 세션을 시작할 때의 확인

관리자 권한은 기본적으로 켜져 있으므로, 새 세션 페이지에서 실행 방식을 클라우드 서버로 하여 처음 세션을 시작하면 같은 위험 확인 창이 먼저 나타납니다. 버튼은 **Cancel** 과 **Got it, start the task** 입니다.

* **Got it, start the task** 클릭: 세션이 바로 시작됩니다. 다시 묻지 않습니다.
* **Cancel** 클릭: 메시지가 전송되지 않습니다.

설정에서 이미 위험을 확인했거나 관리자 권한을 껐다면 나타나지 않습니다. 다른 기기에서 사용하거나 브라우저 데이터를 지운 후에는 한 번 더 확인해야 할 수 있습니다. 새 세션의 흐름은 [새 세션](https://docs.aihubmix.com/ko/cloud/sessions/new-session.md)을 참고하세요.

## 참고 및 제한 사항

* 켜져 있으면 에이전트가 클라우드 서버에 저장된 자격 증명을 읽을 수 있습니다. 에이전트에 필요한 시크릿은 **Settings › Workspace › Secrets & variables** 에 넣고, 클라우드 서버에 평문 파일로 보관하지 마세요.
* 끄더라도 기존 변경 사항은 롤백되지 않습니다. 현재 시스템 파일에 대한 자동 복구 기능은 없습니다.

## 자주 묻는 질문

### 관리자 권한을 껐는데 왜 계속 "In effect"로 표시되나요?

스위치가 저장된 후, 클라우드 서버에 적용되기까지 잠시 시간이 걸립니다. 그 전까지는 **Applying** 이 표시되며 보통 1분 이내입니다. **Failed** 로 바뀌면 **Retry** 를 클릭하세요.

### 관리자 권한은 프로젝트별로 설정하나요?

아니요. 클라우드 서버 전체에 적용되며 워크스페이스 설정에 있습니다.

## 관련 문서

* [클라우드 서버 개요](https://docs.aihubmix.com/ko/cloud/cloud-host/overview.md)
* [새 세션](https://docs.aihubmix.com/ko/cloud/sessions/new-session.md)
* [워크스페이스 설정](https://docs.aihubmix.com/ko/cloud/settings/workspace.md)


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