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配置文件

###ssh_config配置项修改 begin
PermitRootLogin yes
PasswordAuthentication yes
###ssh_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