Pardus KVMゲストでディスプレイ解像度が1024x768に固定される問題を修正する

Pardus KVMゲストが1024x768で止まってしまう理由

Pardus仮想マシンが1024x768を超える解像度を提供しない場合、通常は単純なデスクトップ設定の問題ではありません。重要なのは、ゲストOSがKVM/QEMUからより大きな仮想ディスプレイモードを実際に受け取っているかどうか、そしてデスクトップセッションがサイズ変更イベントに反応できるかどうかです。

望ましい結果は単純明快です。ビューアウィンドウのサイズを変更したり、より大きなモードを選択したりした後、Pardusは最大解像度として1024x768を報告するのではなく、1366x768、1600x900、または1920x1080などの解像度を表示するべきです。クリップボードの統合とスムーズなポインタの動作は、SPICEが関係する場合に役立つ二次的な指標ですが、解像度が主要なテストです。

このガイドは、libvirtとSPICEまたはグラフィカルコンソールを備えたKVM/QEMU上で動作するPardusデスクトップゲストに最も直接的に適用されます。Pardus 25.0は2025年11月にリリースされ、公式Pardusダウンロードリポジトリには2026年3月リリースのPardus 25.1イメージも掲載されています。デスクトップメニューはXFCE版とGNOME版で異なる場合があるため、以下のチェックでは特定のデスクトップシェルに大きく依存しないコマンドと仮想化設定を使用します。最新のインストールイメージについては、公式Pardus 25ダウンロードリポジトリを参照してください。

1. ゲストOSの最大解像度が1024x768であることを確認してください。

Pardus内で開始します。ターミナルを開き、セッションの種類と仮想ディスプレイハードウェアを特定します。

echo "$XDG_SESSION_TYPE"
lspci -nnk | grep -A3 -E 'VGA|Display'

セッションがX11の場合は、以下も実行してください。

xrandr --current

2つの点に注意してください。まず、仮想GPUがQXL、Virtio GPU、汎用VGAアダプタ、またはその他のいずれであるかを確認してください。次に、モードリストを確認してください。1920x1080が既にリストされている場合、仮想化スタックはおそらくより大きな解像度に対応しており、問題はデスクトップの設定またはサイズ変更イベントの問題である可能性が高いです。xrandr最大解像度が1024x768と表示されている場合、デスクトップ解像度ダイアログを変更するだけでは解決しない可能性が高いです。

Waylandセッションでは、xrandrこれはコンポジタの正式な設定ツールではないため、補足情報としてのみ使用してください。セッションの種類が重要なのは、QXLはこれまでX.Org/SPICEワークフローと関連付けられてきたのに対し、Virtio GPUはQEMUにおけるより現代的な準仮想化グラフィックスデバイスであるためです。

2. KVMホスト上でVMのビデオおよびディスプレイデバイスを確認します。

仮想ビデオハードウェアを変更する前に、ゲストOSを完全にシャットダウンしてください。仮想マシンマネージャで、VMハードウェアの詳細を開き、ディスプレイデバイスとビデオデバイスの両方を確認します。一般的なSPICE構成では、SPICEディスプレイとQXLまたはVirtioビデオを組み合わせて使用​​します。

qxlLibvirt は、や など、サポートされているいくつかのビデオ モデル タイプを文書化していますvirtio。QEMU は、Virtio GPU を Linux ゲスト用の準仮想化 GPU/ディスプレイ コントローラとして説明し、特定の物理ハードウェアをエミュレートする必要がない場合には一般的に VirtIO デバイスを推奨しています。libvirtビデオ デバイスのドキュメントとQEMU VirtIO GPU のドキュメントを参照してください。

VMが既にQXLとSPICEを使用している場合は、一度にすべてを変更しないでください。その構成はそのままにして、まずSPICEゲストエージェントをインストールしてください。これにより、クリーンなテストが可能になります。動的解像度が正常に動作し始めたら、仮想GPUを変更する必要はありません。

VMが古い汎用VGAまたはCirrusモデルを使用している場合、最新のLinuxデスクトップ環境ではQXLまたはVirtioへの移行が通常より適切です。Virtioを選択する場合は、3Dアクセラレーションを強制せずに開始してください。QEMUのドキュメントには、Virtio GPUアクセラレーションモードにはホスト、カーネル、Mesa、およびレンダラーに関する追加の要件があると記載されています。したがって、基本的な2D Virtio GPU設定が、トラブルシューティングのベースラインとしてより安全です。

3. PardusにSPICEゲストエージェントをインストールする

VMがSPICEディスプレイを使用している場合、最も有用でリスクの低い解決策は、spice-vdagentゲストOSに以下のものがインストールされていることを確認することです。

sudo apt update
sudo apt install spice-vdagent

その後、ログアウトして再度ログインするか、ゲストを再起動してください。Debian パッケージの説明には、spice-vdagentX セッションの解像度をクライアントの解像度に自動的に調整することが機能の 1 つとして具体的に記載されています。Pardus は Debian ベースなので、このパッケージは現在の Pardus リリースで使用されている Debian 由来のパッケージ エコシステムで利用できます。Debian stable には現在spice-vdagent0.22.1-4.1 が含まれています。Debian spice-vdagent パッケージのページを参照してください。

インストール後、デーモンとユーザー側のプロセスを確認してください。

systemctl status spice-vdagentd.service --no-pager
pgrep -a spice-vdagent

システムデーモンが稼働していることは便利ですが、ユーザーセッションの要素も重要です。Debianのパッケージドキュメントには、自動解決処理はエージェントプロセスを実行しているアクティブなグラフィカルセッションに依存すると記載されています。

VMがX.OrgでQXLを使用しており、グラフィックドライバが見つからない場合は、QXL X.Orgドライバパッケージがインストールされているかどうかを確認してください。

dpkg -l xserver-xorg-video-qxl
sudo apt install xserver-xorg-video-qxl

これは、ゲストOSが実際にQXLを使用する場合にのみ実行してください。このパッケージは、SPICE互換のKVM/QEMU環境におけるQXLデバイス専用に存在しており、VMがKVM上で動作しているという理由だけで必要となるものではありません。Debian stableには現在、バージョンxserver-xorg-video-qxl0.1.6～1.1がパッケージ化されており、Debian QXLドライバのページで詳細が説明されています。

4. 仮想GPUを変更する前に、動的サイズ変更を再テストする

再度ログイン後、グラフィカルコンソールを開き、ウィンドウのサイズを変更します。ビューアにウィンドウサイズ調整または自動サイズ変更オプションがある場合は、レンダリングされた画像を引き伸ばすのではなく、ゲストのサイズを変更するオプションを有効にしてください。

X11の場合は、xrandr --current再度実行してください。正常に実行された場合は、より大きな最大値と追加のモードが表示されるか、ビューアウィンドウのサイズが変更されると現在のモードが自動的に切り替わります。また、Pardusのディスプレイ設定を開いて、より大きなネイティブ解像度が選択可能になっていることを確認することもできます。

コンソールウィンドウが大きく見えるかどうかだけで成功を判断しないでください。ビューアは1024x768のフレームバッファを拡大縮小して大きなウィンドウに表示できるため、ゲストの解像度を上げなくても画像が大きくなります。信頼できる指標は、ゲストが報告するモードと、実際に利用可能なデスクトップワークスペースの量です。

QXLが1024x768で止まる場合は、Virtioビデオに切り替えてください。

SPICEエージェントがインストールされアクティブになっているにもかかわらず、ゲストOSが1024x768しか表示しない場合は、レイヤーを1つずつ変更してください。VMの電源をオフにし、ビデオハードウェア設定を開いて、ビデオモデルをQXLまたは従来のVGAからVirtioに切り替えます。リモートディスプレイプロトコルも変更する必要がある特別な理由がない限り、SPICEディスプレイはそのままにしておいてください。

Pardusを起動し、ハードウェアとモードのチェックを繰り返してください。

lspci -nnk | grep -A3 -E 'VGA|Display'
lsmod | grep virtio_gpu

X11 セッションでは、 も実行してくださいxrandr --current。 QEMU によると、Virtio GPU は の Linux ゲスト カーネルのサポートを必要としますCONFIG_DRM_VIRTIO_GPU。主流のディストリビューション カーネルは通常これを提供しますが、カスタム カーネルでは提供されない場合があります。変更後にゲストが黒い画面で起動する場合は、ゲストを盲目的に変更し続けるのではなく、ホストから電源を切り、ビデオ モデルを元に戻してください。

xrandrが役立つ場合と、それが間違った解決策となる場合

xrandr既に希望する解像度が表示されている場合は、それを選択することが診断に役立つ手順となる場合があります。

xrandr --output Virtual-1 --mode 1920x1080

Virtual-1を、で表示される実際の出力名に置き換えてくださいxrandr。このコマンドは、X11 にのみ適用され、出力にそのモードが既に利用可能な場合にのみ適用されます。

目的のモードが存在せず、最大フレームバッファサイズが依然として1024x768である場合、モデルラインを手動で挿入することは、通常、原因ではなく症状に対処することになります。KVMゲストでは、仮想GPUとディスプレイの統合により、使用可能なモードが通知されるはずです。まず、そのパスを修正してください。X11の動的ディスプレイ構成については、 X.Org RandRのドキュメントが主要な参考資料となります。

修復が完了したかどうかを判断する方法

トラブルシューティングに役立つコマンド

結果が依然として矛盾している場合は、別の変更を加える前に以下のコマンドを収集してください。

echo "$XDG_SESSION_TYPE"
lspci -nnk | grep -A3 -E 'VGA|Display'
systemctl status spice-vdagentd.service --no-pager
pgrep -a spice-vdagent
journalctl -b -u spice-vdagentd.service --no-pager

X11では、以下を追加します。

xrandr --current

これらのチェックにより、4つの異なる障害クラスが区別されます。ホストが誤った仮想ビデオデバイスを公開している、Pardusに適切なゲスト統合機能が欠けている、エージェントはインストールされているがグラフィカルセッションで実行されていない、またはデスクトップセッションが想定されるサイズ変更メカニズムに応答しないディスプレイスタックを使用している、のいずれかです。

この修正の限界

すべてのKVM環境において最適なQXLまたはVirtioの選択肢は存在しません。ホスト側のQEMU/libvirtのバージョン、コンソールクライアント、デスクトップセッション、カーネル、そして3Dアクセラレーションが有効になっているかどうかなど、様々な要因が結果に影響します。上記の手順は、意図的に影響の少ない変更から始め、ゲストOSが報告する解像度を成功の基準としています。

VMへのアクセスが、通常のVNC、GPUパススルー、ゲストへのRDP接続、クラウドコンソールなど、別の表示経路で行われる場合、SPICE固有の手順は適用されない可能性があります。同様に、関連するDRMドライバを含まないカスタムカーネルでは、デスクトップパッケージではなくカーネル構成が必要になる場合があります。

実質的な停止ポイントは、Pardusが目的の高次モードを公開し、ビューアが1024x768のフレームバッファを単に拡大縮小するのではなくサイズ変更できるようになり、その結果が再起動後も維持されるようになった時です。これらの条件が満たされれば、追加のモデルライン、X.Org構成ファイル、または3Dアクセラレーションの変更は不要になります。