SSH X11転送経由でYaST GUIが起動しない問題を解決する方法

YaST のグラフィカル ウィンドウが SSH 経由で失敗する場合、まず X11 転送が機能しているかどうかを確認してください。クライアント コンピュータから で接続しssh -X admin@server、別のリモート グラフィカル プログラムをテストします。そのプログラムが開くものの、YaST がXIO: fatal IO error 11などのディスプレイでエラーを報告する場合はlocalhost:11.0、SUSE のドキュメントに記載されている特定の回避策に従って、影響を受ける YaST コマンドのQT_XCB_GL_INTEGRATION=none前に を付けて実行してください。たとえば、 を使用しますQT_XCB_GL_INTEGRATION=none yast2 disk。この回避策は Qt/OpenGL 転送の失敗に適用され、ローカル X サーバーの欠落、 が設定されていないDISPLAY、サーバー転送がブロックされている、または YaST モジュールがインストールされていないといった問題は修復されません。

まずは最も簡単なチェックから始めましょう

YaSTのグラフィカルインターフェースを使用するには、クライアント側にXディスプレイと正常に動作するSSH X11トンネルが必要です。SSHクライアントは、DISPLAYフォワーディングが有効になっている場合、リモートホストにフォワーディング値を設定します。グラフィックがフォワーディングされていなくても、通常のSSHログインは機能するため、ターミナルセッションが成功しただけではX11が動作しているとは言えません。

1. クライアントコンピュータにアクティブなXサーバーまたはX11互換のディスプレイセッションが設定されていることを確認してください。Windowsの場合、SUSEのドキュメントでは、PuTTYでX11転送を有効にする方法が「接続」>「SSH」>「X11」で説明されています。ローカルのXサーバーも利用可能である必要があります。
2. 転送を有効にして再接続しますssh -X admin@server。実際のアカウントとホスト名を使用してください。
3. リモートシェルで を確認してください。転送されたディスプレイの場合、通常はや などecho "$DISPLAY"の値が表示されます。値が空白の場合は、セッションで X11 転送が確立されなかったことを意味します。localhost:10.0localhost:11.0
4. リモートシステムにインストールされている小型のXアプリケーションを起動してください。ローカルデスクトップで開かない場合は、YaSTのトラブルシューティングを行う前に、転送設定を修正してください。

例えば、Linuxワークステーションから接続している管理者は、コマンドを実行してssh -X ops@server.exampleから、利用可能なテストアプリケーションを実行するかもしれません。アプリケーションウィンドウがローカルに表示される場合は、SSHトンネルとローカルディスプレイが正常に動作しています。表示されない場合は、「ディスプレイを開けません」などのエラーが表示され、YaST固有のグラフィック回避策ではなく、X11パスに問題があることを示しています。

SUSEのYaST固有の回避策を適用する

XIO: fatal IO error 11 (Resource temporarily unavailable)SUSE の SLES 15 SP7 導入ガイドには、X フォワーディングを使用した SSH 経由の YaST GUI が、特定のコマンドで失敗するケースが記載されています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 の動作を変更する別の理由がない限り、グローバルシェルプロファイルに永続的に追加しないでください。

この修正は、X11自体は正常に動作しているにもかかわらず、YaSTが終了したり、特定のXIOエラーが表示されたりする場合に特に有効です。同じエラーが続く場合は、別のモジュールをテストし、クライアントとサーバーの転送設定を確認してください。その他のグラフィック障害にはさまざまな原因が考えられます。SUSEの回避策は、Qt、GPU、またはディスプレイに関するあらゆる問題に対する万能薬ではありません。

DISPLAYが空の場合、SSHサーバーを確認してください。

SUSEサーバーでは、SSHデーモンの設定でX11転送が許可されている必要があります。管理者は、/etc/ssh/sshd_config有効な設定に以下の項目が含まれていることを検査して確認できます。

X11Forwarding yes

サーバーポリシーは、付属の設定ファイルを通じて提供することも、一元的に管理することもできるため、1行編集するだけで十分だと考えないでください。承認された変更後は、設定を検証し、サービスを再起動してください。

sudo sshd -t
sudo systemctl reload sshd.service

設定を確認する際は、現在の SSH セッションを開いたままにしておき、セッションを閉じる前に 2 回目のログインをテストしてください。構文チェックは不正な設定を検出しますが、ポリシーが正しいことやクライアントからの転送が機能していることを確認するものではありません。SSH サーバーを管理していない場合は、システムファイルを自分で編集するのではなく、管理者に有効なポリシーを確認してもらうようにしてください。

サーバー側で変更を加えた後は再接続し、DISPLAYリモートアプリケーションのテストを繰り返してください。サーバーが認証の問題を報告した場合は、リモートユーザーが有効な X 認証エントリを持っているかどうかを確認してくださいxauth list。認証クッキーを手動でコピーしたり、ウィンドウを開くために表示アクセス制御を弱めたりすることは避けてください。

ディスプレイを失わずに管理者権限でYaSTを実行する

YaSTはシステム設定を変更するため、通常は管理者権限が必要です。よくある誤解として、権限のないユーザーでもテストウィンドウを表示できるのに、権限昇格後にYaSTが動作しなくなるというケースがあります。これは、昇格したプロセスが、DISPLAY接続に必要な転送データやX認証データを保持していないことが原因と考えられます。

組織で承認されている権限昇格方法を使用し、YaST プロセスが何を受け取るかを確認してください。GUI を取得するためだけに、root による直接 SSH ログインを有効にしないでください。SUSE のセキュリティ ガイダンスでは、権限のないユーザーとしてログインし、sudoroot コマンドには sudo を使用することを推奨しています。sudo ポリシーでディスプレイ関連の環境変数を意図的にフィルタリングしている場合は、管理者に、範囲を限定した承認済みの方法を提供してもらうよう依頼してください。ローカル ディスプレイをすべてのホスト ユーザーに公開するような、広範な環境保護ルールやコマンドは避けてください。

診断上の重要なポイントは単純です。通常のアカウントでXアプリケーションが起動し、管理者権限で起動した場合にのみYaSTが失敗する場合は、権限と認証の引き継ぎに注目してください。通常のアカウントで起動しても両方とも失敗する場合は、SSHクライアント、ローカルXサーバー、およびサーバー転送の設定を確認してください。

グラフィックが不要な場合は、テキストインターフェースを選択してください。

X11転送は、特定のワークフローでグラフィカルインターフェースがどうしても必要な場合に便利ですが、依存関係が増え、レイテンシの高い接続では動作が遅く感じられることがあります。YaSTは、ターミナルセッション用にncursesテキストインターフェースも提供しています。SUSEのドキュメントでは、ディスクモジュールでこれを強制的に使用する方法が説明されています。

yast2 disk --ncurses

これは、ヘッドレスサーバーの場合、クライアントにXサーバーがない場合、またはグラフィカルセッションが不安定な場合に実用的な選択肢です。サポートされているオプションで許可されている場合は、YaSTモジュールをコマンドラインから実行することもできます。モジュールリストは で確認しyast -l、すべてのグラフィカルモジュールに同等のコマンドライン操作があると想定するのではなく、各モジュールのヘルプを参照してください。

症状から対処法へガイド

セキュリティとバージョンに関する注記

X11 フォワーディングは単なる視覚的な利便性にとどまりません。リモートのグラフィカルプログラムはクライアントのディスプレイと通信します。信頼できるシステムでのみ使用してください。OpenSSH は、信頼できないフォワーディングを で、-X信頼できるフォワーディングを で区別します-Y。信頼できるフォワーディングでは、リモート X クライアントがローカル ディスプレイにアクセスできる範囲が広がります。まずは から始めてください-X。-Y特定のアプリケーションが必要とし、かつセキュリティ ポリシーで許可されている場合にのみ、信頼できるホストとして を検討してください。

上記の YaST エラーと回避策は、SUSE Linux Enterprise Server 15 SP7 導入ガイドで検証済みです。YaST モジュール、利用可能なグラフィカルバックエンド、および起動動作は、SLES、SLED、および openSUSE の各リリースによって異なる場合があります。リモートホストにインストールされている製品とバージョンについては、ドキュメントをご確認ください。最終更新日：2026 年 10 月 6 日。

参考資料: SUSE SLES 15 SP7 導入ガイド: YaST over SSH ; SUSE SLES 15 SP7 セキュリティおよび強化ガイド: OpenSSH ; SUSE SLES 15 SP7 ガイド: X Window System と認証; SUSE SLES 15 SP7 管理ガイド: YaST テキスト モードとコマンドライン オプション。