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 专属步骤。走哪条路取决于装的时候 yunkan-updater 有没有就绪:docker ps 看到 yunkan + yunkan-updater 两个容器 = 走方式 A;只有 yunkan 一个 = 走方式 B 或 C。

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

用一键脚本部署且 updater 镜像拉取成功时默认可用。打开 Web Admin → 设置 → 系统升级,点升级即可。yunkan-updater sidecar 会自动 docker pull 新镜像并重建主容器,新版起不来还会自动回滚到上一版,全程不用登命令行。LXC 内 docker socket 正常,这条路完全可用。

方式 B:命令行升级

没装 updater,或想手动锁定版本时用。进 LXC 后到部署目录(默认 ~/skyview)执行:

pct enter 101
cd ~/skyview

# 升到当前 tag(默认 latest)的最新镜像并重建
docker compose -p yunkan -f compose.all-in-one.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.all-in-one.yml
docker compose -p yunkan -f compose.all-in-one.yml up -d --pull always --force-recreate

方式 C:重跑安装脚本

一键脚本是幂等的,重跑会重新拉镜像(含 updater)、重新生成 compose、重建容器。最适合当初没装 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. 常见问题