VPS 上的视频播不出来,先查 8096 端口通没通,这是 Jellyfin 网页和客户端默认走的那个口。端口通、页面还是打不开,再看文件本身和播放器。文件放上去了,不等于客户端能拿到一个它认的播放出口。
做英文站的人把视频放 VPS 上,无非两种用法:站内页面挂几段演示,或者给自己和客户看片库。前者卡在浏览器认不认格式,后者卡在转码和出网带宽。绕来绕去,播放这件事最后都落到一个选择上:文件托管,还是媒体服务器。猎者出海这边做站,视频这块也是这么分的。
Jellyfin 官方源和 Docker Hub 在国内能不能直接访问,我这里不当结论。机器本身怎么选,先看VPS的基础概念和选购顺序;基础的服务器和播放页配置,按视频播放服务器搭建的顺序走。
- 两条路线:文件托管加网页播放,或者 Jellyfin 这类媒体服务器。
- Jellyfin 官方容器镜像叫 jellyfin/jellyfin,映射 8096/tcp 和 7359/udp 两个端口,7359 的 UDP 用于自动发现。
- 播不了按格式与编码、端口与反代、转码性能、带宽与流量、客户端五层往下查,先别换 VPS。
- 在 Windows 或 macOS 宿主机上跑 Jellyfin 容器不受支持,硬件加速转码会坏。
- 不讨论片源获取,只讲自建和合规托管。
下面把两条路线怎么选、每步怎么配、播不了先查哪一层讲清楚。
本文目录
播放vps上的视频,先分清两条路线:文件托管还是媒体服务器
两条路线的差别不在视频文件本身,在谁来负责把文件变成客户端能播的流。文件托管是把视频当普通文件挂出去,媒体服务器多一层管理、刮削和转码。

路线一:文件托管加网页播放
把视频放上 VPS,用 nginx 这类 HTTP 服务器直接对外提供。nginx 是 HTTP Web 服务器、反向代理、内容缓存、负载均衡器,支持 FLV 和 MP4 流式传输。适合文件不多、格式统一、只给自己或少数人看。
这条路线的动作少:文件传上去,目录配成能通过 http 访问,客户端拿到直链就能播。页面里的播放器能不能解码,是另一件事。
路线二:Jellyfin 这类媒体服务器
Jellyfin 是自由软件媒体系统,用来收集、管理、串流自己的媒体,是 Emby 和 Plex 的替代品。它有大量官方客户端和外部客户端,覆盖多数主流平台。Jellyfin 没有跟踪、没有回传、没有收集数据的中心服务器,媒体库放在自己的机器上。
两条路线怎么选
要刮削、多端、多用户、转码,选媒体服务器。只是把几个 MP4 挂出去给人点开看,文件托管更省事。文件托管路线对出网带宽更敏感,机器选大带宽美国VPS这类配置,播放时不容易卡。
路线一走法:把视频放上 VPS,用 Web 服务器播出来
这条路线不用装媒体服务器,四步能跑通。先处理文件,再让 Web 服务器把目录提供出去,最后确认客户端拿到的是直链。
动作一,确认文件是浏览器认的容器与编码。先把视频转成 MP4 容器加 H.264 视频编码,这是浏览器兼容面最宽的组合。HEVC 等编码网页播放器不一定支持,转码前先看源文件是什么编码。
浏览器网页播放器能不能播,取决于浏览器自己的解码能力,H.264、VP8、VP9、AV1、MP3、AAC 这些常见编码可以直接播。
动作二,用 nginx 把目录对外提供。Linux 上可以用 nginx.org 的软件包安装。装完确认目录能通过 http 访问,再谈播放页。
动作三,确认给客户端的是直链。地址要以 http 或 https 开头,页面链接或带防盗链的地址播不了。解析出来的直链如果带时效签名,过几个小时会失效,播放列表里存着也没用,先下载到本地更稳。
动作四,跨域受限时先把文件下载到本地再播。浏览器有同源策略,网页里直接拉另一个域名的视频地址会被拦住,这不是文件坏了。
出问题怎么回查:先用 VLC 打开同一个文件。VLC 能播放大多数格式,不用装编解码包。能播,说明文件没问题,问题在服务端或浏览器;不能播,说明文件本身或编码有问题。库大了先看盘,视频文件占空间,机器用大硬盘海外VPS更省得来回删。
路线二走法:在 VPS 上用 Docker 跑 Jellyfin,把库挂进去
Jellyfin 官方容器镜像叫 jellyfin/jellyfin,基于 Debian,直接从源码构建,latest 标签跟踪最新稳定版。下面按拉镜像、建持久化存储、开端口、挂渲染设备、起容器五步走。
第一步,拉镜像。
docker pull jellyfin/jellyfin
正常输出会显示下载层和完成状态。卡住不动,先看这台机器能不能正常访问镜像仓库。
第二步,为配置和缓存建持久化存储。简单部署用 bind mount 比 volume 省事,把宿主机目录挂进容器。媒体库可以挂多个,第二个库设成只读,避免误删。
docker run -d --name jellyfin -p 8096:8096/tcp -p 7359:7359/udp -v /opt/jellyfin/config:/config -v /opt/jellyfin/cache:/cache -v /data/media:/media jellyfin/jellyfin
宿主机路径换成你自己的,容器内 /config、/cache、/media 是镜像默认位置。第二个媒体库可以设成只读,按 Jellyfin 的示例加 --mount type=bind,source=/path/to/media2,target=/media2,readonly。
第三步,端口只开 8096/tcp 和 7359/udp。7359 的 UDP 用于自动发现。用 rootless Podman 时端口不会自动放行,要手动开防火墙。firewalld 的机器执行:
sudo firewall-cmd --add-port=8096/tcp --permanent
sudo firewall-cmd --add-port=7359/udp --permanent
sudo firewall-cmd --reload
第四步,要用硬件加速,得让容器访问渲染设备,挂载 /dev/dri/。container-selinux 2.226 及以后版本要设 container_use_dri_devices 标志,否则容器用不了渲染设备。
第五步,用 Docker Compose 时,在 docker-compose.yml 同目录执行:
docker compose up -d
加 -d 是后台运行。
出问题怎么回查:容器起了但打不开,先查端口有没有放行,再查反代。DLNA 要用必须加 --net=host,不加时 Docker 默认走 bridge。机器放在境外、人在大陆看,起播快慢还跟线路有关,新加坡VPS到大陆延迟这类信息选机器时先看。
播不了先查这五层,顺序别乱
播不了不要一上来就换 VPS。按下面五层往下走,每层都有具体能看的点,落到哪一层就处理哪一层。
第一层:格式与编码
H.264 / AVC 10-bit(High 10 profile)的硬件解码不被任何 Intel、NVIDIA、AMD GPU 支持,只有 Apple Silicon 和 Rockchip 支持。没有硬解时 Jellyfin 会回退到软件解码。这类视频官方建议考虑升级到 H.265 / HEVC 10-bit(Main 10 profile)。
怎么回查:把文件拉到本地,用 VLC 打开。能播,说明文件没坏,问题在服务端或浏览器;不能播,先转码再传。
第二层:端口与反代
8096/tcp 没放行、反代 server_name 配错,都会打不开。nginx 的正则 server name 含 { 和 } 没加引号,启动会失败,报 directive "server_name" is not terminated by ";"。server name 过多,会报 could not build the server_names_hash,先把 server_names_hash_max_size 设到接近 server name 数量,不行再调 bucket size。
怎么回查:看 nginx 启动时的报错原文,按报错里的参数名改,不要凭感觉改。
第三层:转码性能
用别处下载的 FFmpeg 二进制,只会得到部分加速。部分加速可能导致 CPU 占用更高、转码速度更低。Jellyfin 推荐用带 -Jellyfin 后缀的 jellyfin-ffmpeg。同时会话数是软限制,跑更多会让每个会话的转码性能下降,直到视频开始卡顿。
怎么回查:在网页客户端播放并调低分辨率或码率触发转码,打开系统的进程监视器搜 ffmpeg,看 CPU 占用。占用几百个百分点,说明硬件加速没生效;GPU 使用率接近 0 是正常的。
第四层:带宽与流量
播放吃的是持续出网带宽,不是峰值。一个人看和三个人同时看,出网压力不一样。公开播放前先想清楚流量怎么算,超限是公开播放要先算清楚的一项。
怎么回查:看主机商面板的出网曲线,播放时是不是一直贴着上限走。
第五层:客户端
网页播放器推荐用 Chromium 内核浏览器。没声音先看音轨是不是被转码丢掉了,再看网页播放器的音量增强,最高能放大到 4 倍。手机端优先用 Jellyfin 官方客户端。
怎么回查:换一个客户端复现。网页不行换手机客户端,手机不行换另一个浏览器,能复现就不是客户端的问题。
选 VPS 看这六项:CPU、内存、带宽、流量、存储、线路
机器选错,后面每一步都在补窟窿。六项里先看要不要转码,再看带宽和流量,最后看存储和线路。
CPU:要不要转码决定 CPU 权重。有核显或独显走硬件加速,没有就靠 CPU 软解。核显和 APU 建议用双通道内存,核显占系统内存当显存,双通道能让显存带宽翻倍。
内存:媒体服务器常驻内存,转码还要缓存。Jellyfin 的建议是用 SSD 或 RamDisk 缓存转码临时分片,因为现代 GPU 上转码峰值吞吐可能受硬盘 I/O 限制。
带宽与流量:多数卖家的做法是按时段估并发观看人数乘码率,再留余量。流量超限是公开播放要先算清楚的一项,别等跑超了再补。
存储:视频文件占硬盘,库大了先看盘。线路:到观看者的延迟和丢包决定起播快慢,跨境观看优先看线路。公开播放还要看被打的风险,香港高防VPS这类机器适合这一类场景。
数字和限制:做这件事会用到的几个数
下面这几个数在排查和选机器时用得上,先列出来,后面不用反复翻文档。
| 项目 | 数值 / 门槛 | 用在哪 |
|---|---|---|
| Jellyfin 费用 | 服务器和官方客户端免费,没有明示或隐藏的费用 | 路线二成本判断 |
| 硬件加速验证 | ffmpeg 占用几百个百分点 CPU 即未生效;GPU 使用率接近 0 属正常 | 第三层排查 |
| Dolby Vision 转 SDR | Jellyfin 10.8 起支持,需 jellyfin-ffmpeg 5.0.1-5 或更新 | 片源兼容 |
| Apple Silicon 原生支持 | Jellyfin 10.9.0+ 与 jellyfin-ffmpeg6 6.0.1-5+ | macOS 部署 |
| SELinux 标志 | container-selinux 2.226 及以后要设 container_use_dri_devices | 硬件加速挂载 |
这些数里,跟日常排查最相关的是硬件加速验证那一条:CPU 占用几百个百分点,说明转码没走 GPU,先查 FFmpeg 和渲染设备挂载。
这五个坑踩了不报错,只会播不了
下面五条都是规则层面能避开的,踩了不会报错,只会播不了或者越转越卡。
第一个,在 Windows 或 macOS 宿主机上跑 Jellyfin 容器。Jellyfin 明确说这不支持,硬件加速转码会坏,非 Linux 平台跑容器不会得到任何支持。
第二个,用别处下载的 FFmpeg。只会得到部分加速,部分加速可能让 CPU 占用更高、转码速度更低,直接用带 -Jellyfin 后缀的 jellyfin-ffmpeg。
第三个,以为 GPU 使用率接近 0 就是没加速。Jellyfin 说这是正常的,判断加速有没有生效看 ffmpeg 的 CPU 占用。
第四个,以为 H.264 10-bit 能硬解。Intel、NVIDIA、AMD 的 GPU 都不支持,会回退软件解码,这类片源要考虑转成 H.265 10-bit。
第五个,以为正则 server name 更灵活就优先用。nginx 说正则顺序测试,是最慢且不可扩展的方式,能用精确名就用精确名。
最后一条跟内容有关:不讨论片源获取,只讲自建和合规托管。公开播放前先看主机商的内容条款,美国不限内容VPS这类机器的条款也要先看清楚再公开播放。
AI 能帮哪几步,哪几步必须你自己动手
AI 在这件事里适合做整理和对照,不适合替你在机器上做决定。下面三步能省时间,后面三件事必须自己动手。
第一步,把 Jellyfin 容器安装页的端口、挂载、用户参数整理成一份可对照的 docker run 和 docker-compose 清单,标出哪些是必填、哪些是可选项。第二步,按硬件加速页的厂商对照表,根据你的 GPU 型号和系统,给出该选 QSV、NVENC、AMF、VA-API 还是 VideoToolbox。第三步,把 nginx server_name 的匹配优先级和报错信息整理成按精确名、通配名、正则顺序的排查清单。
下面三条提示词是本文给的示例,不是官方模板。
「我在 Linux 上用 Docker 跑 Jellyfin,宿主机是 Debian,媒体放在 /data/media。请按 Jellyfin 官方容器安装页的写法,给我一份 docker run 命令和一份 docker-compose.yml,端口只开 8096/tcp 和 7359/udp,配置和缓存分别挂到 /opt/jellyfin/config 和 /opt/jellyfin/cache,并标出每一行对应官方页的哪一步。」
「我的 VPS 是 Intel 核显,系统是 Linux。请按 Jellyfin 硬件加速页的厂商对照表,告诉我该选 QSV 还是 VA-API,并列出启用前要做的准备步骤和验证方法。」
「我在 nginx 里配了 server_name 正则,启动报 could not build the server_names_hash。请按 nginx 官方 server_names 文档,列出可能的原因和按顺序该调哪几个参数。」
必须人做的三件事:
- 在 VPS 上执行 docker pull jellyfin/jellyfin,确认镜像拉取成功。
- 在 Jellyfin 面板 Playback 里勾选对应的硬件加速方式,并取消勾选本机不支持的编解码器。
- 在网页客户端播放并调低分辨率或码率触发转码,打开系统的进程监视器搜 ffmpeg,看 CPU 占用是否达到几百个百分点,据此决定硬件加速是否生效。
这三份清单整理完,可以让猎者出海的AI Agent按你站的栏目要求排成初稿骨架,省掉从零搭结构的时间。
常见问题
播放vps上的视频为什么没有声音?
先看音轨是不是在转码时被丢掉了。再看客户端音量是不是太小,有些网页播放器的音量增强最高能放大到 4 倍。两步都排完还没声音,换一个客户端复现。
播放vps上的视频是什么格式才能播?
浏览器兼容面最宽的是 MP4 容器加 H.264 视频编码,音频用 AAC。HEVC 这类编码要看浏览器和客户端支持,不一定能直接播。拿不准就先转成 MP4 再传。
用手机能播放 VPS 上的视频吗?
能。Jellyfin 有官方客户端,手机装上登录同一台服务器就能看。网页端在手机上也能开,但播放和解码能力跟手机浏览器有关,优先用官方客户端。
Jellyfin 要花钱吗?
不用花钱买授权。Jellyfin 服务器和官方客户端免费下载,没有明示或隐藏的费用。VPS 本身的费用按你选的厂商算。
播放vps上的视频教程为什么打不开?
先查 8096/tcp 有没有放行,再查反代的 server_name 有没有配错。容器起了但页面打不开,多半是这两步。DLNA 要用还得加 --net=host。
播放视频要多少流量?
按并发观看人数乘码率估,再留余量,具体数看片源码率和同时看的人数。流量超限是公开播放要先算清楚的一项,选机器时把月流量额度一起看。
把两条路线选一条,按五层顺序查,播不了的问题基本都能落到具体一层。机器不用急着换,先把播放出口和转码这两件事弄对。
排查记录攒多了,交给猎者出海的AI Agent整理成你站的固定清单,下次换机器照着走。

发表评论