Jellyfin部署指南：自建家庭媒体服务器

Jellyfin部署指南自建家庭媒体服务器【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin想把 NAS 里那 200 多部片在电视上自动出海报墙、在手机上接着上次看Jellyfin部署在你自己的电脑或 NAS 上就能做到免费开源、零订阅费所有数据都留在自己的机器里。它到底能干什么媒体库扫描 — 自动识别电影、剧集、音乐、照片生成海报墙和分类元数据抓取 — 从 TMDB、TVDB 等源自动拉取海报、简介、演员实时转码 — 按设备和网络调整质量支持硬件加速多端播放 — Web、iOS、Android、智能电视、机顶盒都能接插件机制 — 可扩展字幕下载、补充元数据源三种搭法先对号入座方式适合谁上手时间需要的工具官方安装包只想在 Windows 或 Ubuntu 上跑起来10 分钟无DockerNAS 或 Linux 用户要配置/媒体分离20 分钟Docker源码构建要改代码或参与贡献半天.NET 10 SDK、git推荐逻辑Jellyfin Docker 部署最通用一条命令跑完配置和媒体分两个卷日后换机器直接拷卷。安装包最省事但绑死在操作系统上。源码构建只建议想动手改代码的人用。跟着做Docker 部署完整步骤安装 Docker 并启动服务Ubuntu/Debiansudo apt update sudo apt install -y docker.io sudo systemctl enable --now docker建两个目录配置和媒体分开mkdir -p ~/jellyfin/config ~/jellyfin/media启动容器docker run -d \ --name jellyfin \ -p 8096:8096 \ -v ~/jellyfin/config:/config \ -v ~/jellyfin/media:/media \ --restartunless-stopped \ jellyfin/jellyfin:latest验证服务已监听 8096 端口curl -I http://localhost:8096返回HTTP 200即可。浏览器打开服务器 IP 加 8096 端口按向导创建管理员账号进入「库」→「添加媒体库」选类型并指向~/jellyfin/media里的文件夹。其余两条路径官方安装包Windows 双击安装程序按向导走Ubuntu 执行sudo apt install jellyfin sudo systemctl enable --now jellyfin服务会自动启动。源码构建先装 .NET 10 SDK仓库global.json固定了 10.0.0然后git clone https://gitcode.com/GitHub_Trending/je/jellyfin并dotnet build --configuration Release产物在Jellyfin.Server/bin/Release/下。装完之后必做的三件事按规范命名媒体文件。电影用电影名 (年份).mp4剧集按季放文件夹如剧集名/Season 01/剧集名 S01E01.mp4。命名解析规则在Emby.Naming/TV/目录命名不合规则海报出不来。开硬件加速。进「播放」→「转码」在硬件加速项里按你的机器选 Intel QuickSync、NVENC 或 AMF。不开的话转码全靠 CPU高码率片源容易卡。配外网访问。别把 8096 直接暴露到公网前面挂反向代理并用域名结束 HTTPS关键行如下location / { proxy_pass http://localhost:8096; proxy_set_header Host $host; }翻车自查清单⚠️ 按这个表对症状基本能定位到一半的问题。症状大概率原因去哪改媒体库扫不到文件挂载目录权限不足检查 Docker 卷或系统用户读权限海报墙出不来文件命名不合规范对照Emby.Naming/下的解析规则重命名播放卡顿、转码失败没开硬件加速或质量太高「播放」→「转码」调质量和硬件加速电视能播手机不能客户端版本旧或解码不支持升级客户端或换转码方式外网连不上端口未放行或代理未生效路由器端口转发、nginx 配置再进一步插件生态在「插件」页可加装字幕下载、补充元数据源如 OMDb仓库里MediaBrowser.Providers/Plugins/下的内置实现是阅读参考。多用户权限在「用户」页为每位家庭成员建号单独设家长控制和播放限制。备份管理后台自带备份入口一键导出配置与数据Docker 部署下也可以手动打包~/jellyfin/config目录留底。写在最后Jellyfin 适合媒体文件已经在 NAS 或硬盘上、想要一个全家共用的影音入口的场景装一次之后只管往里扔文件。下一步建议先按 Docker 路径把服务跑起来再补命名规范。正式迁移大媒体库前先拿一个小目录试跑一遍确认扫描和转码都正常再全量入库。【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考