HxiaoH's Blog

Appearance

在 Windows 10 Pro 上为 WSL2 的 Docker Desktop 安装 Jellyfin 并启用硬件加速 ​

本教程将指导你如何在 Windows 10 Pro 上使用 WSL2 和 Docker Desktop 安装 Jellyfin，并配置硬件加速。

前提条件 ​

  • Windows 10 Pro（版本 2004 或更高）
  • 已安装 WSL2 和 Docker Desktop
  • 支持硬件加速的 GPU（如 NVIDIA GPU）

步骤 1：启用 WSL2 和 Docker Desktop ​

  1. 启用 WSL2： 打开 PowerShell 并以管理员身份运行以下命令：

    powershell
    wsl --install

    如果已经安装了 WSL1，可以升级到 WSL2：

    powershell
    wsl --set-version <distro-name> 2

  2. 安装 Docker Desktop： 下载并安装 Docker Desktop，并确保启用 WSL2 后端。

步骤 2：安装 NVIDIA 驱动和 Docker 插件 ​

  1. 安装 NVIDIA 驱动： 从 NVIDIA 官方网站 下载并安装适用于你的 GPU 的最新驱动程序。

  2. 安装 NVIDIA Docker 插件： 打开 PowerShell 并运行以下命令：

    powershell
    wsl --update
wsl --shutdown

    然后重启 WSL2：

    powershell
    wsl

    在 WSL2 中安装 NVIDIA Docker 插件：

    bash
    curl -s -L https://nvidia.github.io/nvidia-docker/gpgkey | sudo apt-key add -
distribution=$(. /etc/os-release;echo $ID$VERSION_ID)
curl -s -L https://nvidia.github.io/nvidia-docker/$distribution/nvidia-docker.list | sudo tee /etc/apt/sources.list.d/nvidia-docker.list
sudo apt-get update
sudo apt-get install -y nvidia-docker2
sudo systemctl restart docker

步骤 3：拉取并运行 Jellyfin 容器 ​

  1. 拉取 Jellyfin 镜像： 在 WSL2 中运行以下命令来拉取 Jellyfin 镜像：

    bash
    docker pull jellyfin/jellyfin

  2. 运行 Jellyfin 容器： 使用以下命令运行 Jellyfin 容器，并启用硬件加速：

    bash
    docker run -d \
  --name jellyfin \
  --runtime=nvidia \
  --device /dev/dri/renderD128:/dev/dri/renderD128 \
  --device /dev/dri/card0:/dev/dri/card0 \
  -p 8096:8096 \
  -v /path/to/config:/config \
  -v /path/to/media:/media \
  jellyfin/jellyfin

    请将 /path/to/config 和 /path/to/media 替换为你实际的配置和媒体文件路径。

步骤 4：配置 Jellyfin 硬件加速 ​

  1. 访问 Jellyfin Web 界面： 打开浏览器并访问 http://localhost:8096，按照向导完成 Jellyfin 的初始设置。

  2. 启用硬件加速： 在 Jellyfin 的 Web 界面中，进入 Dashboard > Playback，在 Hardware Acceleration 部分选择你的 GPU 类型（如 NVIDIA NVENC），然后保存设置。

步骤 5：验证硬件加速 ​

  1. 播放媒体文件： 在 Jellyfin 中播放一个视频文件，并检查播放器底部的状态栏，确认是否启用了硬件加速。

  2. 查看日志： 你可以通过以下命令查看 Jellyfin 容器的日志，确认硬件加速是否正常工作：

    bash
    docker logs jellyfin

总结 ​

通过以上步骤，你已经成功在 Windows 10 Pro 上使用 WSL2 和 Docker Desktop 安装并配置了 Jellyfin，并启用了硬件加速。现在你可以享受流畅的媒体播放体验了！

Updated at: