雨云搭建 Jellyfin 私人影视媒体库

用雨云 KVM 云服务器 Docker 自建 Jellyfin,全功能免费的私人影视库:海报墙、多端串流、进度同步
发布于 更新于
10

硬盘里囤了多年的家庭录像、自己购买的蓝光原盘备份、课程视频,散在各处不好管理,想在电视和手机上看还得来回拷贝。Jellyfin 是完全免费开源的媒体服务器,能把这些视频整理成带海报墙的私人影视库,多端串流观看。本文用雨云 KVM 云服务器部署 Jellyfin,讲清楚转码取舍、字幕字体、客户端接入这些实际问题。

Jellyfin、Plex、Emby 怎么选

三者定位相同,区别在授权模式:Plex 和 Emby 核心功能免费但硬件转码、多用户等要买 Pass/Premiere 订阅;Jellyfin 是社区驱动的完全开源项目,所有功能免费,没有账号绑定,数据完全留在自己服务器上。对自建党来说,Jellyfin 是最省心的选择——不用担心某天功能被挪进付费墙。

前段时间写过 Navidrome 音乐服务器,它专注音乐;Jellyfin 则是影视向:电影海报墙、剧集自动分季、播放进度多端同步、外挂字幕,家庭录像和课程视频也能建独立媒体库分开管理。

服务器配置怎么选:转码是关键

视频服务器最大的变量是转码。播放设备直接支持视频编码时走「直接播放」,几乎不吃 CPU;设备不支持(老电视、网页播放 HEVC)就要服务器实时转码,纯 CPU 软转 1080p H.264 至少要 4 核。

务实的策略是:尽量避免转码。客户端选支持硬解的(手机/电视端基本都支持 H.264/HEVC 直连),视频入库前统一转成兼容性好的格式,服务器就可以用低配。按这个思路,雨云 KVM 2 核 2G 配大数据盘即可起步(雨云官网入口),偶尔转码再升 4 核。下单优惠码填 admin01 五折,7 天无理由退款,先低配试跑不亏。选购思路见 雨云 VPS 选购与上手指南

带宽方面:1080p 高码率片源直连播放需要 10-20Mbps,注意选带宽给得足的套餐,或播放时选择转低码率。

Docker 部署

mkdir -p /opt/jellyfin/{config,cache,media} && cd /opt/jellyfin

docker-compose.yml

services:
  jellyfin:
    image: jellyfin/jellyfin:latest
    container_name: jellyfin
    restart: unless-stopped
    ports:
      - "127.0.0.1:8096:8096"
    volumes:
      - ./config:/config
      - ./cache:/cache
      - ./media:/media:ro
    environment:
      - TZ=Asia/Shanghai

媒体目录只读挂载,Jellyfin 只负责读和放,不会动源文件。启动后通过 Nginx 反代 8096 端口并配 HTTPS(注意反代配置里加上 WebSocket 支持:proxy_set_header Upgrade $http_upgrade;proxy_set_header Connection "upgrade";,否则播放状态同步会异常)。

首次访问进入设置向导:创建管理员、添加媒体库(电影/剧集/家庭录像分开建库)、元数据语言选中文。

文件命名规范:刮削成败的关键

Jellyfin 靠文件名匹配元数据(海报、简介、演员表),命名不规范就刮不出海报墙:

media/
├── 电影/
│   └── 流浪地球 (2019)/
│       └── 流浪地球 (2019).mkv
├── 剧集/
│   └── 某剧集 (2023)/
│       └── Season 01/
│           ├── S01E01.mkv
│           └── S01E02.mkv

要点:电影文件夹和文件名带年份;剧集按 Season XX/SXXEXX 组织。家庭录像库不需要刮削,建库时类型选「家庭视频」即可按文件夹浏览。

中文字幕乱码修复

网页端播放时外挂 ASS 字幕经常显示方块,原因是服务器端烧录字幕时缺中文字体:

mkdir -p /opt/jellyfin/config/fonts
# 上传一个中文字体,如思源黑体 SourceHanSansSC-Regular.otf 到该目录

然后在 Jellyfin 控制台「播放 → 转码」里把「备用字体文件路径」指向 /config/fonts,勾选启用备用字体,乱码即消失。这是 Jellyfin 中文用户必踩的一坑。

客户端接入

  • 电视/盒子:Jellyfin 官方 Android TV 版,或 Kodi 加 Jellyfin 插件。
  • 手机:iOS/Android 官方客户端,另有第三方 Swiftfin(iOS)体验更好。
  • 电脑:网页端即可,或 Jellyfin Media Player 桌面版支持更多解码。

所有客户端填服务器域名 + 账号密码即连,播放进度全端同步。服务状态照例挂进 Uptime Kuma 监控,入口收进 Heimdall 导航页

合规提醒

自建媒体库仅限存放自己合法购买、自行拍摄或已获授权的影音内容。依据《网络安全法》《著作权法》及相关规定,不得存储、传播盗版影视资源,不得向不特定公众提供未授权作品的在线播放。建议关闭公开注册,仅向家庭成员开放账号,并为服务配置强密码与 HTTPS。

小结

Jellyfin 全功能免费开源,把散落的合法影音资产整理成体面的私人影视库。部署的核心心得是三条:尽量避免转码以降低配置需求、文件命名规范决定刮削质量、中文字体解决字幕乱码。雨云 KVM 2 核 2G 配数据盘起步,优惠码 admin01 五折,家庭影音中心就这么搭起来了。

常见问题(FAQ)

Jellyfin 和 Plex、Emby 有什么区别?
三者功能定位相同,但 Plex/Emby 的硬件转码、多用户等要付费订阅,Jellyfin 完全开源免费、无账号绑定,所有功能不设付费墙,数据完全留在自己服务器上。
跑 Jellyfin 需要多高的服务器配置?
关键看转码:客户端硬解直连时 2核2G 足够;纯 CPU 软转 1080p 至少 4 核。务实做法是尽量避免转码——选支持硬解的客户端、入库前统一转成 H.264 等兼容格式。
中文字幕显示方块乱码怎么办?
服务器烧录 ASS 字幕时缺中文字体所致。把思源黑体等中文字体放入 /config/fonts,在控制台「播放→转码」设置备用字体路径并启用即可。
雨云优惠码 admin01 怎么用?
雨云下单页优惠码/推广码输入框填 admin01 即享五折,以结算页显示为准。媒体库建议选带大数据盘的 KVM 套餐,支持 7 天无理由退款,可先低配试跑。

本文由作者原创/授权发布于极跃圈(jiyueip.com)未经许可,禁止转载。题图来自Unsplash,基于CC0协议。

声明:极跃圈(JIYUEIP.com)内网友所发表的所有内容及言论仅代表其本人,并不反映任何极跃圈(JIYUEIP.com)之意见及观点。

0 讨论
热门最新
总结
暂无总结
0 / 600

用雨云 KVM 云服务器 Docker 部署 Wiki.js + PostgreSQL,搭一个自己托管的私有知识库,文档可接 Git 后端自动备份。含内存调优、反代 HTTPS 与优惠码 admin01 五折。

用雨云 KVM 云服务器 Docker 自建 Cloudreve 网盘:对象存储直传、外链分享、离线下载,轻量可替代 Nextcloud,含优惠码 admin01 五折。

用雨云 KVM 云服务器 Docker 自建 Navidrome 私人音乐服务器:曲库标签整理、移动端转码省流量、Subsonic 客户端接入全流程,含扫描权限坑与优惠码 admin01 五折。