6. Windows 클라이언트
가이드북 목차 · 이전: 사용자와 VM 배정 · 다음: Android
Windows 클라이언트는 내 PC에서 배정받은 VM이나 로컬 PC에 연결하는 앱입니다. 접속할 컴퓨터에는 Host가 설치되어 있어야 합니다.
처음 접속하는 순서
작업 위치: 지금 사용할 내 Windows PC
관리자에게 서버 주소·ToTBVDI 아이디·비밀번호를 먼저 받으세요.
| 순서 | 할 일 | 완료 확인 |
|---|---|---|
| 1 | 앱 설치 | 내 PC에서 ToTBVDI 클라이언트가 열림 |
| 2 | 서버 주소 테스트·저장 | 연결 확인 후 주소가 저장됨 |
| 3 | 계정으로 로그인 | 내 데스크톱에 배정된 컴퓨터가 보임 |
| 4 | 스트리밍 연결 | 별도 창에 원격 Windows가 보임 |
처음에는 화질·배율·USB 설정을 바꾸지 않고 연결해 보세요. 원격 화면이 나온 뒤 필요한 기능을 하나씩 사용하면 됩니다.
설치와 로그인
- 관리자가 알려 준
https://vdi.example.com/get/client를 엽니다. - Windows 클라이언트 설치 파일을 실행합니다.
- 설치를 마친 뒤 ToTBVDI 클라이언트를 실행합니다.
예시의 vdi.example.com을 관리자가 알려 준 실제 서버 주소로 바꾸세요.
HTTP 서버라면 http://서버IP:18480/get/client에서 받습니다.
클라이언트는 일반 사용자 권한으로 실행합니다. 설치·업데이트·USB 드라이버 작업에는 관리자 승인이 필요할 수 있습니다. Host 설정과 Host 설치는 접속할 컴퓨터에서 관리자 권한으로 진행합니다.
서버 주소 저장
- 로그인 화면의 서버 설정 필요를 누릅니다.
- HTTPS 또는 관리자가 안내한 HTTP를 선택합니다.
- 서버 주소에
https://vdi.example.com을 입력합니다. - 연결 테스트를 누릅니다.
- 연결이 확인됐어요가 표시되면 저장을 누릅니다.
이미 주소가 있으면 로그인 화면 위쪽의 서버 주소를 눌러 바꿉니다. 주소나 연결 방식을 바꾸면 연결 테스트를 다시 해야 합니다.
주소에는 맨 앞의 https:// 또는 http://와 필요한 포트까지 넣으세요.
브라우저의 /admin/ 같은 뒤쪽 경로는 빼고 서버 주소 부분만 사용하세요.
HTTP 주의: 로그인 정보·화면·입력이 암호화되지 않습니다. 믿을 수 있는 내부 네트워크에서만 사용하세요.
HTTP를 쓸 때는 관리자가 안내한 포트까지 입력합니다. 예: http://vdi.example.com:18480.
경고 내용을 확인한 뒤 이 주소에 HTTP 사용을 누릅니다.
계정으로 로그인
- 관리자가 만든 아이디를 입력합니다.
- 비밀번호를 입력합니다.
- 이 PC에 비밀번호를 저장하려면 비밀번호 기억을 켭니다.
- 로그인을 누릅니다.
아이디는 서버별로 기억합니다. 선택한 비밀번호는 현재 사용자의 Windows 자격 증명에 저장합니다. 공용 PC에서는 비밀번호 기억을 끄세요.
완료 확인: 로그인 화면 대신 내 데스크톱 목록이 나옵니다. 비밀번호 오류는 관리자에게 계정 확인을 요청하고, 목록이 비어 있으면 VM 배정을 확인해 달라고 요청하세요.

내 데스크톱 찾기
로그인하면 배정받은 컴퓨터만 표시됩니다. VM 생성이나 사용자 배정은 관리자 웹에서 처리합니다.
| 화면 요소 | 사용하는 방법 |
|---|---|
| 구분 | 전체, VM, 로컬 PC로 고릅니다. 두 종류를 모두 배정받았을 때 보입니다. |
| 상태 | 전체, 실행 중, 꺼짐으로 고릅니다. |
| 검색 | 이름·번호·분류로 찾습니다. Ctrl+F로 검색을 열 수 있습니다. |
| 미리보기 | 카드의 화면 그림을 켜거나 끕니다. |
| 새로고침 | 목록과 연결 준비 상태를 다시 확인합니다. |
| ⋯ | 연결 모드·스트리밍 설정·긴급 콘솔·Host 업데이트 등을 엽니다. 가능한 항목은 컴퓨터마다 다릅니다. |
| ⏻ 전원 | 권한이 있는 전원 작업을 엽니다. |
카드는 창 너비에 맞춰 자동으로 배치됩니다. 카드 본문을 누르는 것만으로는 연결되지 않습니다.
미리보기는 최근 화면이며 현재 화면과 다를 수 있습니다. 화면 잠금·Windows 로그인 화면은 미리보기로 촬영하지 않습니다. 관리자가 미리보기를 꺼 두면 새 화면을 받을 수 없습니다.

전원 켜기·끄기
- 사용할 카드의 ⏻ 전원을 누릅니다.
- 필요한 작업을 선택합니다.
- 확인창에서 대상과 영향을 확인합니다.
- 작업을 실행합니다.
| 작업 | 동작 |
|---|---|
| 켜기 | VM의 전원을 켭니다. 로컬 PC는 관리자가 Wake-on-LAN을 설정한 경우 켤 수 있습니다. |
| 종료 | Windows에 정상 종료를 요청합니다. |
| 다시 시작 | 컴퓨터를 다시 시작합니다. 연결이 끊길 수 있습니다. |
| 정지 | VM 전원을 즉시 끊습니다. 로컬 PC에는 제공하지 않습니다. |
정지 주의: 저장하지 않은 작업이 사라질 수 있습니다. Windows가 응답하지 않을 때만 사용하세요.
전원 버튼이 비활성화되어 있으면 표시된 이유를 확인하세요. 전원 권한은 관리자가 계정과 컴퓨터별로 부여합니다.
스트리밍 연결
카드가 꺼짐이면 ⏻ 전원 → 켜기로 먼저 시작하세요. 준비 오류가 보이면 그 문구를 먼저 확인하세요(문제 해결).
- 카드의 스트리밍 연결을 누릅니다.
- 연결 확인창의 대상과 연결 방식을 확인합니다.
- 연결을 누릅니다.
- 원격 화면이 나타나면 화면 안을 클릭합니다.
카드 그림의 ▶ 또는 선택한 카드에서 Enter로도 연결을 시작합니다.
좁은 창에서는 기본 버튼이 연결로 짧게 표시될 수 있습니다.
원격 화면은 별도 창에 열리고 내 데스크톱 목록은 남아 있습니다. 같은 컴퓨터를 다시 열면 기존 원격 창을 표시합니다. 원격 창을 닫을 때는 연결 종료를 확인하며, 컴퓨터의 전원은 끄지 않습니다.
첫 화면이 나오면 해볼 것
- 원격 Windows의 시작 메뉴를 여세요.
- 메모장을 실행하세요.
- 짧은 글자를 입력하세요.
- 메모장 창의 제목 부분을 끌어 이동해 보세요.
완료 확인: 글자가 원격 메모장에 써지고, 끈 창이 따라 움직입니다. 한글이 필요하면 원격 화면을 클릭한 뒤 한/영 키도 확인하세요.
이제 기본 접속은 끝났습니다. 글자 크기는 배율, 파일 복사는 복사·붙여넣기, 접속 종료는 툴바의 연결 끊기를 사용하세요.
Windows 키와 한/영 키
원격 창이 앞에 있고 화면 안을 클릭해 입력을 넘긴 동안에는 Windows 키와 Alt+Tab 등을 원격 Windows로 보냅니다.
물리 키보드의 한/영 키도 원격 Windows의 입력 언어를 전환합니다.
- 내 PC로 키보드 입력을 돌리려면
Ctrl+Alt+Shift+F12를 누릅니다. - 원격 입력을 다시 시작하려면 원격 화면 안을 클릭합니다.
툴바·메뉴를 열거나 다른 창으로 이동하면 입력을 돌려받습니다.
Ctrl+Alt+Del은 스트리밍으로 전송할 수 없습니다.
원격 작업 관리자는 Ctrl+Shift+Esc로 엽니다.
세션 툴바
툴바는 원격 창 맨 위의 작은 손잡이를 누르면 열리는 조작 막대입니다. 처음에는 화면·배율·연결 끊기만 알아도 사용할 수 있습니다.
- 원격 창 위쪽 중앙의 작은 손잡이를 클릭합니다.
- 필요한 메뉴를 선택합니다.
손잡이에 마우스를 올리면 지연 시간을 볼 수 있습니다. 툴바는 클릭해야 열립니다.
명령을 쓰거나 원격 화면을 클릭하면 툴바가 접힙니다.
Esc나 접기 버튼으로도 접을 수 있습니다.
바 고정을 켜면 열어 둡니다.

| 메뉴 | 용도 |
|---|---|
| 연결 품질 | 왕복 지연, 디코딩 프레임, 실제 영상 수신량, UDP/TCP 경로를 봅니다. |
| 화면 | 창 모드, 전체 화면, 지원되는 모든 모니터 사용을 고릅니다. |
| 배율 | 원격 Windows의 글자와 UI 크기를 바꿉니다. |
| 설정 | 목표 프레임·영상 전송률·오디오·하드웨어 디코딩을 조절합니다. |
| 공유 폴더 | 선택한 내 PC 폴더를 원격 컴퓨터에서 엽니다. |
| USB 장치 | 내 PC의 USB 장치를 원격 컴퓨터에 연결합니다. |
| 마우스 잠금 | 상대 움직임을 보내는 마우스 입력을 켭니다. |
| 최소화 | 원격 창을 최소화합니다. |
| 사용안내 | 현재 연결의 프린터·USB·공유 폴더·복사 권한과 사용법을 봅니다. |
| 연결 끊기 | 현재 원격 연결을 끝냅니다. |
공유 메뉴는 관리자 권한과 Host 지원 상태에 따라 달라집니다. 회색으로 표시되면 메뉴에 나온 이유를 확인하세요.
해상도와 배율
해상도는 원격 창의 실제 크기에 자동으로 맞춥니다. 해상도를 바꾸려면 원격 창의 크기를 조절하세요.
- 툴바의 배율을 누릅니다.
- 100%, 125%, 150%, 175%, 200% 중 하나를 고릅니다.
- 현재 적용된 배율 표시를 확인합니다.
배율은 원격 Windows의 글자 크기를 바꿉니다. 적용 확인 중이나 현재 배율 확인 전이면 적용을 확인할 때까지 기다리세요. Windows가 허용하는 배율은 화면 크기에 따라 달라질 수 있습니다.
두 모니터 사용
- 내 PC에 모니터 두 개를 연결합니다.
- 툴바의 화면을 누릅니다.
- 모든 모니터 사용을 선택합니다.
내 PC에 정확히 두 모니터가 있고 Host가 독립 화면 스트리밍을 지원해야 합니다. 두 모니터에는 서로 다른 원격 화면을 표시합니다. 툴바와 팝업은 주 모니터에 표시됩니다.
스트리밍은 Host의 ToTBVDI 가상 화면을 사용합니다. 연결 중에는 다른 Host 화면이 꺼질 수 있으며, 연결이 끝나면 저장한 화면 구성을 복구합니다.
프레임·화질·소리
- 툴바의 설정을 누릅니다.
- 목표 프레임과 영상 전송률을 고릅니다.
- 변경을 적용하려면 다시 연결을 누릅니다.
새 연결의 기본값은 60 fps, 자동 (권장) 전송률입니다. 직접 저장한 설정이 있으면 그 값을 사용합니다. 목표 프레임과 실제 디코딩 프레임은 다를 수 있습니다.
자동 전송률은 연결 상태와 Host가 허용한 한도에 맞춰 조절하며 최대 100 Mbps입니다. 현재 수신량은 연결 품질에서 확인합니다. 화면이 깨질 때는 하드웨어 디코딩을 끄고 다시 확인할 수 있습니다.
오디오는 원격 컴퓨터의 소리를 내 PC 스피커로 듣는 설정입니다. Host에 소리 장치가 없으면 스위치만 켜도 소리가 나오지 않습니다. 카드의 소리 배지에서 안내를 확인하거나 관리자에게 Proxmox 사운드카드 설정을 요청하세요.

마우스 잠금
마우스 잠금은 이전의 게임 마우스 기능입니다. 일반 사용은 잠금을 끈 상태의 절대 좌표 입력을 사용합니다. 잠금을 켜면 상대 움직임을 보내며, 사용할 수 있으면 가상 USB 마우스를 연결합니다.
- 툴바의 마우스 잠금을 누릅니다.
- 해제 방법 안내를 읽습니다.
- 확인을 눌러 마우스를 넘깁니다.
- 잠금을 풀려면
Ctrl+Alt+Shift+Z를 누릅니다.
모든 새 연결은 마우스 잠금이 꺼진 상태로 시작합니다. 잠금 중에는 원격 컴퓨터의 커서를 표시합니다.
USB 마우스를 연결하지 못하면 일반 입력으로 동작할 수 있습니다. 이때 일부 게임은 마우스 입력을 받지 않을 수 있습니다. 관리자에게 USB 권한과 Host의 ToTBVDI USB 컨트롤러 상태를 확인해 달라고 요청하세요.
복사와 장치 공유
관리자는 사용자와 컴퓨터별로 공유 권한을 부여합니다. 텍스트·파일의 전송 방향도 제한할 수 있습니다. 먼저 사용안내에서 현재 연결에 허용된 기능을 확인하세요.
복사·붙여넣기
클립보드는 복사한 글자·이미지·파일을 잠시 보관하는 기능입니다. 원격 컴퓨터와 주고받으려면 관리자가 방향별 공유 권한을 허용해야 합니다.
- 원본 파일이나 글자를 선택합니다.
Ctrl+C로 복사합니다.- 대상 컴퓨터의 폴더나 입력 칸을 엽니다.
Ctrl+V로 붙여넣습니다.
파일 전송은 붙여넣을 때 시작합니다. 복사만 했을 때는 파일을 전송하지 않습니다. 허용된 방향으로만 전송할 수 있습니다. 이미지 복사·붙여넣기에도 해당 방향의 파일 클립보드 권한이 필요합니다.
처음 확인할 때는 짧은 글자부터 복사해 보세요. 파일이 안 붙으면 사용안내에서 파일 권한과 보낼 방향을 확인하세요.
공유 폴더
- 툴바의 공유 폴더를 누릅니다.
- 폴더 추가… 버튼을 누릅니다.
- 내 PC에서 공유할 폴더를 고릅니다.
- 변경을 막으려면 읽기 전용을 켭니다.
- 열기를 눌러 원격 탐색기에서 확인합니다.
기본 공유에서는 원격 컴퓨터가 폴더의 파일을 읽고 바꿀 수 있습니다. 필요한 폴더만 선택하세요. 연결이 끝나면 공유가 해제됩니다.
프린터
- 원격 Windows의 인쇄창을 엽니다.
- ToTBVDI 프린터 (내 PC) 항목을 선택합니다.
- 원격 Windows에서 인쇄를 실행합니다.
- 내 PC에 도착한 문서의 미리보기를 확인합니다.
- 프린터에서 출력할 프린터를 고릅니다.
- 매수를 조절합니다.
- 인쇄를 누릅니다.
파일로 보관하려면 PDF로 저장을 누릅니다. 프린터 공유는 서버 관리자가 허용해야 합니다. 툴바에 별도 프린터 버튼은 없습니다.
USB 장치
- 툴바의 USB 장치를 누릅니다.
- 드라이버 안내가 있으면 USB 드라이버 설치… 버튼을 누릅니다.
- 연결할 장치의 연결을 누릅니다.
- 원격 Windows에서 장치를 사용합니다.
- 사용을 마치면 장치의 연결 끊기를 누릅니다.
연결 중에는 장치를 내 PC에서 사용할 수 없습니다. 저장 장치는 원격 Windows에서 하드웨어 안전하게 제거한 뒤 연결을 끊으세요. 드라이버 설치 후 재시작 안내가 나오면 열린 작업을 저장한 뒤 진행하세요.
긴급 콘솔
Windows 로그인이나 Host 연결 문제로 스트리밍을 사용할 수 없을 때 쓰는 Proxmox VM용 화면입니다. 로컬 PC에는 제공하지 않습니다.
- VM 카드의 ⋯ 메뉴를 누릅니다.
- 긴급 콘솔을 선택합니다.
- 확인창의 긴급 콘솔 연결을 누릅니다.
콘솔은 앱 안의 웹 화면으로 열립니다. 같은 로그인으로 연결하므로 아이디·비밀번호를 다시 입력하지 않습니다. Windows에서 WebView2 설치 안내가 나오면 안내에 따라 설치한 뒤 다시 여세요.
콘솔은 VM의 QEMU 기본 화면을 보여 줍니다. GPU 패스스루 화면이 이곳에 보이는 것은 보장되지 않습니다. 콘솔에 화면이 없으면 관리자에게 QEMU 화면 장치와 콘솔 상태를 확인해 달라고 요청하세요.