主题模式
Are you an LLM? You can read better optimized documentation at /ai/homelab/jellyfin-install.md for this page in Markdown format
2026 Jellyfin 终极搭建指南:N100 核显硬解 + Docker 部署实战
欢迎来到 Homelab 影音中心 专题。
在流媒体订阅费越来越贵的 2026 年,很多玩家开始转向“自建媒体库”。市面上的御三家(Plex, Emby, Jellyfin)中,我最推荐 Jellyfin。
- Plex:界面精美但闭源,硬解要钱。
- Emby:功能强大但闭源,硬解也要钱。
- Jellyfin:完全开源免费,且硬解性能在 2026 年的版本中已经优化的非常完美,特别是对 Intel N100 这种小主机的支持。
今天我就手把手教你搭建一个支持 4K 硬解、海报墙 自动刮削的私人影院。
🛠️ 准备工作
- 硬件:推荐 Intel N100/N305 小主机(核显性能极强)。
- 系统:Debian / Ubuntu / OpenWrt (Docker)。
- 媒体文件:假设你的电影存放在
/mnt/media/movies,电视剧存放在/mnt/media/tv。- 如果你还没挂载硬盘,参考 Ubuntu 挂载 NAS 磁盘。
🐳 Docker Compose 一键部署
不要用命令行一行行敲了,直接用 Docker Compose,维护起来方便一万倍。
1. 创建目录
bash
mkdir -p /root/data/docker_data/jellyfin
cd /root/data/docker_data/jellyfin
nano docker-compose.yml2. 写入配置
复制以下内容(针对 Intel 核显优化):
yaml
services:
jellyfin:
image: jellyfin/jellyfin:latest
container_name: jellyfin
user: 0:0 # 使用 root 权限运行,避免权限问题
network_mode: 'host' # 推荐 host 模式,方便 DLNA 和发现设备
volumes:
- ./config:/config
- ./cache:/cache
- /mnt/media:/media # 这里映射你的真实媒体目录
devices:
- /dev/dri:/dev/dri # 关键!映射核显,开启硬解
restart: unless-stopped
environment:
- JELLYFIN_PublishedServerUrl=http://192.168.1.100:8096 # 你的局域网IP3. 启动容器
bash
docker compose up -d🚀 开启 N100 核显硬解 (QSV)
Jellyfin 最核心的优势就是免费的硬件解码。如果不开启,播放 4K 高码率视频时 CPU 会直接 100% 爆炸。
- 进入 Jellyfin 后台:
http://你的IP:8096。 - 点击左上角菜单 -> “控制台” -> “播放”。
- 硬件加速:选择 Intel QuickSync (QSV)。
- 启用硬件解码:把下面所有的格式(H.264, HEVC, AV1, VP9...)全部勾选。
- 注意:N100 支持 AV1 硬解,这是 2026 年的一大优势,务必勾上!
- 启用硬件编码:也全部勾选。
- 点击保存。
💡 测试方法:找一部 4K HDR 电影播放,在仪表盘里看“转码信息”。如果显示“硬件转码”,且 CPU 占用率低于 20%,说明硬解配置成功!
🎬 打造完美“海报墙”
光有视频不行,我们要的是像 Netflix 那样精美的海报和简介。
1. 媒体库设置
- 在控制台 -> “媒体库” -> 添加媒体库。
- 选择内容类型(电影/节目)。
- 文件夹:选择刚才映射的
/media目录。
2. 刮削器配置
- 元数据下载器:勾选
TheMovieDb和TheTVDB。 - 图片下载器:同样勾选这两个。
- 关键设置:将 “国家/地区” 设为
People's Republic of China,这样刮削出来的海报和简介优先是中文。
⚠️ 网络问题:TMDB 的 API 在国内经常被墙。
- 解决方案:在 Kejilion 工具箱 里的“Hosts 管理”中,选择“更新 Github/TMDB Hosts”,或者在软路由里把 Jellyfin 容器的流量分流到代理。
📺 最佳客户端推荐
有了服务端,用什么看体验最好?
Apple TV / iOS / Mac:Infuse(收费但无敌)或 VidHub(国产新秀,性价比高)。
它们直接通过 SMB 挂载或连接 Jellyfin,解码能力比网页版强一百倍。
Android TV:官方客户端 或 Findroid。
PC 端:Jellyfin Media Player(支持直通音频)。
🔗 下一步做什么?
现在你的影音中心只能在局域网里看。如果想在公司摸鱼时,或者出差在酒店时也能连回家里的 Jellyfin 看 4K 电影,该怎么办?
不管是公网 IP 还是 IPv6,都不如一条加密隧道安全。 下一篇,教你用 Cloudflare Tunnel 穿透内网,无需公网 IP 也能远程访问。