Jellyfin 部署教程

Jellyfin 是开源媒体服务器，适合在 NAS 上搭建私人影视库。它负责扫描媒体文件、生成海报墙，并让手机、电脑、电视访问播放。

目录规划

bash

/volume1/docker/
├── appdata/jellyfin/
└── media/
    ├── movies/
    ├── tvshows/
    └── anime/

Compose 配置

在 /volume1/docker/compose/jellyfin/docker-compose.yml 写入：

yaml

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    restart: unless-stopped
    ports:
      - "8096:8096"
    volumes:
      - /volume1/docker/appdata/jellyfin/config:/config
      - /volume1/docker/appdata/jellyfin/cache:/cache
      - /volume1/docker/media:/media
    environment:
      - TZ=Asia/Shanghai

启动：

bash

docker compose up -d
docker compose logs -f

访问：

text

http://NAS-IP:8096

媒体库设置

媒体类型	容器内路径	建议目录
电影	`/media/movies`	单片一个文件夹更好整理
剧集	`/media/tvshows`	按剧名和季整理
动漫	`/media/anime`	单独建库，刮削更清晰

和 MoviePilot 配合

MoviePilot 负责搜索、下载、整理；Jellyfin 负责展示和播放。建议让 MoviePilot 整理后的媒体库路径与 Jellyfin 的 /media 路径一致。

典型路径：

text

MoviePilot 媒体库：/media/movies
Jellyfin 电影库：/media/movies

常见问题

海报墙识别不准

检查文件命名，电影建议使用“电影名 (年份)”格式，剧集建议按季整理。

播放卡顿

优先检查网络带宽和客户端解码能力。内网电视播放 4K 时，建议使用有线网络或 5GHz/6GHz Wi-Fi。

看不到媒体文件

大概率是目录映射不一致。确认宿主机 /volume1/docker/media 下确实有文件，并且容器内映射到了 /media。

Jellyfin 部署教程 ​

目录规划 ​

Compose 配置 ​

媒体库设置 ​

和 MoviePilot 配合 ​