Jellyfin 搭建全指南4 步自建跨平台流媒体中心【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfinJellyfin 是一个自由开源的家庭流媒体服务Server 后端与 API能把你的电影、音乐、照片集中管理起来并通过网页、手机、智能电视等多种设备播放。本文面向第一次自建媒体库的新手和想从源码跑起服务的开发者手把手带你在 Linux 上编译安装 Jellyfin、创建媒体库、开启硬件加速、配置后台服务并整理一份常见的故障排查清单帮你把私人媒体中心稳稳跑起来。先把它跑起来Jellyfin 安装的三步走不管最终选哪台机器做服务器先检查两样东西.NET 10 SDKJellyfin 后端运行环境仓库里global.json锁定的就是 10.0和ffmpeg负责解码和转码的命令行工具。两者齐活编译才能通过。# Linux 下一并装好 .NET 10 SDK 与 ffmpeg sudo apt update sudo apt install -y dotnet-sdk-10.0 ffmpegWindows 用户走官方安装包即可按向导装完服务会自动注册macOS 用户可以直接跳到下面的 Docker 方案省心不少。接下来克隆源码并编译。整个仓库是只读的拿到代码后先构建git clone https://gitcode.com/GitHub_Trending/je/jellyfin cd jellyfin dotnet build构建成功后进入输出目录启动服务。注意这个仓库只包含服务端网页界面需要单独的 web client 文件可以用--webdir指定它的位置如果你暂时没有网页端加--nowebclient启动改用官方客户端 App 连接也一样cd Jellyfin.Server/bin/Debug/net10.0 ./jellyfin --nowebclient # 或 ./jellyfin --webdir /path/to/jellyfin-web/dist启动后浏览器打开http://localhost:8096首次进入会引导你创建管理员账号想看 API 文档可以访问http://localhost:8096/api-docs/swagger/index.html。如果你更习惯容器一条 Docker 命令就能在 macOS或任意系统上跑起来把配置、缓存和电影目录映射到宿主机docker run -d --name jellyfin -p 8096:8096 -p 8920:8920 \ -v ~/jellyfin/config:/config -v ~/jellyfin/cache:/cache \ -v ~/Movies:/media --restartunless-stopped jellyfin/jellyfin建好媒体库让 Jellyfin 认识你的文件服务跑起来只是第一步真正好用取决于媒体库怎么建。登录管理界面进入控制台 → 媒体库 → 添加媒体库选类型电影、电视剧、音乐、照片各建一个、指定文件夹、元数据源保持默认扫描完成后目录就会按类型自动归类。这里的关键是文件命名。Jellyfin 靠解析文件名来判断哪部作品、哪一季哪一集解析规则就写在前面的 Emby.Naming/ 目录里。两个推荐格式电影星际穿越 (2014).mp4即片名 (年份)电视剧剧集名/Season 01/剧集名 - S01E01.mp4命名规范后封面和剧情简介才会对得上。这些信息来自内置的元数据插件比如针对电影条目启用的 OMDb 数据源扫描时会自动拉取对应语言的资料。播得动 4K转码与硬件加速怎么开不同设备能直接播放的格式不一样电视播不了的编码服务器可以实时翻译一遍再送过去这个过程叫转码代价是吃 CPU。想让 4K 高码率视频也丝滑就交给显卡干。开启方法在管理界面控制台 → 播放 → 硬件加速从下拉框选你机器支持的选项比如 QSV、VA-API转码质量选平衡保存后重启服务。不确定显卡支持哪些加速编码器时用这条命令让 ffmpeg 自己报数ffmpeg -encoders | grep -i hw能列出对应平台的硬件编码器说明环境没问题剩下的交给配置界面勾选即可。转码相关的核心逻辑都在 MediaBrowser.MediaEncoding/ 模块里想看细节可以翻一翻。让它长期稳定跑后台服务与端口规划关掉终端服务就停了这不叫部署。把它注册成系统服务开机自启、崩了自动拉起sudo tee /etc/systemd/system/jellyfin.service EOF [Unit] DescriptionJellyfin Media Server Afternetwork.target [Service] Userjellyfin WorkingDirectory/opt/jellyfin ExecStart/opt/jellyfin/jellyfin --datadir /var/jellyfin/data --cachedir /var/jellyfin/cache Restarton-failure [Install] WantedBymulti-user.target EOF sudo systemctl daemon-reload sudo systemctl enable --now jellyfin用sudo systemctl status jellyfin确认状态是active (running)就稳了。端口方面记住两个数字8096 是 HTTP 主端口8920 是 HTTPS 端口。要改端口改配置文件system.xmlLinux 在/var/jellyfin/config/Windows 在C:\ProgramData\Jellyfin\config\里的Port和HttpsPort节点保存后重启服务生效。有公网需求的话在控制台 → 网络里配置证书路径开启 HTTPS并勾选 HTTP 自动跳转。另外别忘了定期备份新版 Jellyfin 自带完整备份能力把数据库、配置和用户资料打包归档换机器迁移时一还原就回来。卡住了按这份清单排障 排障基本是三板斧查端口、看日志、修权限。打不开页面多半是端口被占sudo lsof -i :8096 # 找出占用 8096 的进程 sudo kill -9 PID # 结束它或者换端口./jellyfin --port 8097启动直接失败先看日志再说最后 100 行通常就有答案tail -n 100 /var/jellyfin/log/jellyfin.log同时确认dotnet --info显示的是 10.0 版本、ffmpeg -version能正常输出。库建了但文件识别不全九成是权限问题把媒体目录的服务属主和读权限补上sudo chown -R jellyfin:jellyfin /path/to/media sudo chmod -R 755 /path/to/media最后回到命名规范电影带上年份、剧集对齐 S01E01 格式重新触发一次库刷新识别率会明显上来。跑通这些你就有了一台属于自己、随时能看、谁都能连的媒体服务器。接下来可以装手机 App 出门追剧或者用端口转发加动态 DNS 把访问范围扩到外网。【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考