Jellyfin 部署指南5 分钟跑通你的私有媒体服务器【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin想把家里的电影、剧集、音乐搬上手机和电视又不想给任何流媒体平台交订阅费缺的不是网络是中间那台能统一管文件、随时开播的服务器。Jellyfin 就是干这个的一个完全开源、免费的自托管媒体系统你的片源扫描进它浏览器或客户端随时点开就看数据全留在自己机器上。5 分钟快速上手一条命令装好最省事的路径是走系统包管理器装完服务就自动注册了sudo apt install jellyfin sudo systemctl start jellyfin接着打开浏览器访问http://localhost:80968096 是它的默认端口会先进入初始向导创建管理员账户、选媒体库文件夹、设置语言。整个向导走完不到两分钟之后每部影片的封面、简介都会被自动刮削补齐。跑起来之后局域网里任何其他设备访问http://服务器IP:8096就能登录使用。Windows 上则是从官方下载页拿安装包双击装完服务名是jellyfin用net start jellyfin这类命令管理启停即可。更多细节可以看仓库自带的 README。容器化部署适合家里那台常开的机器如果你有一台 NAS 或 24 小时开机的旧机器Docker 是更推荐的姿势环境隔离、迁移时把镜像和挂载卷带走就行。docker run -d --name jellyfin \ --user $(id -u):$(id -g) \ -p 8096:8096 \ -v /jellyfin/config:/config \ -v /jellyfin/cache:/cache \ -v /media:/media \ --restartunless-stopped \ jellyfin/jellyfin关键参数就三个-p 8096:8096把服务端口映射出来/config、/cache、/media三个卷分别放配置、转码缓存和片源换机器时只需带走前两个加 media 里的文件--user用当前用户身份运行避免容器内 root 把挂载目录的文件属主搞乱导致宿主机上读不到媒体。从源码编译给想折腾的开发者这个仓库就是 Jellyfin 的后端ASP.NET Core 服务想加个 API、改个扫描逻辑就从这里动手。准备工作装 .NET 10 SDK版本要求写在 global.json 里和 ffmpeg然后克隆仓库git clone https://gitcode.com/GitHub_Trending/je/jellyfin cd jellyfin dotnet run --project Jellyfin.Server --webdir /path/to/jellyfin-web/dist--webdir指向 Web 前端jellyfin-web 的 dist 产物——前端是独立仓库本仓库不包含向导页面就靠它。另一种方式是先dotnet build再进入Jellyfin.Server/bin/Debug/net10.0直接执行./jellyfinWindows 是jellyfin.exe这样命令行参数随便加。启动参数都定义在 StartupOptions.cs 里最常用的几个参数作用--datadir数据库等数据文件目录--configdir/--cachedir/--logdir配置 / 缓存 / 日志目录各自独立指路--ffmpeg指定 ffmpeg 可执行文件路径--nowebclient不托管 Web 客户端配前端分离开发时用--mode选择启动模式默认就是媒体服务器避坑清单️启动日志报 Kestrel failed to start... port bind→ 根因8096 端口被别的进程占了日志原文见 Program.cs 里的错误提示。 → 解法打开配置目录下的network.xml把 HTTP 端口改成空闲的默认值 8096 定义在 NetworkConfiguration.cs改完重启服务。服务起来但访问是空白页日志提示 web client 目录无效或为空→ 根因源码运行时默认要托管前端而前端文件并不在这个仓库里。 → 解法--webdir指向 jellyfin-web 的构建产物确认不用前端就加--nowebclient首页会自动重定向到 API 文档页。电影能播但剧集成片识别混乱、封面对不上→ 根因文件命名不符合解析规则解析器猜不出哪集是哪集。 → 解法按剧名 S01E01.mkv这类标准命名重排想确认规则细节直接翻 Emby.Naming/TV/ 和 Emby.Naming/Video/ 下的解析器源码。能直连播放但转码失败日志找不到 ffmpeg→ 根因系统里没装 ffmpeg 或不在 PATH 里。 → 解法装好 ffmpeg必要时用--ffmpeg显式指定路径。进阶彩蛋两个不常用但很好用的入口藏在服务内置里API 调试页访问http://localhost:8096/api-docs/swagger/index.html所有接口都有交互文档可以直接在浏览器里带着 Token 调接口写客户端或自动化脚本前拿它试参数再省事。健康检查与指标/health端点适合挂给监控见 Startup.cs 里的MapHealthChecks打开服务配置里的EnableMetrics后还能导出 Prometheus 格式的指标顺手就把服务器监控做了。整库备份与恢复管理界面可以一键打包配置、元数据、数据库实现见 BackupService.cs迁移机器时用启动参数--restore-archive 备份包路径就能还原。元数据插件刮削数据源可以按口味换比如 OMDb 插件片库建好、全家人的设备都能流畅点播之后就剩一件事——把你硬盘里那批积灰的片源挂上去。现在就去把那台 Jellyfin 跑起来5 分钟后你就能在沙发上看到自己的库了。【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Jellyfin 部署指南：5 分钟跑通你的私有媒体服务器
Jellyfin 部署指南5 分钟跑通你的私有媒体服务器【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin想把家里的电影、剧集、音乐搬上手机和电视又不想给任何流媒体平台交订阅费缺的不是网络是中间那台能统一管文件、随时开播的服务器。Jellyfin 就是干这个的一个完全开源、免费的自托管媒体系统你的片源扫描进它浏览器或客户端随时点开就看数据全留在自己机器上。5 分钟快速上手一条命令装好最省事的路径是走系统包管理器装完服务就自动注册了sudo apt install jellyfin sudo systemctl start jellyfin接着打开浏览器访问http://localhost:80968096 是它的默认端口会先进入初始向导创建管理员账户、选媒体库文件夹、设置语言。整个向导走完不到两分钟之后每部影片的封面、简介都会被自动刮削补齐。跑起来之后局域网里任何其他设备访问http://服务器IP:8096就能登录使用。Windows 上则是从官方下载页拿安装包双击装完服务名是jellyfin用net start jellyfin这类命令管理启停即可。更多细节可以看仓库自带的 README。容器化部署适合家里那台常开的机器如果你有一台 NAS 或 24 小时开机的旧机器Docker 是更推荐的姿势环境隔离、迁移时把镜像和挂载卷带走就行。docker run -d --name jellyfin \ --user $(id -u):$(id -g) \ -p 8096:8096 \ -v /jellyfin/config:/config \ -v /jellyfin/cache:/cache \ -v /media:/media \ --restartunless-stopped \ jellyfin/jellyfin关键参数就三个-p 8096:8096把服务端口映射出来/config、/cache、/media三个卷分别放配置、转码缓存和片源换机器时只需带走前两个加 media 里的文件--user用当前用户身份运行避免容器内 root 把挂载目录的文件属主搞乱导致宿主机上读不到媒体。从源码编译给想折腾的开发者这个仓库就是 Jellyfin 的后端ASP.NET Core 服务想加个 API、改个扫描逻辑就从这里动手。准备工作装 .NET 10 SDK版本要求写在 global.json 里和 ffmpeg然后克隆仓库git clone https://gitcode.com/GitHub_Trending/je/jellyfin cd jellyfin dotnet run --project Jellyfin.Server --webdir /path/to/jellyfin-web/dist--webdir指向 Web 前端jellyfin-web 的 dist 产物——前端是独立仓库本仓库不包含向导页面就靠它。另一种方式是先dotnet build再进入Jellyfin.Server/bin/Debug/net10.0直接执行./jellyfinWindows 是jellyfin.exe这样命令行参数随便加。启动参数都定义在 StartupOptions.cs 里最常用的几个参数作用--datadir数据库等数据文件目录--configdir/--cachedir/--logdir配置 / 缓存 / 日志目录各自独立指路--ffmpeg指定 ffmpeg 可执行文件路径--nowebclient不托管 Web 客户端配前端分离开发时用--mode选择启动模式默认就是媒体服务器避坑清单️启动日志报 Kestrel failed to start... port bind→ 根因8096 端口被别的进程占了日志原文见 Program.cs 里的错误提示。 → 解法打开配置目录下的network.xml把 HTTP 端口改成空闲的默认值 8096 定义在 NetworkConfiguration.cs改完重启服务。服务起来但访问是空白页日志提示 web client 目录无效或为空→ 根因源码运行时默认要托管前端而前端文件并不在这个仓库里。 → 解法--webdir指向 jellyfin-web 的构建产物确认不用前端就加--nowebclient首页会自动重定向到 API 文档页。电影能播但剧集成片识别混乱、封面对不上→ 根因文件命名不符合解析规则解析器猜不出哪集是哪集。 → 解法按剧名 S01E01.mkv这类标准命名重排想确认规则细节直接翻 Emby.Naming/TV/ 和 Emby.Naming/Video/ 下的解析器源码。能直连播放但转码失败日志找不到 ffmpeg→ 根因系统里没装 ffmpeg 或不在 PATH 里。 → 解法装好 ffmpeg必要时用--ffmpeg显式指定路径。进阶彩蛋两个不常用但很好用的入口藏在服务内置里API 调试页访问http://localhost:8096/api-docs/swagger/index.html所有接口都有交互文档可以直接在浏览器里带着 Token 调接口写客户端或自动化脚本前拿它试参数再省事。健康检查与指标/health端点适合挂给监控见 Startup.cs 里的MapHealthChecks打开服务配置里的EnableMetrics后还能导出 Prometheus 格式的指标顺手就把服务器监控做了。整库备份与恢复管理界面可以一键打包配置、元数据、数据库实现见 BackupService.cs迁移机器时用启动参数--restore-archive 备份包路径就能还原。元数据插件刮削数据源可以按口味换比如 OMDb 插件片库建好、全家人的设备都能流畅点播之后就剩一件事——把你硬盘里那批积灰的片源挂上去。现在就去把那台 Jellyfin 跑起来5 分钟后你就能在沙发上看到自己的库了。【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考