VNC 원격 접속 초기화 (Linux 클라이언트)
Linux 클라이언트에서 10888 WEB 콘솔(Linux 클라이언트 업데이트 참조)에 로그인하면 「VNC 초기화」 카드가 나타납니다. 클릭 한 번으로 VNC 구성과 콘솔 보고가 완료되며, 콘솔에서 해당 클라이언트에 원격으로 접속할 수 있습니다. 대부분의 경우 완전 자동이며 수동 설정이 필요 없습니다. 자동 흐름이 환경 때문에 막힐 때(x11vnc 없음, 데스크톱이 Wayland 등)만 아래 「수동 처리」 절의 작업이 필요합니다.
원클릭 초기화가 하는 일
「VNC 초기화」를 클릭하면 클라이언트(vdclient, root로 실행)가 순서대로 자동 수행합니다:
- Apport 충돌 팝업 비활성화(Ubuntu/Debian만): x11vnc 설치가 실패할 때 "시스템 프로그램 문제가 감지됨" 창이 곧 인계될 데스크톱 위에 뜨는 것을 방지합니다.
- 데스크톱 세션 유형 확인: Wayland 세션이면 x11vnc가 화면을 캡처할 수 없으므로 Xorg 전환을 안내합니다(아래 경우 2).
- x11vnc 설치 보장: 없으면 배포판 패키지 관리자(apt / dnf / yum / zypper / pacman)로 온라인 자동 설치.
- 8자리 동적 랜덤 비밀번호 생성 후 VNC 비밀번호 파일에 기록.
- 그래픽 세션의 DISPLAY와 XAUTHORITY 자동 검색 후
:0의 포트 9015에서 x11vnc 시작. - IP, 포트 9015, 동적 비밀번호를 부팅 서버로 자동 보고하여 콘솔이 원격 접속할 수 있게 합니다 — 비밀번호를 입력할 필요가 전혀 없습니다.
- 자동 시작 표시 기록: 이후 클라이언트가 부팅될 때마다 데스크톱과 서버가 준비되면 vdclient가 자동으로 VNC를 다시 시작합니다. 다시 클릭할 필요가 없습니다.
VNC 포트는 9015로 고정입니다. 제어 비밀번호는 초기화할 때마다 동적으로 생성되는 랜덤 문자열이며 클라이언트가 콘솔에 자동 보고합니다. 수동으로 설정할 수 없으며 그럴 필요도 없습니다.
자동 초기화 단계
- 클라이언트 본체의 브라우저에서
http://localhost:10888을 열고 관리자 계정(기본 admin / 123456)으로 로그인합니다. - 「VNC 초기화」 카드에서 「VNC 초기화」 버튼을 클릭합니다.
- "VNC가 초기화되었습니다"라고 표시되면 성공이며, 콘솔에서 원격 접속할 수 있습니다.
소프트웨어가 자동으로 처리하지 못할 때의 수동 처리
클릭 후 실패가 표시되면 아래 해당 경우에 따라 처리하세요. 처리 후에는 콘솔로 돌아가 「VNC 초기화」를 다시 클릭합니다 — 반드시 버튼으로 재시도해야 합니다. 버튼만이 VNC 정보를 콘솔에 보고하며, x11vnc를 수동으로 시작하기만 하면 보고되지 않아 콘솔이 접속할 수 없습니다.
경우 1: x11vnc를 찾을 수 없고 자동 설치도 실패
클라이언트가 네트워크에 연결되지 않거나 소프트웨어 소스가 설정되지 않은 경우에 흔합니다. "x11vnc를 찾을 수 없고 자동 설치에 실패했습니다. 수동으로 설치하세요: apt-get install -y x11vnc"와 같이 표시됩니다.
클라이언트 터미널에서 시스템 유형에 따라 x11vnc를 수동 설치하세요(vdclient는 root로 실행되며, 수동 설치에도 root 권한이 필요합니다):
| 시스템 | 설치 명령 |
|---|---|
| Ubuntu / Debian / Kylin / UOS(deb 계열) | apt-get install -y x11vnc |
| openEuler / Anolis / RHEL / CentOS(최신) | dnf install -y x11vnc |
| RHEL / CentOS(구버전) | yum install -y x11vnc |
| openSUSE | zypper install x11vnc |
| Arch | pacman -S x11vnc |
소스에 x11vnc가 없으면 먼저 사용 가능한 소프트웨어 소스를 설정하세요(또는 x11vnc와 의존성을 오프라인으로 받아 수동 설치). 설치 후 콘솔로 돌아가 「VNC 초기화」를 다시 클릭합니다.
경우 2: 데스크톱이 Wayland여서 VNC가 화면을 캡처할 수 없음
GNOME 등의 데스크톱은 기본적으로 Wayland 컴포지터를 사용하지만, x11vnc는 X11을 통해 화면을 캡처하므로 Wayland에서는 데스크톱을 캡처할 수 없습니다. Xorg 세션으로 전환해야 합니다.
콘솔에서 자동 전환(권장): 「VNC 초기화」를 클릭했을 때 Wayland가 감지되면 확인 대화상자가 나타납니다:
현재 Wayland 데스크톱이라 VNC가 화면을 캡처할 수 없습니다. Xorg로 전환하면 디스플레이 관리자를 다시 시작하고 현재 데스크톱 세션에서 로그아웃됩니다(약 15초 후 자동으로 Xorg로 돌아갑니다). 계속할까요?
"확인"을 클릭하면 클라이언트가 자동으로 GDM 구성을 수정하고(WaylandEnable=false 기록, 원본 파일은 *.osvbak로 백업) 디스플레이 관리자를 다시 시작하여 Xorg로 전환합니다. 데스크톱이 Xorg로 돌아오면(약 15초) 「VNC 초기화」를 다시 클릭합니다.
자동 전환 실패 시 수동 처리: GDM 구성을 찾을 수 없음, 디스플레이 관리자 재시작 실패, 또는 전환 후에도 여전히 Wayland라고 표시되면 클라이언트 터미널에서 수동으로 조작합니다:
GDM 구성(Debian/Ubuntu/Kylin/UOS는
/etc/gdm3/custom.conf, Red Hat 계열은/etc/gdm/custom.conf)을 편집하여[daemon]섹션에 다음을 추가하거나 변경합니다:ini[daemon] WaylandEnable=false디스플레이 관리자를 다시 시작합니다(현재 데스크톱에서 로그아웃되므로 먼저 작업을 저장하세요):
bashsystemctl restart display-manager클라이언트를 재부팅해도 됩니다. 또는 GDM 로그인 화면 오른쪽 아래 톱니바퀴에서 "Xorg에서"(on Xorg)를 선택해 로그인합니다.
Xorg 세션에 진입했는지 확인한 후 콘솔로 돌아가 「VNC 초기화」를 다시 클릭합니다.
WaylandEnable=false를 설정했는데도 여전히 Wayland인 경우: 보통 현재 세션이 다시 로그인되지 않았기 때문입니다. 클라이언트를 재부팅하거나 Xorg로 다시 로그인한 후 초기화하세요.
경우 3: Xorg로 전환한 후 한 번 더 클릭
자동 Xorg 전환은 데스크톱을 로그아웃하고 다시 로그인하므로(약 15초) 이번 초기화가 중단됩니다. 데스크톱이 돌아오면 콘솔로 돌아가 「VNC 초기화」를 다시 클릭하여 시작과 보고를 완료합니다.
확인 및 문제 해결
클라이언트에서 x11vnc가 9015 포트에서 실행 중인지 확인:
bashpgrep -a x11vnc ss -lntp | grep 9015시작 로그는 vdclient 프로그램 디렉터리 아래
log/x11vnc.log에 있습니다. 실패 시 원인 파악에 사용하세요(DISPLAY/XAUTHORITY 미검색, 포트 사용 중, 캡처 BadMatch 등).콘솔 측에서 해당 클라이언트가 원격 접속 가능으로 표시되면 보고에 성공한 것입니다.
주의 사항
이 기능은 Linux 클라이언트에서만 사용할 수 있습니다. Windows 클라이언트는 독립적인 TightVNC 링크를 사용하며 이 버튼이 없습니다.
클라이언트에 실행 중인 그래픽 데스크톱 세션(X/Xorg)이 있어야 합니다. 문자 터미널만 있거나 데스크톱에 로그인하지 않은 상태에서는 초기화할 수 없습니다.
한 번 초기화하면 부팅 시 자동 시작됩니다. 클라이언트 재부팅 후 다시 클릭할 필요가 없으며, 매번(자동 시작 포함) 동적 비밀번호를 다시 생성하여 콘솔에 보고합니다.
신창 클라이언트(Kylin, UOS, openEuler, Anolis 등)도 절차가 완전히 동일합니다. deb 계열은 Kylin / UOS 행, Red Hat 계열은 openEuler / Anolis 행에 따라 처리하세요.