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

# 원격 데스크톱: 클라우드 서버 보기, 전체 화면, 제어 가져오기

> 클라우드 서버 데스크톱을 실시간으로 보고, 전체 화면으로 보고, 키보드와 마우스 제어를 직접 가져오는 방법(에이전트는 일시 중지되지 않음)과 연결 문제, 데스크톱 트래픽 및 보기 수 제한을 설명합니다.

**원격 데스크톱**에서는 클라우드 서버 화면에서 일어나는 일을 실시간으로 볼 수 있습니다. 기본적으로 보기 전용입니다. 웹사이트 로그인이나 2단계 인증처럼 직접 조작해야 할 때는 키보드와 마우스의 **제어를 가져올** 수 있습니다. 제어를 가져와도 **에이전트는 일시 중지되지 않습니다**. 에이전트는 계속 실행되며, 내 조작과 에이전트의 조작이 동시에 일어날 수 있습니다. 작업을 마치면 **View only** 를 클릭해 키보드와 마우스를 돌려줍니다.

## 사용 가능 여부

| 플랫폼 | 지원 | 비고 |
| - | - | - |
| 데스크톱 앱 | 지원 | 보기, 전체 화면, 제어 가져오기 |
| 웹 앱 | 지원 | 보기, 전체 화면, 제어 가져오기 |
| 모바일 웹 | 일부 지원 | 보기 전용이며 제어를 가져올 수 없습니다 |

[Plus](https://docs.aihubmix.com/ko/cloud/plus/plus-plan.md)와 실행 중인 클라우드 서버가 필요합니다.

## 진입 위치

* 세션 상단 바의 **Cloud server** 버튼 또는 단축키 `` ⌃` ``(Windows `` Ctrl+` ``)를 누르면 오른쪽 패널의 **Cloud server** 탭이 열립니다.
* **Needs you on the cloud server** 의 **View cloud server**(보기 전용으로 열기) 또는 **Take control**(열면서 바로 제어 가져오기).
* Cloud server 페이지의 데스크톱 미리 보기 또는 **Open desktop**: 바로 전체 화면으로 열립니다.

## 패널에서 데스크톱 보기

패널에는 실시간 화면, 연결 상태, 시스템, 송신 IP, 리전이 표시됩니다. **Manage cloud server ›** 를 누르면 Cloud server 페이지가 열립니다. 보기 오른쪽 아래에는 현재 제어 주체가 **You have control**, **Waiting for you**, **Agent is working** 중 하나로 표시됩니다.

* 클라우드 서버가 없으면 패널에 **Get a cloud server** 버튼이 표시됩니다. 클라우드 서버가 실행 중이 아니면 클라우드 서버가 실행된 후 데스크톱을 사용할 수 있다고 안내합니다.
* 보기 전용 화면은 클립보드를 지원하지 않으므로 원격 데스크톱의 내용을 복사할 수 없습니다.

## 전체 화면

* 패널의 전체 화면 버튼을 클릭하거나, 보기 전용 모드에서 보기를 더블클릭하거나, `⇧⌘F`(Windows `Ctrl+Shift+F`)를 누르면 전체 화면에 들어갑니다. Cloud server 페이지의 **Open desktop** 도 바로 전체 화면으로 엽니다.
* 전체 화면 상단 바에는 제어 주체와 함께 **Take control** / **View only**, **Exit full screen** 이 표시됩니다.
* `Esc` 를 누르거나 **Exit full screen** 을 클릭하면 전체 화면을 종료합니다. 포커스가 원격 데스크톱에 있으면 `Esc` 가 클라우드 서버로 전달되므로 **Exit full screen** 을 클릭하세요.

## 클라우드 서버 제어 가져오기

### 제어를 가져오는 방법

1. 패널 또는 전체 화면 상단 바의 **Take control** 을 클릭합니다.
2. 클라우드 서버에서 세션이 실행 중이면 먼저 **Take control of the cloud server?** 가 표시됩니다. 실행 중인 세션 목록과 함께 에이전트가 일시 중지되지 않는다는 안내가 나옵니다. **Take control** 을 클릭해 계속하거나 **Cancel** 을 클릭합니다.
3. 제어를 가져오면 상단 바에 제어 시간과 **View only** 가 표시되고, 보기 라벨이 **You have control** 로 바뀝니다.

연결이 끊긴 동안이나 제한에 도달한 후에는 제어를 가져올 수 없습니다.

### 제어 종료

| 종료 방식 | 결과 |
| - | - |
| **View only** 클릭 | 키보드와 마우스를 돌려주고 보기 전용으로 돌아갑니다 |
| 30분 동안 입력이 없거나 연결이 끊김 | 자동으로 종료되고 보기 전용으로 돌아갑니다 |
| 다른 창이나 다른 기기에서 제어를 가져옴 | 마지막으로 제어를 가져온 쪽이 키보드와 마우스를 사용하며, 이 창은 보기 전용으로 돌아갑니다. 필요하면 **Take control** 을 클릭해 다시 가져옵니다 |

제어가 끝나면 그동안 클라우드 서버에서 실행된 각 세션에 **You used the cloud server for N minutes. The agent wasn’t affected.** 기록이 남습니다. 또한 다음에 메시지를 보낼 때 에이전트는 방금 사용자가 데스크톱을 사용했다는 사실을 알게 됩니다.

## 에이전트가 클라우드 서버에서 직접 처리를 요청할 때

에이전트가 계정 로그인이나 2단계 인증 코드 입력처럼 사용자가 직접 완료해야 하는 단계에 이르면, 입력창 위에 **Needs you on the cloud server** 가 표시됩니다.

* **Take control** 을 클릭하면 패널을 열면서 바로 제어를 가져옵니다(**View cloud server** 를 클릭하면 보기 전용으로 엽니다).
* 완료한 후 **Resolved** 를 클릭하면 에이전트가 계속 진행합니다. 더 이상 필요하지 않으면 **Not now** 를 클릭합니다.

[입력 필요](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)를 참고하세요.

## 연결 상태

| 표시되는 내용 | 할 수 있는 작업 |
| - | - |
| **Connecting to the cloud server…**, **Desktop starting, connecting shortly…**, **Getting the desktop ready**, **Reconnecting…** | 기다립니다. 자동으로 연결됩니다 |
| **The desktop isn’t ready yet** | **Retry** 를 클릭합니다 |
| **Can’t reach the cloud server** 또는 **The desktop didn’t connect…** | 다른 데스크톱 창을 닫은 후 **Try again** 을 클릭합니다 |
| **Desktop traffic or window limit reached…** | 다른 데스크톱 창을 닫거나, 나중에 **Try again** 을 클릭합니다 |
| **Today’s desktop traffic is used up…** | 다음 날 다시 엽니다. 에이전트와 작업에는 영향이 없습니다 |
| **Desktop unavailable** | 복구되면 **The desktop is back. You can reconnect** 가 표시됩니다 |
| **This cloud server doesn’t support the desktop yet** | 할 일이 없습니다. 플랫폼이 자동으로 업그레이드합니다 |

* 연결이 끊겼거나, 시간이 초과되었거나, 제한에 걸린 동안에도 에이전트는 클라우드 서버에서 계속 작업합니다. 잠시 화면을 볼 수 없을 뿐입니다.
* 상태 줄 오른쪽의 새로 고침 아이콘으로 수동으로 다시 연결할 수 있습니다.

## 데스크톱 트래픽과 보기 수

* 원격 데스크톱 트래픽은 하루 단위로 집계됩니다. Cloud server 페이지의 **Traffic** 행에 오늘의 사용량과 한도(화면에 표시되는 대로)가 표시됩니다. 매일 00:00 UTC에 초기화되며, 사용량이 일정 비율에 도달하면 앱 내 알림을 받습니다.
* 클라우드 서버 하나에서 동시에 열 수 있는 데스크톱 보기는 최대 3개입니다.
* 패널 탭은 화면에 보이는 동안에만 데스크톱 트래픽을 사용합니다.
* 데스크톱 트래픽은 원격 데스크톱 보기에만 영향을 줍니다. 에이전트나 실행 중인 세션에는 영향을 주지 않습니다.

## 참고 및 제한 사항

* 제어를 가져와도 에이전트는 일시 중지되지 않습니다. 에이전트가 기다려야 할 때는 세션에서 에이전트가 사용자에게 요청하도록 하거나, 먼저 현재 턴을 중지하세요.
* 모바일 웹은 보기 전용이며 제어를 가져올 수 없습니다.
* 실행 방식이 **On your device** 인 세션도 클라우드 서버 패널을 열 수 있지만, 그 조작은 보기에 나타나지 않습니다.

## 자주 묻는 질문

### 제어를 가져오면 에이전트가 멈추고 기다리나요?

아니요. 제어 가져오기는 키보드와 마우스를 넘겨받는 것뿐입니다. 에이전트는 계속 실행되며, 내 조작과 에이전트의 조작이 동시에 일어날 수 있습니다.

### 이 창에서 보기만 되고 조작할 수 없는 이유는 무엇인가요?

다른 창이나 다른 기기에서 클라우드 서버의 제어를 가져왔기 때문에 이 창이 자동으로 보기 전용으로 바뀌었습니다. **Take control** 을 클릭하면 제어를 다시 가져올 수 있습니다.

### 보기 연결이 끊기면 세션이 중지되나요?

아니요. 보기 연결과 실행 중인 세션은 서로 별개입니다. 연결이 끊긴 동안에도 에이전트는 계속 작업합니다.

## 관련 문서

* [클라우드 서버 개요](https://docs.aihubmix.com/ko/cloud/cloud-host/overview.md)
* [클라우드 서버 관리자 권한](https://docs.aihubmix.com/ko/cloud/cloud-host/admin-permission.md)
* [입력 필요](https://docs.aihubmix.com/ko/cloud/sessions/user-intervention.md)
* [오른쪽 패널](https://docs.aihubmix.com/ko/cloud/interface/right-drawer.md)


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