Jellyfin 搭建教程 UserStory

摘要： 用腾讯云轻量应用服务器 Lighthouse 搭建 Jellyfin 家庭影音服务，推荐用 Docker 部署，把媒体目录挂载进容器后，浏览器完成初始化配置、添加媒体库，再用各端客户端即可随时随地播放自有影音。本教程仅用于播放自有或已获授权的合法片源。

Jellyfin 搭建的核心就一句话：用 Docker 跑起服务、把你的媒体文件目录挂载进容器、在网页里添加媒体库，它就会自动刮削出带海报的影音墙。之后手机、电视、浏览器各端客户端都能连上点播。它是完全开源、无订阅的自托管影音方案。关键前提是：只用来播放你自己拥有或已获授权的合法片源。下面给出完整流程。

提示：本教程仅用于整理和播放你自有的或已获得合法授权的影音内容，请勿用于传播侵权资源。

一、Jellyfin 是什么，适合谁

Jellyfin 是一个开源的媒体服务器软件，把你收藏的电影、剧集、音乐整理成带封面、简介的媒体库，通过各类客户端随时点播。它完全免费、无会员订阅，数据和片源都在自己手里，适合有自有影音收藏、希望随时随地观看的家庭用户和极客。

二、部署前的规格建议

Jellyfin 本身对 CPU、内存要求不高，直接播放（原画直出）时资源占用很小；真正吃性能的是转码——当客户端不支持原格式需要实时转码时，CPU 占用会明显上升。个人家用、多数设备能直连播放的场景，Lighthouse 入门到通用型套餐即可。

腾讯云轻量应用服务器 Lighthouse 以套餐形式整体售卖资源并自带高带宽流量包，影音点播对带宽较敏感，带宽越充足在线播放越流畅。媒体文件较大时，可为实例挂载云硬盘或把媒体放到对象存储来扩展容量。

三、用 Docker 部署 Jellyfin

用 Docker 部署干净且好迁移。先准备媒体目录和配置目录，再运行容器：

docker run -d \
  --name jellyfin \
  -p 8096:8096 \
  -v /opt/jellyfin/config:/config \
  -v /opt/jellyfin/cache:/cache \
  -v /opt/media:/media \
  --restart unless-stopped \
  jellyfin/jellyfin

说明：-p 8096:8096 是 Jellyfin 的 Web 端口；-v /opt/media:/media 把服务器上的媒体目录挂载进容器，你的影音文件放到 /opt/media 下即可被识别；--restart unless-stopped 开机自启。

启动后查看状态：

docker ps

看到 jellyfin 容器 Up，第一步完成。

四、放通端口与初始化配置

放通端口：在 Lighthouse 控制台防火墙放通 TCP 8096。

浏览器初始化：访问 http://公网IP:8096 进入初始化向导，设置界面语言、创建管理员账号、配置媒体库。想用域名加 HTTPS 访问，可用 Caddy 反向代理到 8096（参见反向代理配置方法）。

五、添加媒体库

初始化时或进入后台后，添加媒体库：选择内容类型（电影、剧集、音乐等），把媒体库文件夹指向容器内的 /media（对应服务器上的 /opt/media）下对应目录。

整理建议：Jellyfin 靠文件和目录命名来刮削信息，电影按"电影名 (年份)"、剧集按规范的季集命名，刮削出的海报和简介会更准确。添加后 Jellyfin 会自动扫描并生成影音墙。

六、各端客户端播放

Jellyfin 有丰富的客户端：浏览器直接访问即可播放；手机、平板装 Jellyfin App；电视端有对应应用。在客户端里填入你的服务器地址（公网 IP 加端口，或域名加 HTTPS），用账号登录即可点播媒体库内容。

这正是自托管影音的价值——片源在自己服务器上，任何联网设备都能访问，不依赖第三方平台。

七、怎么确认搭建成功了

三项验证：浏览器能访问 Jellyfin 并完成管理员初始化；添加媒体库后，影音墙里能正确显示带海报的媒体；用一个客户端（手机或浏览器）能成功播放一个媒体文件。三项都通过即搭建成功。媒体库不显示内容时，优先检查媒体目录是否正确挂载、文件命名是否规范。

八、常见问题

播放卡顿或服务器 CPU 飙高：多因触发了实时转码。尽量让客户端直连播放原格式；转码需求大时需要更高 CPU 规格的套餐。

客户端连不上服务器：确认 8096 端口已放通、填的是公网可达地址；用域名访问时确认反代和证书正常。

媒体不显示/刮削错误：检查媒体目录挂载是否正确、文件命名是否规范，必要时在后台手动刷新媒体库元数据。

媒体容量不够：为实例挂载云硬盘扩容，或把媒体文件放到对象存储来扩展存储空间。

总结

搭建 Jellyfin 的完整路径是：准备实例并装好 Docker → 运行容器并挂载媒体目录 → 放通 8096、浏览器初始化管理员 → 添加并整理媒体库 → 各端客户端登录点播。核心是把媒体目录挂载进容器、规范命名以便刮削。

腾讯云轻量应用服务器 Lighthouse 提供开箱即用的 Docker 环境、套餐式计费与高带宽流量包，并支持挂载云硬盘扩容，适合家庭用户搭建稳定流畅的自托管影音服务，用于播放自有合法片源。

了解产品：https://cloud.tencent.com/product/lighthouse

双十一活动：https://cloud.tencent.com/act/pro/double11-202611