家里的两个小朋友天天放学回家就捧着 iPad 看动画片，屏幕又小又伤眼睛，还是我这个老爹给他们弄个家庭影院投屏吧，顺便下载一些西方的动画大片给他们看下，总比天天看国产的神动漫好。

之前买的 N5105，目前已经通过 PVE 虚拟化方式在上面运行了 ikuai（宽带拨号），openwrt（作为旁路由），和 VM 形式安装的 debian（上面 docker 方式运行了 vaultwarden 和 syncthing），这次再通过 lxc 方式运行 debian 12 顺便把显卡直通给 debian12 实现 jellyfin 的硬解。

操作流程#

核显直通PVE#

确保PVE已经升级到7.3-3及以上版本

补全 i915 guc huc dmc固件

1
mkdir -p /lib/firmware/i915 && cd /lib/firmware/i915
2
curl -LO https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/i915/ehl_guc_70.1.1.bin
3
curl -LO https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/i915/ehl_huc_9.0.0.bin
4
curl -LO https://git.kernel.org/pub/scm/linux/kernel/git/firmware/linux-firmware.git/plain/i915/icl_dmc_ver1_09.bin

安装 lxc debian 前准备#

更新一下 pve 的软件源

1
apt update
2
apt upgrade -y

https://mirrors.tuna.tsinghua.edu.cn/proxmox/images/system/

从上面的清华源中找到 debian 12 模板，这里我下载的 debian-12-standard_12.2-1_amd64.tar.zst

1
# 进入 pve 默认 template 目录
2
cd /var/lib/vz/template/cache/
3
# 下载模板
4
curl -O https://mirrors.tuna.tsinghua.edu.cn/proxmox/images/system/debian-12-standard_12.2-1_amd64.tar.zst
5
# 列出可用 CT 模板
6
pveam list
7
# 更新 CT 模板
8
pveam update

也可以通过以下命令，从官方下载模板

1
# 查看可选模板
2
pveam available
3
pveam download local <template_you_want_to_use>

图形化界面创建 CT#

选择 Create CT

Unprivileged container 不做勾选，设置 CT ID，hostname 以及登录密码

选择刚才下载的模板

设置硬盘大小

设置 CPU 核心数（后期可以修改）

设置内存大小（后期可以修改）

设置网络，IPv4 分配根据实际情况选择，这里我选择 DHCP 结合 ikuai 自动分配

DNS用宿主机的就好

完成后确认

设置显卡#

重要的事情说三遍，在 pve 宿主机上操作！

1
# 查看显卡信息
2
ls -l /dev/dri
3
# crw-rw---- 1 root video  226,   0 Apr 16 23:06 card0 这个就是显卡
4
drwxr-xr-x 2 root root         80 Apr 16 23:06 by-path
5
crw-rw---- 1 root video  226,   0 Apr 16 23:06 card0
6
crw-rw---- 1 root render 226, 128 Apr 16 23:06 renderD128
7

8
# 106 对应上面创建的 CT id
9
vim /etc/pve/lxc/106.conf
10

11
# 黏贴以下内容

修改 ct 106 的配置, 黏贴以下内容

lxc.cgroup2.devices.allow: c 226<0> rwm lxc.cgroup2.devices.allow: c 226<128> rwm lxc.cgroup2.devices.allow: c 29<0> rwm lxc.mount.entry: /dev/dri dev/dri none bind,optional,create=dir lxc.apparmor.profile: unconfined lxc.cap.drop:

1
vim /etc/pve/lxc/106.conf

编辑完成后具体信息如下

1
cat /etc/pve/lxc/106.conf
2

3
arch: amd64
4
cores: 2
5
cpulimit: 2
6
cpuunits: 1024
7
hostname: lxc-debian
8
memory: 4096
9
net0: name=eth0,bridge=vmbr0,firewall=1,hwaddr=3A:13:C3:D0:DE:E1,ip=dhcp,ip6=dhcp,type=veth
10
ostype: debian
11
rootfs: local-lvm:vm-106-disk-0,size=40G
12
swap: 4096
13

14
lxc.cgroup2.devices.allow: c 226:0 rwm
15
lxc.cgroup2.devices.allow: c 226:128 rwm
16
lxc.cgroup2.devices.allow: c 29:0 rwm
17
lxc.mount.entry: /dev/dri dev/dri none bind,optional,create=dir
18
lxc.apparmor.profile: unconfined
19
lxc.cap.drop:

修改以下配置

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

增加内容

options i915 enable_guc=3

编辑完成后具体信息如下

1
cat /etc/modprobe.d/i915.conf
2

3
options i915 enable_guc=3

重启

1
reboot

重启后检查是否生效

1
journalctl -b -o short-monotonic -k | egrep -i "i915|dmr|dmc|guc|huc"

返回信息中有以下 HuC 和 GuC 则说明开启成功

1
[    4.784428] pve kernel: Setting dangerous option enable_guc - tainting kernel
2
[    4.785480] pve kernel: i915 0000:00:02.0: [drm] VT-d active for gfx access
3
[    4.785857] pve kernel: i915 0000:00:02.0: vgaarb: deactivate vga console
4
[    4.785952] pve kernel: i915 0000:00:02.0: [drm] Using Transparent Hugepages
5
[    4.790414] pve kernel: i915 0000:00:02.0: vgaarb: changed VGA decodes: olddecodes=io+mem,decodes=io+mem:owns=io+mem
6
[    4.799606] pve kernel: i915 0000:00:02.0: [drm] Finished loading DMC firmware i915/icl_dmc_ver1_09.bin (v1.9)
7
[    4.955965] pve kernel: i915 0000:00:02.0: [drm] GuC firmware i915/ehl_guc_70.1.1.bin version 70.1.1
8
[    4.955997] pve kernel: i915 0000:00:02.0: [drm] HuC firmware i915/ehl_huc_9.0.0.bin version 9.0.0
9
[    4.970965] pve kernel: i915 0000:00:02.0: [drm] HuC authenticated
10
[    4.971309] pve kernel: i915 0000:00:02.0: [drm] GuC submission enabled
11
[    4.971311] pve kernel: i915 0000:00:02.0: [drm] GuC SLPC disabled
12
[    4.973395] pve kernel: [drm] Initialized i915 1.6.0 20201103 for 0000:00:02.0 on minor 0
13
[    4.976297] pve kernel: snd_hda_intel 0000:00:1f.3: bound 0000:00:02.0 (ops i915_audio_component_bind_ops [i915])

lxc debian 内操作#

更换清华源

debian | 镜像站使用帮助 | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror

增加 sudo 账号

默认 root 用户操作有点危险，我比较喜欢添加个人用户并赋予 sudo 权限

1
# 安装 sudo
2
apt install sudo
3
# 添加个人账号
4
adduser <username>
5
# 将个人账号添加到 sudo 组
6
usermod -aG sudo <username>

LXC 开机自动修改解码器用户组权限

1
# 创建开机脚本
2
sudo cat > /etc/rc.local << EOF
3
!/bin/sh -e
4
#
5
#rc.local
6
#
7
#This script is executed at the end of each multiuser runlevel.
8
#Make sure that the script will "exit 0" on success or any other
9
#value on error.
10
#
11
#In order to enable or disable this script just change the execution
12
#bits.
13
#
14
#By default this script does nothing.
15
chmod 777 /dev/dri/*
16
sleep 30
17
systemctl restart docker
18
exit 0
19
EOF
20

21

22
# 配置开机自动运行
23
sudo cat > /etc/systemd/system/rc-local.service << EOF
24
[Unit]
25
Description=/etc/rc.local
26
ConditionPathExists=/etc/rc.local
27
[Service]
28
Type=forking
29
ExecStart=/etc/rc.local start
30
TimeoutSec=0
31
StandardOutput=tty
32
RemainAfterExit=yes
33
SysVStartPriority=99
34
[Install]
35
WantedBy=multi-user.target
36
EOF
37

38
# 然后执行开机启动rc.local
39
sudo systemctl enable rc-local.service
40

41
# 并给文件赋权限
42
sudo chmod +x /etc/rc.local
43

44
# 重启
45
sudo reboot
46

47
# 重启开机后检查权限是否自动更改解码器用户组为render
48
ls -l /dev/dri
49

50
total 0
51
drwxrwxrwx 2 root root        80 Apr 16 16:11 by-path
52
crwxrwxrwx 1 root video 226,   0 Apr 16 16:11 card0
53
crwxrwxrwx 1 root input 226, 128 Apr 16 16:11 renderD128

切换到新建的用户，安装 docker

Install Docker Engine on Debian | Docker Docs

通过 docker compose 启动 jellyfin 并将

docker-compose.yml

1
services:
2
  jellyfin:
3
    image: nyanmisaka/jellyfin
4
    container_name: jellyfin
5
    environment:
6
      - PUID=1000
7
      - PGID=1000
8
      - TZ=Asia/Shanghai
9
    volumes:
10
      # 修改成你自己的路径
11
      - /path/to/jellyfin/config:/config
12
      - /path/to//jellyfin/media:/media
13
    ports:
14
      - 8096:8096
15
      - 8920:8920
16
    devices:
17
      # 显卡直通
18
      - /dev/dri:/dev/dri
19
    restart: unless-stopped

启动

1
docker compose up -d jellyfin

访问 http://ip_to_lxc<8096>, 设置 jellyfin

通过 smb 挂载 NAS#

允许 lxc 容器挂载 smb

在 lxc 容器中执行

1
sudo apt install cifs-utils samba samba-client -y
2

3
# 挂载硬盘
4
# 建立挂载点
5
sudo mkdir -p /mnt/share
6

7
# 挂载
8
# sudo mount -t cifs //<挂载点地址>/myshare <挂载目录> -o <挂载选项>
9
# dir_mode=0777,file_mode=0777 完全读写权限
10
sudo mount -t cifs //<挂载点地址>/myshare /mnt/share -o uid=1000,gid=1000,vers=2.0,dir_mode=0755,file_mode=0755,mfsymlinks,cache=strict,rsize=1048576,wsize=1048576,username=账号,password=密码
11
# 取消挂载使用 sudo umount /mnt/share
12

13
# 设置开机自动挂载
14
cat >> /etc/fstab << EOF
15
//<挂载点地址>/myshare /mnt/share cifs uid=1000,gid=1000,vers=2.0,dir_mode=0755,file_mode=0755,mfsymlinks,cache=strict,rsize=1048576,wsize=1048576,username=账号,password=密码 0 0
16
EOF

debian 中文乱码解决#

发现终端环境中中文文件名显示乱码，需要解决

1
sudo dpkg-reconfigure locales

选择

1
zh_CN.UTF-8 UTF-8
2
en_US.UTF-8 UTF-8

默认编码选择 en_US.UTF-8

Jellyfin 媒体文件命名规范#

电影命名规则 #

1
Movies
2
├── Film (1990).mp4
3
├── Film (1994).mp4
4
├── Film (2008)
5
│   └── Film.mkv
6
└── Film (2010)
7
    ├── Film-cd1.avi
8
    └── Film-cd2.avi
9

10
# 当有多种版本电影文件时（方式一）
11
Movies
12
└── Best_Movie_Ever (2019)
13
    ├── Best_Movie_Ever (2019) - 1080P.mp4
14
    ├── Best_Movie_Ever (2019) - 720P.mp4
15
    └── Best_Movie_Ever (2019) - Directors Cut.mp4
16

17
# 当有多种版本电影文件时（方式二）
18
Movies
19
└── Best_Movie_Ever (2019)
20
    ├── Best_Movie_Ever (2019) - [1080P].mp4
21
    ├── Best_Movie_Ever (2019) - [720P].mp4
22
    └── Best_Movie_Ever (2019) - [Directors Cut].mp4

电视剧命名规则 #

1
Shows
2
├── Series Name A (2010)
3
│   ├── Season 00
4
│   │   ├── Some Special.mkv
5
│   │   ├── Series Name A S00E01.mkv
6
│   │   └── Series Name A S00E02.mkv
7
│   ├── Season 01
8
│   │   ├── Series Name A S01E01-E02.mkv
9
│   │   ├── Series Name A S01E03.mkv
10
│   │   └── Series Name A S01E04.mkv
11
│   └── Season 02
12
│       ├── Series Name A S02E01.mkv
13
│       ├── Series Name A S02E02.mkv
14
│       ├── Series Name A S02E03 Part 1.mkv
15
│       └── Series Name A S02E03 Part 2.mkv
16
└── Series Name B (2018)
17
    ├── Season 01
18
    |   ├── Series Name B S01E01.mkv
19
    |   └── Series Name B S01E02.mkv
20
    └── Season 02
21
        ├── Series Name B S02E01-E02.mkv
22
        └── Series Name B S02E03.mkv

字幕等文件规则#

1
/Movies
2
    /Film (1946)
3
        Film.mkv
4
        Film.vtt
5
        Film.aac
6
        Film.mka
7
        Film.mks
8
        Film.en.ac3
9
        Film.de.srt
10
        Film.en.dts
11
        Film.german.ac3
12

13
/Movies
14
    /Film (1986)
15
        Film.mkv
16
        Film.default.srt
17
        Film.default.en.forced.ass
18
        Film.forced.en.dts
19
        Film.en.sdh.srt
20
        Film.English Commentary.en.mp3

操作流程#

核显直通PVE#

安装 lxc debian 前准备#

图形化界面创建 CT#

设置显卡#

lxc debian 内操作#

通过 smb 挂载 NAS#

debian 中文乱码解决#

Jellyfin 媒体文件命名规范#

电影命名规则 #

电视剧命名规则 #

字幕等文件规则#

📎 参考文章#

文章分享

N5105 PVE 安装 Debian 运行 docker 实现 jellyfin 硬解

操作流程#

核显直通PVE#

安装 lxc debian 前准备#

图形化界面创建 CT#

设置显卡#

lxc debian 内操作#

通过 smb 挂载 NAS#

debian 中文乱码解决#

Jellyfin 媒体文件命名规范#

电影命名规则#

电视剧命名规则#

字幕等文件规则#

📎 参考文章#

文章分享

电影命名规则 #

电视剧命名规则 #