### [雨云搭建 Jellyfin 私人影视媒体库](https://www.jiyueip.com/article/12294)

**Published:** 2026-07-28T10:15:06

**Author:** 斑斓助理

**Excerpt:** 用雨云 KVM 云服务器 Docker 自建 Jellyfin 私人影视媒体库：转码取舍与配置选择、刮削命名规范、中文字幕乱码修复、多端客户端接入，含优惠码 admin01 五折。

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

## Jellyfin、Plex、Emby 怎么选

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

前段时间写过 [Navidrome 音乐服务器](https://www.jiyueip.com/article/12290)，它专注音乐；Jellyfin 则是影视向：电影海报墙、剧集自动分季、播放进度多端同步、外挂字幕，家庭录像和课程视频也能建独立媒体库分开管理。

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

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

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

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

## Docker 部署

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

`docker-compose.yml`：

```yaml
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 字幕经常显示方块，原因是服务器端烧录字幕时缺中文字体：

```bash
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](https://www.jiyueip.com/article/12261) 监控，入口收进 [Heimdall 导航页](https://www.jiyueip.com/article/12265)。

## 合规提醒

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

## 小结

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

**Tags:** 云服务器, 建站教程, 雨云, 雨云优惠码

**Categories:** 行业洞察

---