SSH X11 포워딩을 통해 YaST GUI가 실행되지 않는 문제를 해결하는 방법

YaST의 그래픽 창이 SSH를 통해 실행되지 않으면 먼저 X11 포워딩이 제대로 작동하는지 확인하십시오. 클라이언트 컴퓨터에서 `yaST.h` 명령어로 연결한 ssh -X admin@server다음 다른 원격 그래픽 프로그램을 실행해 보십시오. 해당 프로그램이 열리지만 YaST가 `<X11>` XIO: fatal IO error 11과 같은 localhost:11.0오류 메시지를 표시하는 경우, SUSE에서는 다음과 같은 해결 방법을 제시합니다. 해당 YaST 명령어 QT_XCB_GL_INTEGRATION=none앞에 `--X11`을 붙여 실행하십시오. 예를 들어 `yaST.h`를 사용합니다 QT_XCB_GL_INTEGRATION=none yast2 disk. 이 해결 방법은 Qt/OpenGL 포워딩 오류에 적용되며, 로컬 X 서버가 없거나, `X11`이 설정되지 않았거나 DISPLAY, 서버 포워딩이 차단되었거나, YaST 모듈이 설치되지 않은 경우에는 적용되지 않습니다.

가장 빠르게 확인할 수 있는 것부터 시작하세요.

YaST의 그래픽 인터페이스를 사용하려면 클라이언트 측에 X 디스플레이가 필요하고, SSH X11 터널이 정상적으로 작동해야 합니다. SSH 클라이언트는 DISPLAY포워딩이 활성화된 경우 원격 호스트에 포워딩 값을 설정합니다. 그래픽 포워딩이 비활성화된 경우에도 일반 SSH 로그인은 가능하므로, 터미널 세션이 성공적으로 연결된 것만으로는 X11 터널이 활성화되었음을 확인할 수 없습니다.

1. 클라이언트 컴퓨터에 활성 X 서버 또는 X11 호환 디스플레이 세션이 있는지 확인하십시오. Windows에서는 SUSE에서 PuTTY의 연결 > SSH > X11 에서 X11 포워딩을 활성화하는 방법을 안내하고 있으며 , 로컬 X 서버도 사용 가능해야 합니다.
2. 전달 기능을 활성화하여 다시 연결하세요 ssh -X admin@server. 실제 계정과 호스트 이름을 사용하세요.
3. 원격 셸에서 를 확인하십시오 . 디스플레이 포워딩이 설정된 경우 일반적으로 또는 echo "$DISPLAY"와 같은 값이 표시됩니다 . 값이 비어 있으면 세션에서 X11 포워딩이 설정되지 않았음을 의미합니다.localhost:10.0localhost:11.0
4. 원격 시스템에 설치된 소형 X 애플리케이션을 실행하십시오. 로컬 데스크톱에서 열리지 않으면 YaST 문제 해결 전에 포워딩 설정을 수정하십시오.

예를 들어, Linux 워크스테이션에서 연결하는 관리자는 `yaST` 명령어를 사용하여 ssh -X ops@server.example테스트 애플리케이션을 실행할 수 있습니다. 애플리케이션 창이 로컬에 나타나면 SSH 터널과 로컬 디스플레이가 정상적으로 작동하는 것입니다. 나타나지 않으면 "디스플레이를 열 수 없습니다"와 같은 오류 메시지가 표시되며, 이는 YaST 관련 그래픽 해결 방법이 아닌 X11 경로와 관련된 문제입니다.

SUSE에서 제공하는 YaST 전용 해결 방법을 적용하십시오.

SUSE의 SLES 15 SP7 배포 가이드에는 X 포워딩을 사용한 SSH 기반 YaST GUI 실행이 실패하는 사례가 설명되어 있습니다 . 권장되는 해결 방법은 해당 명령에 대해 Qt의 XCB GL 통합을 비활성화하는 것입니다. 필요한 모듈에 대한 명령을 실행하십시오. 예를 들면 XIO: fatal IO error 11 (Resource temporarily unavailable)다음과 같습니다 .localhost:11.0

QT_XCB_GL_INTEGRATION=none yast2 disk

YaST 설치 인터페이스의 경우, 동일한 가이드에서 다음과 같은 예시를 제공합니다.

QT_XCB_GL_INTEGRATION=none yast.ssh

작업에 맞는 명령어를 사용하세요. yast2 disk예를 들어, `--1`은 디스크 모듈을 열고, `--2`는 yast.ssh설치 워크플로에 사용됩니다. 단일 명령어 앞에 접두사를 붙이면 해당 실행에만 설정이 적용됩니다. 다른 프로그램의 Qt 동작을 변경해야 할 특별한 이유가 없는 한, 이 설정을 전역 셸 프로필에 영구적으로 추가하지 마세요.

이 해결 방법은 X11 자체는 정상적으로 작동하지만 YaST가 종료되거나 특정 XIO 오류를 출력하는 경우에 특히 유용합니다. 동일한 오류가 계속 발생하는 경우 다른 모듈을 테스트하고 클라이언트 및 서버 포워딩 설정을 검토하십시오. 다른 그래픽 오류는 원인이 다를 수 있으므로 SUSE에서 제공하는 해결 방법이 모든 Qt, GPU 또는 디스플레이 문제를 해결하는 일반적인 방법은 아닙니다.

DISPLAY가 비어있을 경우 SSH 서버를 확인하십시오.

SUSE 서버에서 SSH 데몬 구성에 X11 포워딩이 허용되어 있어야 합니다. 관리자는 /etc/ssh/sshd_config유효한 구성에 다음 사항이 포함되어 있는지 확인할 수 있습니다.

X11Forwarding yes

서버 정책은 포함된 구성 파일을 통해 제공되거나 중앙에서 관리될 수 있으므로 한 줄만 수정하는 것으로는 충분하지 않을 수 있습니다. 승인된 변경 후에는 구성을 검증하고 서비스를 다시 로드하십시오.

sudo sshd -t
sudo systemctl reload sshd.service

설정을 확인하는 동안 현재 SSH 세션을 열어 두고, 세션을 닫기 전에 두 번째 로그인을 시도하여 테스트하십시오. 구문 검사는 잘못된 설정을 감지하지만, 정책이 올바른지 또는 클라이언트에서 포워딩이 제대로 작동하는지는 확인하지 못합니다. SSH 서버를 관리하지 않는 경우, 시스템 파일을 직접 수정하기보다는 서버 관리자에게 정책 확인을 요청하십시오.

서버 측 변경 후에는 다시 연결하고 DISPLAY원격 애플리케이션 테스트를 반복하십시오. 서버에서 권한 문제가 보고되면 원격 사용자가 유효한 X 권한 항목을 가지고 있는지 확인하십시오 xauth list. 창을 열기 위해 권한 쿠키를 수동으로 복사하거나 디스플레이 접근 제어를 약화시키지 마십시오.

YaST를 관리자 권한으로 실행하되 화면 표시를 유지하십시오.

YaST는 시스템 설정을 변경하므로 일반적으로 관리자 권한이 필요합니다. 흔히 발생하는 혼란은 권한이 없는 사용자가 테스트 창을 표시할 수는 있지만, 권한을 상승시킨 후에는 YaST가 작동하지 않는다는 점입니다. 이는 권한이 상승된 프로세스가 DISPLAY연결에 필요한 전달된 인증 데이터나 X 인증 데이터를 유지하지 못하기 때문일 수 있습니다.

조직에서 승인한 권한 상승 방법을 사용하고 YaST 프로세스가 수신하는 내용을 확인하십시오. 단순히 GUI를 얻기 위해 루트 SSH 로그인을 직접 허용하지 마십시오. SUSE의 보안 지침에서는 권한이 없는 사용자로 로그인하여 sudo루트 명령을 사용하는 것을 권장합니다. sudo 정책에서 디스플레이 관련 환경 변수를 의도적으로 필터링하는 경우, 관리자에게 범위가 제한된 승인된 방법을 요청하십시오. 광범위한 환경 변수 보호 규칙이나 모든 호스트 사용자에게 로컬 디스플레이를 노출하는 명령은 사용하지 마십시오.

관련 진단 구분은 간단합니다. 일반 계정으로 X 애플리케이션이 실행되었지만 YaST가 관리자 권한으로 실행했을 때만 실패하는 경우, 권한 및 인증 전달 문제를 집중적으로 살펴보십시오. 일반 계정으로 실행했을 때와 YaST 모두 실패하는 경우, SSH 클라이언트, 로컬 X 서버 및 서버 포워딩 설정을 다시 확인하십시오.

그래픽이 필요하지 않은 경우 텍스트 인터페이스를 선택하세요.

X11 포워딩은 특정 워크플로에서 그래픽 인터페이스가 반드시 필요한 경우 유용하지만, 종속성이 추가되고 지연 시간이 긴 연결에서는 속도가 느려질 수 있습니다. YaST는 터미널 세션을 위한 ncurses 텍스트 인터페이스도 제공합니다. SUSE는 디스크 모듈에 대해 이를 강제로 활성화하는 방법을 다음과 같이 문서화했습니다.

yast2 disk --ncurses

클라이언트에 X 서버가 없거나 그래픽 세션이 불안정한 경우, 헤드리스 서버에서 이 방법을 사용하는 것이 실용적입니다. 또한, 지원되는 옵션이 있는 경우 YaST 모듈을 명령줄에서 실행할 수도 있습니다. 모듈 목록은 `yaST.modules` 명령어로 확인하고 yast -l, 모든 그래픽 모듈이 명령줄에서 동일한 기능을 제공한다고 가정하기보다는 해당 모듈의 도움말을 참조하십시오.

증상에서 행동으로 이어지는 안내

보안 및 버전 관련 참고 사항

X11 포워딩은 단순한 시각적 편의 이상의 기능을 제공합니다. 원격 그래픽 프로그램이 클라이언트의 디스플레이와 통신할 수 있도록 해주기 때문입니다. 신뢰할 수 있는 시스템에서만 사용하십시오. OpenSSH는 신뢰할 수 없는 포워딩과 신뢰할 수 있는 포워딩을 구분합니다 . 신뢰할 수 있는 포워딩은 원격 X 클라이언트에게 로컬 디스플레이에 대한 더 넓은 접근 권한을 제공합니다. 먼저 신뢰할 수 있는 -X포워딩 부터 시작하십시오 . 특정 애플리케이션에서 필요로 하고 보안 정책에서 허용하는 경우에만 신뢰할 수 있는 호스트에 대해 포워딩을 고려하십시오.-Y-X-Y

위의 YaST 오류 및 해결 방법은 SUSE Linux Enterprise Server 15 SP7 배포 가이드에서 확인되었습니다. YaST 모듈, 사용 가능한 그래픽 백엔드 및 시작 동작은 SLES, SLED 및 openSUSE 릴리스에 따라 다를 수 있습니다. 원격 호스트에 설치된 정확한 제품 및 버전에 대한 설명서를 참조하십시오. 2026년 10월 6일 검토 완료.

참고 자료: SUSE SLES 15 SP7 배포 가이드: SSH를 통한 YaST ; SUSE SLES 15 SP7 보안 및 강화 가이드: OpenSSH ; SUSE SLES 15 SP7 가이드: X Window System 및 인증 ; SUSE SLES 15 SP7 관리 가이드: YaST 텍스트 모드 및 명령줄 옵션 .