PVE8 安装 LXC 并启用硬解（Jellyfin 篇）

记录在 PVE8 虚拟化平台下安装 LXC 容器以实现 Jellyfin 的核显硬解，原则上适用于所有 12-13 代英特尔核显。

先决条件

具备实验环境
Proxmox VE 8.0

1 2	proxmox-ve: 8.0.2 (running kernel: 6.2.16-14-pve) qemu-server: 8.0.7

PVE 主机正常驱动核显，我使用的 CPU 为 12900 ES（QXQ3），核显为 UHD770。

1
2
3

╭─root@pve ~
╰─# ls /dev/dri
by-path  card0  renderD128

开启 GUC 支持（PVE 主机）

编辑文件 /etc/modprobe.d/i915.conf

1	nano /etc/modprobe.d/i915.conf

添加以下内容

1	options i915 enable_guc=3

重启 PVE 主机后生效，此时终端输入 dmesg | grep i915查看到 guc 启用情况为 enable，且可以看到 dmc firmware和 huc firmware两个固件的信息。

下载并创建 LXC 容器

下载 CT 模板

在 PVE 的 web 界面，找到 local-CT模板-模板，弹窗中搜索 debian，选中 debian12 的模板下载。

新建 LXC 容器

下载完成后，右键节点，使用 debian12 的模板新建 LXC 容器，注意去除勾选 无特权容器

配置 LXC 容器

基础配置

创建完成后，先不启动，在 LXC 容器的配置文件中映射主机的核显设备
编辑配置文件 /etc/pve/lxc/218.conf

1	nano /etc/pve/lxc/218.conf

最下方添加以下内容

lxc.cgroup2.devices.allow: c 226:0 rwm
lxc.cgroup2.devices.allow: c 226:128 rwm
lxc.mount.entry: /dev/dri/card0 dev/dri/card0 none bind,optional,create=file
lxc.mount.entry: /dev/dri/renderD128 dev/dri/renderD128 none bind,optional,create=file
lxc.apparmor.profile: unconfined
lxc.cap.drop:

完成后启动 LXC 容器，在 PVE 控制台中登录，开启 ssh 远程登录权限。

nano /etc/ssh/sshd_config #编辑sshd配置文件

###sshd_config配置项修改 begin
PermitRootLogin yes
PasswordAuthentication yes
###sshd_config配置项修改 end

service ssh restart #重启sshd服务

对 LXC 容器进行换源、更新操作。

nano /etc/apt/sources.list #编辑源文件

###sources.list 源文件修改 begin
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-updates main contrib non-free non-free-firmware
deb https://mirrors.tuna.tsinghua.edu.cn/debian/ bookworm-backports main contrib non-free non-free-firmware
deb https://security.debian.org/debian-security bookworm-security main contrib non-free non-free-firmware
###sources.list 源文件修改 end

apt update && apt upgrade -y #更新

安装 intel_gpu_top，在命令行查看核显占用。

1	apt install intel-gpu-tools

终端输入 intel_gpu_top看到如下信息，Ctrl+C 取消。

挂载 NFS

影音文件保存在 NAS 中，NAS 开启 NFS 分享，在 LXC 容器中挂载以供 Jellyfin 服务使用。

apt install nfs-common -y #安装nfs-common
apt install nfs-utils -y #高版本Ubuntu中，可安装nfs-utils
mount -t nfs 192.168.31.220:/mnt/disk2 /mnt/share_nfs #挂载NFS

nano /etc/fstab #编辑配置文件

#配置文件fstab begin
192.168.31.220:/mnt/disk2 /mnt/share_nfs nfs defaults 0 0
#配置文件fstab end

挂载完成后查看文件是否存在，挂载得到的文件权限可以在 NFS 服务端做出配置。如无问题，则修改 /etc/fstab文件开机自动挂载 NFS 目录。

安装 docker 版 Jellyfin

apt install curl -y && curl -sSL https://get.docker.com/ | sh #安装docker

#安装Jellyfin
docker run -d -p 8096:8096 -p 8920:8920 --volume jellyfin-config:/config --volume jellyfin-cache:/cache -v /mnt/share_nfs:/media --device=/dev/dri:/dev/dri --restart=always --name jellyfin nyanmisaka/jellyfin:latest

配置 docker 在 NFS 挂载后启动

默认情况下 docker 和 NFS 挂载动作的执行是不区分先后顺序的，这会导致开机以后 docker 服务已经启动但 NFS 挂载点未就绪，于是在 docker 应用中就无法正常的看到存储池中的文件。
终端执行 systemctl list-units | grep mount寻找与 fstab 中配置对应的信息，我的挂载任务为：mnt-share_nfs.mount