Jellyfin 部署教程三步搭建私有媒体库流媒体服务器【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfinNAS 里的电影想在手机、电视、电脑上随时点开就看——用 Jellyfin 部署一个私有媒体服务器即可把自托管的媒体文件通过网络推送到各终端免费开源数据全程在自己手里。下面按「选路线 → 跑起来 → 初始化 → 后续维护」的顺序讲清楚。部署路径怎么选Jellyfin 部署主要有三条路线差异集中在适用人群和长期维护成本上。如果机器上已经跑着其他容器化服务比如 NAS 场景容器化部署通常最省心环境隔离干净升级、迁移都是一条命令的事。路径适合人群上手难度维护成本安装包Windows/Linux 包管理器只想装完就用的单机用户低低容器化DockerNAS / 服务器用户需要隔离与可迁移中低源码编译开发者、要做二次开发高中本文主推容器化部署另外两条路线在「再进一步」中各补一句要点。如何用 Docker 把 Jellyfin 跑起来准备环境先装 Docker 并让它开机自启两条命令即可sudo apt install docker.io sudo systemctl enable --now docker启动服务把下面命令中的/path/to/...换成你机器上的真实目录然后执行docker run -d --name jellyfin -p 8096:8096 \ -v /path/to/config:/config \ -v /path/to/cache:/cache \ -v /path/to/media:/media \ --restartunless-stopped jellyfin/jellyfin关键参数说明其余参数以官方文档为准参数作用-p 8096:8096映射 Web 端口Jellyfin 默认 HTTP 端口就是 8096-v ...:/config、:/cache、:/media分别挂载配置、缓存、媒体目录媒体库放这里--restartunless-stopped宿主机重启后容器自动拉起若容器内出现媒体读不到的问题加--user $(id -u):$(id -g)指定与宿主一致的运行用户多数权限报错就消失了。初始化从启动到能播放服务起来后浏览器访问http://服务器IP:8096进入首次引导流程按顺序做三件事创建管理员账户设置用户名和密码这是后续所有权限管理的起点。添加媒体库选择媒体类型电影、电视剧、音乐等指向挂载进来的媒体目录服务会自动扫描并建立索引。配置网络访问在管理界面设置局域网访问权限控制哪些设备能连接。做完这三步就可以用手机或电视端的 Jellyfin 应用登录试播了。需要调 API 的话接口文档在http://服务器IP:8096/api-docs/swagger/index.html随服务一起提供。排查速查端口占用、媒体不识别、转码慢日常踩坑基本集中在这三件事上按「现象 / 原因 / 解法」对照处理现象原因解法启动报「地址已在使用」8096 端口被其他服务占用编辑config/network.xml更换端口后重启服务媒体文件扫描不到运行用户对媒体目录无读权限或文件不符合命名规范确认目录可读参考 Emby.Naming/TV/ 与 Emby.Naming/Video/ 下的解析规则播放时转码卡顿纯软件转码吃满 CPU安装专用jellyfin-ffmpeg并在管理界面「设置 播放 硬件加速」开启硬解端口相关的默认值可在 CreateNetworkConfiguration.cs 中查证HTTP 默认 8096HTTPS 默认 8920。再进一步备份、性能与安全数据备份用内置备份导出整个服务jellyfin --backup /path/to/backup.zip创建备份jellyfin --restore-archive /path/to/backup.zip恢复实现见 BackupService.cs。性能优化缓存目录放 SSD 可降低转码读盘压力公网访问建议加一层反向代理终结 HTTPS。安全加固默认只在局域网放行远程访问走反向代理并收紧端口暴露定期检查磁盘与内存占用。按需扩展想要更完整的电影海报与简介可在管理界面安装元数据插件如上图的 OMdb首次启动后按需启用即可。写在最后给不出「唯一最优解」只想尽快用起来选安装包NAS 或多服务环境选容器化要改代码才走源码编译先装 .NET SDK 与 ffmpeg再执行dotnet build后运行Jellyfin.Server/bin/Debug/net9.0下的jellyfin可执行文件。无论选哪条路都建议先挂一个小型媒体目录试跑几天确认权限、转码、备份都符合预期再正式投入使用。【免费下载链接】jellyfinThe Free Software Media System - Server Backend API项目地址: https://gitcode.com/GitHub_Trending/je/jellyfin创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考