如何部署 Jellyfin 媒体服务器从家用电脑到源码编译的 4 条路线【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin想让收藏的片单在家里电视和手机上随时播放自建媒体服务器是最直接的办法。Jellyfin 是一款免费开源的媒体服务器把电影、剧集、音乐文件放在自己的机器上它负责整理成库、多端流式播放数据全程握在自己手里。这篇文章按先选型、再落地、后验证排障的顺序带你把 Jellyfin 部署跑通。部署路线选型先看这张表动手前先确认自己的环境对号入座即可不用每条路线都看你的环境推荐路线特点家用 Windows 电脑长期开机官方安装包双击安装以服务形式随系统管理Linux 桌面或服务器发行版软件包apt / dnf系统服务托管开机自启省心已有 Docker 环境或虚拟机官方镜像 jellyfin/jellyfin隔离性好迁移时搬走目录即可想读源码、做二次开发dotnet 源码编译可调试、可改造家用电脑直接装Windows 与 Linux 安装包Windows 上从官方下载页拿到安装包后按提示完成安装即可服务会随安装自动启动。默认安装目录是C:\Program Files\Jellyfin\ServerWeb 客户端位于Server\jellyfin-web子目录。日常管理用服务命令就够了net start jellyfin net stop jellyfin net restart jellyfinLinux 上走软件源Ubuntu/Debian 与 CentOS/RHEL 各一条命令sudo apt install jellyfin sudo dnf install jellyfin这里注意一下进阶参数Jellyfin 的启动命令支持--datadir数据目录、--configdir配置目录、--cachedir缓存目录、--logdir日志目录、--webdirWeb 客户端目录、--ffmpeg指定 ffmpeg 可执行文件路径。目录想放 SSD 或集中管理时在服务的启动配置里加上对应参数即可完整参数定义可以在 StartupOptions.cs 里查到。Docker 路线部署命令与参数容器方式隔离性好配置、缓存、媒体三个目录挂载出来日后迁移只需打包这三个目录。先确保 Docker 可用sudo apt install docker.io sudo systemctl enable --now docker然后一条docker run拉起服务把三个/path/to/...换成真实路径docker run -d \ --name jellyfin \ --user $(id -u):$(id -g) \ -p 8096:8096 \ -v /path/to/config:/config \ -v /path/to/cache:/cache \ -v /path/to/media:/media \ --restartunless-stopped \ jellyfin/jellyfin参数逐个说--user让容器用当前用户身份跑避免媒体文件权限问题-p 8096:8096映射默认服务端口三条-v分别挂载配置、缓存、媒体目录Jellyfin 启动时会按/config、/cache约定初始化--restartunless-stopped保证重启宿主机后服务自动回来。如果你机器上的 ffmpeg 不在容器默认路径也可以给宿主机目录挂载后用--ffmpeg指向它。源码级玩法dotnet 编译与运行想读懂内部机制或做二开直接从源码起服务。前置依赖是 .NET SDK仓库的 global.json 锁定 10.0.0允许 minor 向上滚动和 ffmpeg两者装好后开始编译git clone https://gitcode.com/GitHub_Trending/je/jellyfin cd jellyfin dotnet build cd Jellyfin.Server/bin/Debug/net10.0 ./jellyfinWindows 上执行的是jellyfin.exe。这里注意源码仓库不含 Web 客户端静态文件若服务没有托管现成的 jellyfin-web启动时加--webdir指向客户端资源目录浏览器端才能正常打开。想边调边跑的话用 Visual Studio 或 VS Code 打开解决方案后直接按 F5 也行。跑起来之后首次访问验证清单服务起来后按这个清单逐项确认能明确判断部署是否成功浏览器打开http://服务器IP:8096首次访问会进入向导页面创建管理员账户设置用户名和密码添加媒体库选择电影、电视剧、音乐等类型指定对应媒体目录等待扫描完成在库里挑一部片子确认能正常播放需要查接口文档时访问http://服务器IP:8096/api-docs/swagger/index.html数据层面建议顺手配好备份管理界面内置了整库备份功能恢复时用jellyfin --restore-archive /path/to/backup.zip指回备份包即可实现可以看 BackupService.cs。缓存目录放 SSD、前面架一层反向代理走 HTTPS都是常见的稳定性加分项。排障三个高频情况端口冲突。现象是启动日志里提示地址已在使用、Web 端打不开。原因不复杂8096 默认端口被别的程序占掉了。处理方式是编辑配置目录下的network.xml把Port8096/Port改成空闲端口然后重启服务。媒体文件不识别。现象是文件明明在目录里库里却看不到。原因通常是两类服务运行用户对媒体目录没有读权限或者文件名不符合解析规则。先查权限再对照命名解析器的实现调整文件名电视剧和电影的规则分别在 Emby.Naming/TV/ 和 Emby.Naming/Video/ 两个目录的解析器代码里能直接看出支持哪些格式。识别成功后海报和简介等元数据还会由 OMdb 这类元数据提供者插件自动补齐。转码播放卡顿。现象是服务器本地流畅、客户端却卡高码率源尤其明显。原因一般是 ffmpeg 版本不对或缺少硬件加速。处理上先装 Jellyfin 专用版sudo apt install jellyfin-ffmpeg再到管理界面的播放 硬件加速里启用对应显卡的加速最后视带宽情况下调转码质量参数。对照表里挑一条路线动手一小时内就能有自己的媒体中心。部署中卡在哪一步或者想基于源码做改造欢迎在评论区聊聊你的环境。【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何部署 Jellyfin 媒体服务器：从家用电脑到源码编译的 4 条路线
如何部署 Jellyfin 媒体服务器从家用电脑到源码编译的 4 条路线【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin想让收藏的片单在家里电视和手机上随时播放自建媒体服务器是最直接的办法。Jellyfin 是一款免费开源的媒体服务器把电影、剧集、音乐文件放在自己的机器上它负责整理成库、多端流式播放数据全程握在自己手里。这篇文章按先选型、再落地、后验证排障的顺序带你把 Jellyfin 部署跑通。部署路线选型先看这张表动手前先确认自己的环境对号入座即可不用每条路线都看你的环境推荐路线特点家用 Windows 电脑长期开机官方安装包双击安装以服务形式随系统管理Linux 桌面或服务器发行版软件包apt / dnf系统服务托管开机自启省心已有 Docker 环境或虚拟机官方镜像 jellyfin/jellyfin隔离性好迁移时搬走目录即可想读源码、做二次开发dotnet 源码编译可调试、可改造家用电脑直接装Windows 与 Linux 安装包Windows 上从官方下载页拿到安装包后按提示完成安装即可服务会随安装自动启动。默认安装目录是C:\Program Files\Jellyfin\ServerWeb 客户端位于Server\jellyfin-web子目录。日常管理用服务命令就够了net start jellyfin net stop jellyfin net restart jellyfinLinux 上走软件源Ubuntu/Debian 与 CentOS/RHEL 各一条命令sudo apt install jellyfin sudo dnf install jellyfin这里注意一下进阶参数Jellyfin 的启动命令支持--datadir数据目录、--configdir配置目录、--cachedir缓存目录、--logdir日志目录、--webdirWeb 客户端目录、--ffmpeg指定 ffmpeg 可执行文件路径。目录想放 SSD 或集中管理时在服务的启动配置里加上对应参数即可完整参数定义可以在 StartupOptions.cs 里查到。Docker 路线部署命令与参数容器方式隔离性好配置、缓存、媒体三个目录挂载出来日后迁移只需打包这三个目录。先确保 Docker 可用sudo apt install docker.io sudo systemctl enable --now docker然后一条docker run拉起服务把三个/path/to/...换成真实路径docker run -d \ --name jellyfin \ --user $(id -u):$(id -g) \ -p 8096:8096 \ -v /path/to/config:/config \ -v /path/to/cache:/cache \ -v /path/to/media:/media \ --restartunless-stopped \ jellyfin/jellyfin参数逐个说--user让容器用当前用户身份跑避免媒体文件权限问题-p 8096:8096映射默认服务端口三条-v分别挂载配置、缓存、媒体目录Jellyfin 启动时会按/config、/cache约定初始化--restartunless-stopped保证重启宿主机后服务自动回来。如果你机器上的 ffmpeg 不在容器默认路径也可以给宿主机目录挂载后用--ffmpeg指向它。源码级玩法dotnet 编译与运行想读懂内部机制或做二开直接从源码起服务。前置依赖是 .NET SDK仓库的 global.json 锁定 10.0.0允许 minor 向上滚动和 ffmpeg两者装好后开始编译git clone https://gitcode.com/GitHub_Trending/je/jellyfin cd jellyfin dotnet build cd Jellyfin.Server/bin/Debug/net10.0 ./jellyfinWindows 上执行的是jellyfin.exe。这里注意源码仓库不含 Web 客户端静态文件若服务没有托管现成的 jellyfin-web启动时加--webdir指向客户端资源目录浏览器端才能正常打开。想边调边跑的话用 Visual Studio 或 VS Code 打开解决方案后直接按 F5 也行。跑起来之后首次访问验证清单服务起来后按这个清单逐项确认能明确判断部署是否成功浏览器打开http://服务器IP:8096首次访问会进入向导页面创建管理员账户设置用户名和密码添加媒体库选择电影、电视剧、音乐等类型指定对应媒体目录等待扫描完成在库里挑一部片子确认能正常播放需要查接口文档时访问http://服务器IP:8096/api-docs/swagger/index.html数据层面建议顺手配好备份管理界面内置了整库备份功能恢复时用jellyfin --restore-archive /path/to/backup.zip指回备份包即可实现可以看 BackupService.cs。缓存目录放 SSD、前面架一层反向代理走 HTTPS都是常见的稳定性加分项。排障三个高频情况端口冲突。现象是启动日志里提示地址已在使用、Web 端打不开。原因不复杂8096 默认端口被别的程序占掉了。处理方式是编辑配置目录下的network.xml把Port8096/Port改成空闲端口然后重启服务。媒体文件不识别。现象是文件明明在目录里库里却看不到。原因通常是两类服务运行用户对媒体目录没有读权限或者文件名不符合解析规则。先查权限再对照命名解析器的实现调整文件名电视剧和电影的规则分别在 Emby.Naming/TV/ 和 Emby.Naming/Video/ 两个目录的解析器代码里能直接看出支持哪些格式。识别成功后海报和简介等元数据还会由 OMdb 这类元数据提供者插件自动补齐。转码播放卡顿。现象是服务器本地流畅、客户端却卡高码率源尤其明显。原因一般是 ffmpeg 版本不对或缺少硬件加速。处理上先装 Jellyfin 专用版sudo apt install jellyfin-ffmpeg再到管理界面的播放 硬件加速里启用对应显卡的加速最后视带宽情况下调转码质量参数。对照表里挑一条路线动手一小时内就能有自己的媒体中心。部署中卡在哪一步或者想基于源码做改造欢迎在评论区聊聊你的环境。【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考