如何修復 YaST GUI 無法透過 SSH X11 轉送啟動的問題

如果 YaST 的圖形視窗透過 SSH 連線失敗，首先要檢查 X11 轉送是否正常運作。在客戶端電腦上，使用 `--x11-fm` 連接ssh -X admin@server，然後測試另一個遠端圖形程式。如果程式可以打開，但 YaST 顯示錯誤訊息XIO: fatal IO error 11（例如 `--x11-fm`）localhost:11.0，SUSE 文件中提供了一個針對性的解決方法：在受影響的 YaST 命令QT_XCB_GL_INTEGRATION=none前加上 `--x11-fm`。例如，使用QT_XCB_GL_INTEGRATION=none yast2 disk`--x11-fm`。此解決方法適用於 Qt/OpenGL 轉送失敗；它無法修復本機 X 伺服器缺失、未設定 `--x11-fm` DISPLAY、伺服器轉送被封鎖或 YaST 模組未安裝等問題。

先從最快的檢查開始。

YaST 圖形介面需要客戶端的 X 顯示器和正常運作的 SSH X11 隧道。DISPLAY當轉送功能啟用時，SSH 用戶端會在遠端主機上設定轉送值。即使圖形未轉發，普通的 SSH 登入仍然可以正常運作，因此僅憑終端會話成功並不能確認 X11 連線正常。

請確保用戶端電腦已啟用 X 伺服器或支援 X11 的顯示會話。在 Windows 系統中，SUSE 文件介紹如何在 PuTTY 中啟用 X11 轉發，具體路徑為：連接 > SSH > X11；此外，還必須配置本地 X 伺服器。
啟用轉送後重新連線：ssh -X admin@server請使用您的實際帳戶和主機名稱。
在遠端 shell 中，檢查echo "$DISPLAY"。如果已啟用 X11 轉送顯示，則通常應顯示類似localhost:10.0或的值localhost:11.0。如果值為空，則表示會話未建立 X11 轉送。
啟動一個安裝在遠端系統上的小型 X 應用程式。如果它無法在本機桌面打開，請先修復轉送問題，然後再排查 YaST 故障。

例如，管理員從 Linux 工作站連線後ssh -X ops@server.example，可以使用 `yaST install` 命令執行一個可用的測試應用程式。如果應用程式視窗出現在本機，則表示 SSH 隧道和本機顯示器運作正常。如果應用程式視窗沒有出現，則會出現類似「無法開啟顯示」的錯誤，這表示問題出在 X11 路徑上，而不是 YaST 特有的圖形解決方法。

應用 SUSE 針對 YaST 的特定解決方法

SUSE 的 SLES 15 SP7 部署指南記錄了一個透過 SSH 使用 YaST GUI 並啟用 X 轉送時發生故障的案例XIO: fatal IO error 11 (Resource temporarily unavailable)。localhost:11.0其建議的解決方法是停用該命令的 Qt XCB GL 整合。例如，運行所需模組的命令：

QT_XCB_GL_INTEGRATION=none yast2 disk

對於 YaST 安裝介面，同一指南給出了以下範例：

QT_XCB_GL_INTEGRATION=none yast.ssh

使用與任務相符的命令；此命令yast2 disk會開啟磁碟模組，而yast.ssh該命令則用於安裝工作流程。在單一命令前面加上前綴可使設定僅限於該次啟動。除非您有其他原因需要更改 Qt 對其他程式的行為，否則請勿將其永久新增至全域 shell 設定檔中。

當 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。避免手動複製授權 cookie 或降低顯示存取控制權限以開啟視窗。

以管理員權限執行 YaST，且不遺失顯示

YaST 會修改系統設置，通常需要管理員權限。一個常見的誤解是，非特權使用者可以顯示測試窗口，但權限提升後 YaST 卻無法運作。這是因為提升權限後的進程可能沒有保留連線DISPLAY所需的轉送資料或 X 授權資料。

使用貴組織認可的權限提升方法，並檢查 YaST 進程接收到的資訊。不要為了獲得圖形使用者介面 (GUI) 而啟用直接 root 使用者 SSH 登入；SUSE 的安全指南建議以非特權使用者身分登錄，並使用sudoroot 指令。如果您的 sudo 策略有意過濾與顯示相關的環境變量，請管理員提供一種範圍更窄的認可方法。避免使用範圍過廣的環境變數保護規則或指令，以免將本機顯示暴露給所有主機使用者。

相關診斷要點很簡單：如果 X 應用程式以您的普通帳戶打開，但 YaST 僅在提升權限後才會失敗，則重點檢查權限和授權交接。如果兩者都以普通帳戶開啟失敗，則傳回檢查 SSH 用戶端、本機 X 伺服器和伺服器轉送設定。

當不需要圖形時，選擇文字介面。

當特定工作流程確實需要圖形介面時，X11 轉送非常有用，但它會增加依賴項，並且在高延遲連接上可能會感覺速度很慢。 YaST 也為終端會話提供了一個 ncurses 文字介面。 SUSE 文件中介紹如何強制磁碟模組啟用它：

yast2 disk --ncurses

在無頭伺服器上，當客戶端沒有 X 伺服器或圖形會話不穩定時，這是一個實用的選擇。您也可以從命令列執行 YaST 模組（如果其支援的選項允許）。請使用 `yaST list` 命令查看模組列表yast -l，並查閱該模組的說明文檔，而不是假設每個圖形模組都具有等效的命令列操作。

症狀到行動指南

症狀	下一步行動
`DISPLAY`空白	使用以下命令重新連線`ssh -X`；驗證本機 X 伺服器是否正在運行，並允許伺服器端 X11 轉送。
測試 X 應用程式也失敗了	在啟動 YaST 之前，請先解決用戶端顯示、SSH 轉送和 X 授權問題。
測試應用運作正常，YaST 輸出 XIO 錯誤。	`QT_XCB_GL_INTEGRATION=none`請在受影響的 YaST 指令之前嘗試。
YaST 在海拔升高之前有效，但在海拔升高之後無效。	檢查已核准的 sudo 或 root 授權路徑，以取得顯示和 X 授權存取權限。
你只需要一個終端介面。	使用 ncurses 形式，例如`yast2 disk --ncurses`。
模組命令不可用	檢查已安裝的 YaST 模組和產品發佈文件；顯示修復程式無法新增缺少的模組。

安全性和版本說明

X11轉發不僅僅是視覺上的便利：遠端圖形程式可以與客戶端的顯示器進行通訊。請僅在您信任的系統上使用X11轉發。 OpenSSH使用`--trusted-forwarding-untrusted-forwarding- -Xwith- ...-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 系統和身分驗證；SUSE SLES 15 SP7 管理指南：YaST 文字和命令列選項。