Proxmox VE の Windows 11 VM で
内蔵 GPU (Radeon) を使う手順書

0はじめに・全体像

作業の流れ (どこで何をするか)

あなたの環境の値を入力 (入力するとコマンドに反映されます)

0準備するもの

• Proxmox VE 9.x が動いているミニ PC (UEFI 起動・GRUB 起動)。内蔵 GPU は AMD。
  BIOS で IOMMU (AMD-Vi) と SVM が有効になっていること (多くの機種は初期状態で有効)
• Windows 11 の VM (作成済み)。UEFI (OVMF)・q35・CPU=host・仮想ディスプレイ QXL・QEMU ゲストエージェント
• あなたの PC (Windows 10/11): PowerShell が使える (ssh / scp は標準で入っています)
• PC に virt-viewer (SPICE ビューア) と 7-Zip
• AMD Software: Adrenalin Edition のインストーラ (オフライン版・約 1 GB)。AMD のサポートページであなたの APU (例: Ryzen 5 7640HS) を選んで Windows 11 用をダウンロード
• VM に入れる Blender (blender.org・インストーラ版)
• スクリプトの ZIP 3 つ (pve.zip・vm.zip・pc.zip)。次の「ダウンロード」から入手します
• (任意) NanoKVM などの KVM: ホストの画面が消えるので、BIOS 画面の確認や緊急時に便利。無くても進められます
• (任意) Moonlight 配信を使うなら: Moonlight (GPU のある実機 PC に入れる。GPU の無い仮想マシンの PC では映像が正しく表示されないことがあります)

⬇ダウンロード — スクリプトの ZIP (3 つ)

この手順で使うスクリプトは、置き場所ごとに 3 つの ZIP にまとめてあります。3 つともダウンロードしてください (pc.zip は STEP 9 の Moonlight 配信を使う人だけで構いません)。

PC ダウンロードしたら展開する

ZIP を「ダウンロード」フォルダに保存した場合は、次の PowerShell をそのまま貼り付けると、C:\gpu-guide に pve・vm・pc の 3 つのフォルダができます。

mkdir C:\gpu-guide
cd C:\gpu-guide
Expand-Archive $env:USERPROFILE\Downloads\pve.zip -DestinationPath .
Expand-Archive $env:USERPROFILE\Downloads\vm.zip -DestinationPath .
Expand-Archive $env:USERPROFILE\Downloads\pc.zip -DestinationPath .
Get-ChildItem . -Recurse -File | Unblock-File
dir

Mode   Name
----   ----
d----- pc
d----- pve
d----- vm

1PVE 現状確認 — GPU の場所と IOMMU

まず PC の PowerShell から Proxmox ホストに SSH で入り、内蔵 GPU がどこにあるかを調べます。

ssh root@PVE_IP

pveversion
lspci -nn | grep -i -E "vga|display|audio"

こんな行が出ます (環境により数字は違います):

65:00.0 VGA compatible controller [0300]: ... [AMD/ATI] Phoenix1 [1002:15bf] (rev c3)
65:00.1 Audio device [0403]: ... [AMD/ATI] Radeon High Definition Audio Controller [1002:1640]
65:00.6 Audio device [0403]: ... Family 17h/19h/1ah HD Audio Controller [1022:15e3]

IOMMU グループの確認

ls /sys/kernel/iommu_groups | wc -l
for d in /sys/kernel/iommu_groups/*/devices/*; do g=${d#*/iommu_groups/}; g=${g%%/*}; echo "group $g: $(lspci -nns ${d##*/})"; done | sort -V | grep "65:00"

30                                  # ← 0 でなければ IOMMU は有効
group 18: 65:00.0 VGA compatible controller ... [1002:15bf]
group 19: 65:00.1 Audio device ... [1002:1640]
group 20: 65:00.2 Encryption controller ... PSP
group 21: 65:00.3 USB controller ...
group 22: 65:00.4 USB controller ...
group 23: 65:00.6 Audio device ... HD Audio Controller

2PCPVE バックアップ — 失敗しても戻せるように

設定を変える前に、ファイルのコピーと VM のスナップショットを取ります。まず pve.zip を展開してできた pve フォルダを PVE にコピーします。

cd C:\gpu-guide
scp -r pve root@PVE_IP:/root/gpu-guide

cd /root/gpu-guide
chmod +x *.sh
./00-backup-host.sh VMID

backup folder : /root/gpu-passthrough-backup-20261011-130622
VM snapshot   : before-gpu-passthrough   (restore: qm stop VMID; qm rollback VMID before-gpu-passthrough)

3VM と PC の下準備 — GPU を渡す「前」に済ませる

GPU を渡したあとは VM の画面が不安定になることがあります。先に、VM をあとから操作できる準備 (SSH・SPICE の正しい設定) をしておきます。

PVE 3-1　VM の設定を確認する

qm config VMID

qm set VMID --vga qxl --tablet 1 --agent enabled=1

VM 3-2　OpenSSH サーバーを有効にする (ファイルを送るため)

PVE の Web UI で VM を選び「コンソール」を開いて (SPICE が使えます)、Windows で 管理者として PowerShell を開き、次を貼り付けます。最初の 1 回だけ手入力が必要です。

Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
Set-Service sshd -StartupType Automatic
Start-Service sshd
if (-not (Get-NetFirewallRule -Name OpenSSH-Server-In-TCP -ErrorAction SilentlyContinue)) { New-NetFirewallRule -Name OpenSSH-Server-In-TCP -DisplayName 'OpenSSH Server (sshd)' -Enabled True -Direction Inbound -Protocol TCP -Action Allow -LocalPort 22 }
New-Item -ItemType Directory C:\gpu-setup -Force | Out-Null
ipconfig    # ← IPv4 アドレスが VM_IP です

PC 3-3　VM 用ファイルを送る

vm.zip を展開してできた vm フォルダを、VM に送ります。

cd C:\gpu-guide
scp -r vm WINUSER@VM_IP:C:/gpu-setup/

PCVM 3-4　パスワード無しで入れるように SSH 鍵を作る

ssh-keygen -t ed25519
type $env:USERPROFILE\.ssh\id_ed25519.pub

cd C:\gpu-setup\vm
Set-ExecutionPolicy -Scope Process Bypass -Force
.\enable-openssh.ps1 -PublicKey "ssh-ed25519 AAAA... あなたの公開鍵"

ssh WINUSER@VM_IP hostname

VM 3-5　SPICE エージェントを新しくする (マウスが動かなくなる問題の予防)

古い SPICE エージェントは、パススルーした GPU があるとマウスが動かなくなります。修正済みのエージェントに入れ替えます。

cd C:\gpu-setup\vm
.\install-spice-agent.ps1

4PVE ホストの設定 — GPU を vfio に確保して再起動

ホストが GPU を使わないようにして、代わりに VM へ渡せる状態 (vfio-pci) にします。あわせて GPU の「ビデオ BIOS (vBIOS)」を取り出します。

cd /root/gpu-guide
./01-setup-vfio.sh GPU_ADDR --dry-run

書き込む内容と、vBIOS が取り出せること (55AA=True) が表示されます。問題なければ本番です。

./01-setup-vfio.sh GPU_ADDR

VFCT table: 17028 bytes
  image: PCI 65:00.0  id 1002:15bf  size 16896  55AA=True
  -> saved /usr/share/kvm/vbios_1002_15bf.rom  sha256=...
Finished. NEXT: reboot the host ('reboot') ...
vBIOS file name to use later: vbios_1002_15bf.rom

PVE ホストを再起動して確認

qm shutdown VMID
reboot

lspci -nnk -s GPU_ADDR
lspci -nnk -s 65:00.1

5PVE VM に GPU を追加する

cd /root/gpu-guide
./02-add-gpu-to-vm.sh VMID GPU_ADDR --dry-run
./02-add-gpu-to-vm.sh VMID GPU_ADDR
qm start VMID

hostpci0: 0000:65:00.0,pcie=1,romfile=vbios_1002_15bf.rom
hostpci1: 0000:65:00.1,pcie=1

VM が起動したら、Windows の「デバイス マネージャー」の「ディスプレイ アダプター」を開きます。この時点では次のようになっているのが正常です。

6PCVM AMD ドライバを入れる

PC 6-1　ドライバを取り出す

cd $env:USERPROFILE\Downloads
& "C:\Program Files\7-Zip\7z.exe" x -oC:\amd-extract .\whql-amd-software-adrenalin-*.exe "Packages\Drivers\Display"
dir C:\amd-extract\Packages\Drivers\Display

フォルダ (例: WT6A_INF) が出てくれば成功です。名前はバージョンによって違うことがあります。

PC 6-2　VM に送る

scp -r C:\amd-extract\Packages\Drivers\Display\WT6A_INF WINUSER@VM_IP:C:/gpu-setup/amddrv

VM 6-3　インストール

cd C:\gpu-setup\vm
Set-ExecutionPolicy -Scope Process Bypass -Force
.\install-amd-driver.ps1 -DriverDir C:\gpu-setup\amddrv

7VM 対策スクリプト・表示切替・ショートカット

ここが、このやり方の要です。次の 3 つを 1 回のコマンドで入れます。

cd C:\gpu-setup\vm
Set-ExecutionPolicy -Scope Process Bypass -Force
.\install-all.ps1

[1/5] scripts copied to C:\ProgramData\gpu-reset-fix
[2/5] GPU reset-bug workaround installed (shutdown script + startup task)
[3/5] tasks GpuMode-spice / GpuMode-stream created for user ...
[4/5] task GpuMode-spice-onlogon created (returns to the SPICE layout 25 s after every logon)
[5/5] desktop shortcut 'Blender (GPU fast)' created

入れたものを確認する (再起動テスト)

1. VM を Windows の「スタート → 電源 → シャットダウン」で止めます (PVE の Shutdown でも同じ)。

2. PVE のシェルコピー

   qm status VMID        # stopped になってから
   qm start VMID

3. 起動して 1 分ほどしたら、VM でログを見ます。

   VM の PowerShellコピー

   Get-Content C:\ProgramData\gpu-reset-fix\log.txt -Tail 8
   Get-PnpDevice -Class Display | Format-Table FriendlyName, Status -AutoSize

   正しい出力の例

   […] shutdown: disabling GPU
   […] disabled PCI\VEN_1002&DEV_15BF&SUBSYS_…
   […] startup: checking GPU
   […] status=Error problemcode=22
   […] status=OK problemcode=0
   […] final status=OK

8PCVM 動作確認 — Blender が速いか見てみる

PC の virt-viewer (SPICE) で VM に接続し (PVE の Web UI → VM → コンソール → SPICE)、デスクトップの 「Blender (GPU fast)」 をダブルクリックします。

チェックリスト

• デバイス マネージャーの「ディスプレイ アダプター」に AMD Radeon … が出て、⚠ が付いていない
• 「Blender (GPU fast)」で Blender が起動し、SPICE の画面が元に戻った
• SPICE でマウスが動く (起動直後も、しばらくしてからも)
• Blender の 3D ビューを回転させても滑らか (数秒待たされない)
• タスク マネージャー → パフォーマンス → 「GPU」に AMD Radeon があり、3D ビューを動かすと使用率が上がる
• Windows の「再起動」を 2 回続けても、GPU が OK のまま (log.txt で確認)
• PVE の qm shutdown VMID → qm start VMID のあとも GPU が OK

9(任意) Moonlight で映像配信 — もっと軽快に

SPICE で十分なら、この STEP は飛ばしてかまいません。ゲームのベンチマークや、もっと大きな 3D 作業をするとき向けです。VM の GPU が映像をハードウェアで圧縮して PC に送るため、画面更新は約 3 ms と最速になります。

VM 9-1　Sunshine (配信する側) を入れる

cd C:\gpu-setup\vm
Set-ExecutionPolicy -Scope Process Bypass -Force
.\install-sunshine.ps1 -WebUser admin

PC 9-2　Moonlight (見る側) を入れてペアリングする

1. Moonlight のリリースページから MoonlightPortable-x64-….zip をダウンロードし、%LOCALAPPDATA%\Programs\Moonlight に展開します (インストーラ版でも可。その場合は 9-3 のスクリプトに -Moonlight で場所を教えます)。

2. Moonlight を起動し、右上の「＋」から VM_IP を追加します。4 桁の PIN が表示されます。

3. PC のブラウザで https://VM_IP:47990 を開きます (証明書の警告は「詳細設定 → 進む」)。9-1 で決めたユーザー名とパスワードでログインし、PIN タブに表示された PIN を入力して送信します。

4. Moonlight の一覧に VM が出て、「Desktop」が選べるようになれば完了です。

PC 9-3　接続用のスクリプトを用意する (おすすめ)

Moonlight だけで接続しても映りますが、ハードウェアエンコードを使うには、接続の前に VM をストリームモードにしておく必要があります (Sunshine は接続の直後に使えるエンコーダを探すため)。次のスクリプトが、切替 → Moonlight 起動 → 終了後に SPICE へ戻す、までやります。

1. Start-Blender-Stream.ps1 をメモ帳で開き、先頭の VM_IP_ADDRESS と WINDOWS_USER を、あなたの VM の IP アドレスと Windows のユーザー名に書き換えて保存します。

2. Start-Blender-Stream.cmd をダブルクリックします。

3. Moonlight の画面が出たら、VM の Blender (または他のアプリ) を通常どおり操作できます。

4. 終わるときは Ctrl+Alt+Shift+Q でセッションを終了します。VM は自動で SPICE モードに戻ります。

ssh WINUSER@VM_IP schtasks /run /tn GpuMode-spice

★毎日の使い方・守ること

?困ったとき

くわしい原因と対処は 参考情報 (トラブルシューティング) にあります。

↩元に戻す

一番簡単なのは STEP 2 のスナップショットに戻す方法です。部分的に戻したいときは下の 3 つを使い分けます。

qm shutdown VMID
qm set VMID --delete hostpci0,hostpci1
qm start VMID

rm /etc/modprobe.d/vfio.conf
sed -i '/^vfio/d' /etc/modules /etc/initramfs-tools/modules
cp /root/gpu-passthrough-backup-*/grub /etc/default/grub
update-grub; update-initramfs -u -k all
reboot

cd C:\gpu-setup\vm
.\uninstall-all.ps1

qm stop VMID
qm rollback VMID before-gpu-passthrough
qm start VMID

□ファイル一覧とコピー先

3 つの ZIP の中身と、コピー先の一覧です。ZIP は ダウンロードの項目にもあります。