wiki-ingest: Multi-Agent System Reliability

wiki/sources/用Docker安装Jellyfin.md

@@ -0,0 +1,78 @@
+---
+title: "用Docker安装Jellyfin"
+type: source
+tags: [docker, jellyfin, media-server, synology, nas]
+date: 2026-04-03
+---
+
+## Source File
+- [[raw/Home Office/用Docker安装Jellyfin.md]]
+
+## Summary
+- 核心主题：Synology NAS Docker 部署 Jellyfin 开源媒体服务器
+- 问题域：自托管家庭媒体库，支撑 Plex 对抗的商业闭源方案
+- 方法/机制：nyanmisaka/jellyfin 镜像 + Intel QuickSync 硬件转码 + 群晖 UID/GID 固定 + 只读媒体卷保护
+- 结论/价值：完整的 Jellyfin Docker Compose 配置，含硬件转码、环境变量、字体挂载、端口和重启策略
+
+## Key Claims
+- nyanmisaka/jellyfin 镜像提供优化的 Jellyfin 构建，修复官方镜像转码兼容性问题
+- 通过 --devices /dev/dri:/dev/dri 挂载 Intel GPU，实现硬件 QuickSync 转码，降低 CPU 负载
+- 容器使用 user: "1026:100" 固定为群晖默认用户，避免权限问题
+- /volume1/docker/jellyfin/fonts 目录以 :ro 只读挂载，防止字体被容器修改
+- JELLYFIN_PublishedServerUrl 环境变量设置公网访问地址，供外部发现服务
+- restart: unless-stopped 保证容器崩溃后自动重启
+
+## Key Quotes
+> "群晖建议使用具体的 UID:GID" — Docker 部署最佳实践
+> "核心优化：挂载硬件渲染设备以实现 Intel QuickSync 转码" — 性能优化关键
+
+## Key Concepts
+- [[硬件转码]]：Intel QuickSync 利用 GPU 加速视频格式转换，减轻 CPU 负担
+- [[媒体刮削]]：Jellyfin 自动从 TMDB/TVDB 等源获取元数据（标题/封面/简介）
+- [[Docker容器化]]：隔离运行环境影响，docker-compose 一键部署
+- [[只读挂载]]：保护源文件不被容器内进程意外修改
+- [[Plex]]：Jellyfin 是 Plex 的开源分支，功能高度同构
+
+## Key Entities
+- [[Jellyfin]]：开源媒体服务器，Plex 的自由软件替代品
+- [[Synology NAS]]：群晖 NAS，Docker 宿主机，存储媒体文件
+- [[nyanmisaka/jellyfin]]：优化过的 Jellyfin 第三方镜像，内置转码支持
+
+## Connections
+- [[Jellyfin]] ← runs_on ← [[Synology NAS]]
+- [[Jellyfin]] ← transcodes_with ← Intel QuickSync (via /dev/dri)
+- [[Jellyfin]] ← serves_media ← /volume2/movie + /volume1/TV shows
+- [[家庭网络环境概览_2026-04-03]] ← 暴露公网访问 ← jellyfin.ishenwei.online:18096
+
+## Jellyfin Docker Compose 核心配置
+
+```yaml
+services:
+  jellyfin:
+    image: nyanmisaka/jellyfin:latest
+    container_name: jellyfin
+    user: "1026:100"
+    ports:
+      - 8096:8096/tcp
+      - 7359:7359/udp  # 客户端自动发现
+    volumes:
+      - /volume1/docker/jellyfin/config:/config
+      - /volume1/docker/jellyfin/cache:/cache
+      - /volume2/movie:/media
+      - /volume1/TV shows:/media2
+      - /volume1/docker/jellyfin/fonts:/usr/local/share/fonts/custom:ro
+    environment:
+      - JELLYFIN_PublishedServerUrl=http://jellyfin.ishenwei.online
+      - TZ=Asia/Shanghai
+    devices:
+      - /dev/dri:/dev/dri  # Intel GPU 硬件转码
+    restart: unless-stopped
+    extra_hosts:
+      - host.docker.internal:host-gateway
+```
+
+## Contradictions
+- 与 [[Synology NAS + Xiaoya Alist + CloudDrvie2+ Plex to Build Media Platform]]：
+  - 冲突点：Plex vs Jellyfin 作为媒体服务器的选择
+  - 当前观点：Jellyfin 开源自托管，完全免费
+  - 对方观点：Plex 有更好的商业生态和客户端支持