Proxmox VE LXC 部署(iGPU 透传)

1. 适用机型 & 推荐变体

2. 准备工作(在 PVE host 上)

1. 1

   确认 host 有 /dev/dri

   PVE shell 跑 ls -la /dev/dri/,应有 card0/card1 + renderD128;否则 PVE 内核没加载 i915,先 modprobe i915

2. 2

   下载 Debian 12 模板

   PVE Web UI → local → CT Templates → Templates 按钮 → 找 debian-12-standard 下载(或 pveam download local debian-12-standard_12.x_amd64.tar.zst)

3. 3

   查 render/video 组的 GID

   PVE shell 跑 getent group render 和 getent group video,记下 GID(默认 render=104, video=44),后面 pct set 要用

3. 建 LXC 容器

# 在 PVE host shell:建一个 vmid=101 的容器,4 核 4G 内存 40G 硬盘
pct create 101 local:vztmpl/debian-12-standard_12.12-1_amd64.tar.zst \
  --hostname yunkan \
  --cores 4 --memory 4096 --swap 1024 \
  --rootfs local-lvm:40 \
  --net0 name=eth0,bridge=vmbr0,ip=dhcp,firewall=0 \
  --unprivileged 0 \
  --features nesting=1,keyctl=1 \
  --onboot 1

pct start 101

4. 透传 iGPU 给 LXC

# 在 PVE host:透传 renderD128 和 card1 给 vmid=101
pct set 101 -dev0 /dev/dri/renderD128,gid=104   # render group
pct set 101 -dev1 /dev/dri/card1,gid=44         # video group

# 重启容器让 dev 透传生效
pct reboot 101

# 验证:进容器看 /dev/dri 是否存在
pct exec 101 -- ls -la /dev/dri/

5. LXC 内装 docker + 跑云瞰

# 进 LXC
pct enter 101

# 装 docker
curl -fsSL https://get.docker.com | sh

# 跑云瞰一键脚本(自动选 openvino 变体,因为检测到 /dev/dri)
curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash

脚本完成后给一个 LXC IP + 端口(例如 http://10.0.0.148:23406/)。从同网段任意机器浏览器访问进 Setup 向导。

6. 升级

升級在 LXC 內操作(pct enter 101 進容器),和普通 Linux 裸機完全一樣,沒有 LXC 專屬步驟。首選方式 A(網頁後台一鍵升級,免登命令列);想手動鎖定版本或偏好命令列時用方式 B / C。

方式 A:网页一键升级(推荐)

打開 Web Admin → 設定 → 系統升級,點升級即可。系統會自動拉取新映像檔並重建主容器(升級瞬間會臨時出現一個一次性執行容器,完成後自動消失),新版起不來還會自動回滾到上一版,全程不用登命令列。LXC 內 docker socket 正常,這條路完全可用。

方式 B:命令行升级

想手動控制升級時機、鎖定特定版本時用。進 LXC 後到部署目錄(預設 ~/skyview)執行:

pct enter 101
cd ~/skyview

# 升到当前 tag(默认 latest)的最新镜像并重建
docker compose -p yunkan -f compose.yml up -d --pull always

要锁定到指定版本,先改 compose 里的 image tag 再重建(注意保持变体不变,见下方警告):

cd ~/skyview
# 把 0.9.9 换成目标版本号
sed -i 's|image: .*/yunkan-.*|image: registry.cn-hangzhou.aliyuncs.com/yunkan/yunkan-openvino:0.9.9|' compose.yml
docker compose -p yunkan -f compose.yml up -d --pull always --force-recreate

方式 C:重跑安装脚本

一鍵腳本是冪等的,重跑會重新拉映像檔、重新產生 compose、重建容器。適合想把老裝機刷成最新標準佈局(順帶清理舊版 yunkan-updater 升級容器)的場景:

pct enter 101
curl -fsSL https://cdn.yun-kan.com/yunkan-install.sh | bash

7. 备份 / 恢复

• LXC 快照:升级前 pct snapshot 101 pre-upgrade-$(date +%Y%m%d),出问题 pct rollback 101 <快照名> 秒回滚整个容器
• LXC 备份:vzdump 101 --storage local 把整个容器(含 docker volume)走 PVE 标准备份;或 Web UI → 选 101 → Backup
• 恢复:pct restore <新 vmid> <备份文件> 从备份还原
• ⚠️ 不要 destroy + create 重建:LXC 重建会让 /etc/machine-id 变,license 指纹漂移 → 占新 slot 死循环。要重置一律走 pct restore 从备份恢复,不要新建容器

8. 常见问题