# 云映连接 Jellyfin：从服务器首页找到电影与剧集

语言：zh-CN
原文：[云映连接 Jellyfin：从服务器首页找到电影与剧集](<https://allluckly.cn/guides/icouldplay-jellyfin-library/>)
中文：[中文 HTML](<https://allluckly.cn/guides/icouldplay-jellyfin-library/>)
English: [English HTML](<https://allluckly.cn/en/guides/icouldplay-jellyfin-library/>)
发布于: 2026-10-23T00:00:00+08:00
内容更新于: 2026-10-23T00:00:00+08:00
署名：Bison

在云映中连接已有 Jellyfin 服务，核对实际端口、用户库范围与季度集数，分清空列表、资料缺失和视频播放失败。

Jellyfin 把电影、剧集和用户观看状态组织在服务器里，云映连接后主要负责浏览与播放。本篇以一个电影库和一个剧集库为例，先确认服务地址，再从库进入季度与单集，避免把“电视剧总条目”“某一季”和“具体视频文件”当成同一层内容。

## 在同一网络里建立连接基线

先使用 Jellyfin 自身的网页入口确认服务器运行正常。记录手机当前能访问的地址与端口，尤其注意容器安装时对外端口可能与内部默认端口不同。Jellyfin 官方文档列出的默认 HTTP 端口是 8096，HTTPS 端口是否启用取决于配置；实际连接应以自己的服务为准。[网络说明](<https://jellyfin.org/docs/general/post-install/networking/>)

准备一个已经能播放的电影条目，以及一个至少有两集的剧集条目。使用计划给云映的普通用户登录原入口，确认这两个库都可见。不要用管理员账号验证完后，再换一个没有库权限的账号添加云映，否则空列表的原因会被混淆。

## 在云映选择 Jellyfin 类型

进入“来源”，添加媒体服务器并选择 Jellyfin。填写便于识别的名称、服务器主机、端口、用户名和密码，HTTPS 选项保持与服务一致。例如主机为 `192.168.1.40`、端口为 `8096` 只是局域网示例，不能直接复制到自己的环境。若服务使用域名，确认手机当前网络能够解析该域名。

服务器地址应指向服务入口，而不是浏览器里的某部影片详情页。某些安装把 Jellyfin 放在反向代理子路径下，这与直接主机加端口不同；若当前表单不能正确处理，应向管理员索取兼容的客户端入口，不要随意删掉路径后宣称原服务已连接。保存成功后再继续验证列表。

## 先从媒体库名称确认范围

打开添加的 Jellyfin 来源，查看电影库与剧集库是否分别存在。库名称来自服务器管理，可能叫“电影”“电视剧”，也可能是自己定义的其他名字。不要要求它们与教程一字不差，重点是内容与权限相符。若只出现一个库，先回原入口用同账号核对，而不是直接新建重复来源。

进入电影库，找准备好的样本，核对标题、年份和时长。封面未加载与列表完全为空是两种问题：前者可能仍能进入详情与播放，后者需要先确认库请求或权限。把错误现象描述清楚，后续排查才能避免把图片加载问题当成整个服务器离线。

## 剧集按系列、季度、单集逐层检查

进入剧集库后，先打开系列总条目，再选择季度，最后选具体一集。记录第一季第二集的标题或时长，确认实际打开的是预期内容。只有系列海报出现，并不能证明所有季和集都整理完整；服务器端命名、扫描与匹配结果会影响层级。

若某季缺集，先在 Jellyfin 原入口看同一季，再核对服务器文件与扫描结果。云映不是通过重新命名客户端卡片就能补出服务器没识别的集数。需要整理文件命名时可看[剧集命名与集数核对](<https://allluckly.cn/guides/icouldplay-episode-naming/>)，但服务器端变更应在自己有管理权限的环境中进行。

## 播放样本并观察返回位置

先播放电影样本，再播放一集电视剧，各检查开头和中间跳转。返回时观察是否回到该季或系列页面，避免把下一次打开另一个来源的同名条目误认为进度丢失。观看状态涉及客户端与服务器的数据交换，先用一个样本检查其他设备能否读到更新，以及需要等待多久。

若字幕或音轨出现差异，先确认两边打开的是同一媒体版本。服务器可能为同一影片保留多个文件，封面相同不代表容器、音轨和字幕一致。可继续看[外挂字幕核对](<https://allluckly.cn/guides/icouldplay-external-subtitles/>)，把字幕匹配问题与服务器连接分开处理。

## 把元数据问题与网络问题分开

Jellyfin 可以在局域网中独立运行，但海报和资料的获取可能依赖外部提供方。若影片能播放、资料不完整，先检查服务器自己的元数据状态，不要重复修改云映账号。相反，如果资料齐全但播放失败，应检查媒体文件是否可读、实际播放路径是否可达，以及当前客户端对片源的兼容情况。

远程访问还受服务与用户权限限制。家中局域网正常后，再使用管理员已经配置的远程入口测试同一文件；不要同时换网络、换用户和换影片。只改变一个条件，能更清楚知道是地址范围、账号权限还是文件读取造成变化。

## 常见问题与最终核对

**为什么填默认端口仍然连不上？** 默认值不是部署事实。容器映射、反向代理或自定义配置可能改变手机实际访问的端口。以同一手机浏览器能访问的服务入口为线索，再确认它是否适合客户端，不要反复在几个常见端口之间盲猜。

**电影正常，剧集只有一张海报怎么办？** 先检查进入的是否系列总条目，再寻找季与集的层级。若原 Jellyfin 也没有正确分集，应先修服务器整理；若原入口正常而云映缺少层级，记录具体系列、季数与版本，保留兼容性问题，而不是复制同一视频多次制造条目。

完成标准是电影库和剧集库范围正确，一部电影与一集电视剧都能进入详情、播放和跳转，返回后还能找到同一条目。把库名称、用户和可用地址记清楚，再逐步扩展到其他内容，比一次接入所有家庭账户更容易保持秩序。

## 资料来源与版本

依据[云映官方 App Store 说明](<https://apps.apple.com/cn/app/id6755653178>)、现有 Jellyfin 入口及 Jellyfin 官方网络文档整理，2026 年 10 月 23 日核对云映公开版本 1.1.0。媒体库层级与权限由服务器配置影响，界面可能随版本变化。