跳到主要内容

Jellyfin

本文提供 Jellyfin 媒体服务器的部署示例、初始化步骤与配置原因说明。

也可以参考官网的部署步骤：Docker 部署

1. 目录与挂载约定​

/app/jellyfin/
├─ docker-compose.yml
├─ config/
├─ cache/
└─ media/

说明：

  • config：Jellyfin 配置文件目录
  • cache：缓存和临时文件目录
  • media：媒体文件目录（可包含 movies、tv、music 等子目录，也可替换为其他宿主机媒体目录）

2. Compose 配置示例​

/app/jellyfin/docker-compose.yml：

services:
  jellyfin:
    image: jellyfin/jellyfin:10
    container_name: jellyfin
    restart: unless-stopped
    ports:
      - "8096:8096/tcp"
      - "7359:7359/udp"
    environment:
      - JELLYFIN_PublishedServerUrl=http://<SERVER_IP>:8096
    volumes:
      - ./config:/config
      - ./cache:/cache
      - type: bind
        source: ./media
        target: /media
        read_only: true

配置原因：

  • 镜像标签固定为大版本 10，可降低 latest 带来的不可预期升级风险；如需更严格控制，可进一步固定到小版本
  • 8096/tcp 是 Web 访问端口，7359/udp 用于客户端自动发现
  • JELLYFIN_PublishedServerUrl 用于告诉客户端服务器对外访问地址，尤其适合内网穿透、反代或多网卡环境
  • 媒体目录使用 bind mount 且默认只读挂载，降低误删或误改媒体文件的风险
提示

如果你需要启用 DLNA 广播，或明确希望 Jellyfin 直接使用宿主机网络，可以改成主机网络模式：

    network_mode: host
    environment:
      - JELLYFIN_PublishedServerUrl=http://<SERVER_IP>:8096

同时删除 ports 配置。官方文档将主机网络模式视为可选项，常见用途是 DLNA；如果只是普通 Web 播放和局域网访问，默认桥接模式已经足够。

3. 首次初始化​

服务启动后，访问 http://<SERVER_IP>:8096（或你配置的实际域名）进入初始化向导，并完成以下设置：

  • 选择界面语言和管理员账号
  • 添加媒体库，容器内路径填写 /media
  • 如使用内网穿透或反向代理，确认后台中的公开访问地址与 JELLYFIN_PublishedServerUrl 一致

如果需要挂载多个媒体目录，可继续追加多个只读挂载，例如 /media2、/media3，再在初始化向导中分别添加媒体库。

4. 常用命令​

# 启动 Jellyfin
cd /app/jellyfin && docker compose up -d

# 关闭 Jellyfin
cd /app/jellyfin && docker compose down

# 查看容器日志
docker logs -f jellyfin

5. 可选：开启硬件加速​

如果宿主机已经配置好 Intel/AMD GPU 驱动，可在 compose 中追加设备映射：

    devices:
      - /dev/dri:/dev/dri

之后在 Jellyfin 管理后台开启对应的硬件转码方式。若宿主机启用了额外的设备权限控制，请确保容器用户对 /dev/dri 具备访问权限。