服务器与建库

云映连接 Emby:登录服务器并选择自己的媒体库

从 Emby 提供的服务器地址与用户权限出发,在云映中登录、浏览媒体库、检查电影详情和播放结果,区分服务器账号与文件共享账号。

Emby 已经负责整理海报、影片信息和用户权限时,云映可以作为观看入口连接它。这里与 SMB 的思路不同:你登录的是媒体服务器用户,看到的是服务器提供的媒体库,而不是直接浏览 NAS 的所有共享。本篇先验证一个已有媒体库,再检查电影详情、实际播放与用户可见范围。

从 Emby 获取正确的连接信息

先在 Emby 自身的网页或客户端中确认服务器正常运行,并使用准备给云映的同一个用户登录。记录服务器地址、端口和连接协议,不要只记录 NAS 管理后台地址。Emby 官方建议从服务器控制台查看局域网访问地址,也可以在同一网络的另一设备浏览器中验证可达性。连接说明

教程示例可使用主机 192.168.1.30、端口 8096,但它们不是所有安装的固定值。若管理员提供 HTTPS 地址或自定义端口,以实际配置为准。准备一部已在 Emby 中正常显示且可播放的影片,最好时长与文件位置都容易核对,避免首次就用多个版本混在一起的大合集。

添加媒体服务器而不是文件源

打开云映“来源”,选择添加媒体服务器,再选择 Emby。名称可以写“家中 Emby”,服务器地址与端口按准备的信息填写,HTTPS 选项与实际服务一致。不要把电影文件路径、浏览器里的详情页或带大量查询参数的链接填进主机框。需要的是服务器入口,不是某一部影片的网页地址。

用户名与密码使用 Emby 用户信息,它可能与 NAS 的 SMB 账号不同,也不一定是管理后台账号。先用普通观看用户完成测试即可。若服务由他人管理,向管理员确认分配的账号和库范围,不要尝试把自己的其他网站密码填进去。来源名称只是本机识别用,不会改变服务器名称。

登录后先核对用户能看到什么

测试并保存成功后,进入该服务器的媒体库列表,比较名称与 Emby 原客户端是否一致。比如这个用户应看到“电影”和“家庭视频”,就先确认这两项存在,不要因为管理员账号还能看到“工作素材”就认为云映漏库。媒体库可见性由当前用户权限决定,客户端不能自动越过限制。

打开其中一个小库,检查几张海报与标题。服务器端已经提供的电影信息,应先在服务器端核对;不要直接套用文件源扫描的方式重新匹配一遍。如果库完全为空,先用同账号回 Emby 原入口查看,区分“用户本来没有权限”和“云映未获取到列表”两种情况。

用详情页确认不是同名条目

选择一部影片,核对年份、时长、简介和版本线索。同名电影、重制版或不同剪辑版可能共用相似封面,不能只看海报颜色就直接播放。若服务器本身的详情已经错误,应先在 Emby 中修正,云映显示的内容可能需要刷新后才更新。

个人家庭视频不一定有电影资料,保留文件名或服务器自定义标题也能正常浏览。电影资料与文件实际内容要分别判断。关于同名和年份的整理,可进一步看电影命名与匹配,但不要把该篇的文件源处理步骤直接当成服务器端管理按钮。

播放时检查服务器与客户端两端

打开已确认的影片,先看一小段,再跳到中间,检查声音与字幕。能看到海报只说明媒体信息接口可用,实际视频可能经过不同的数据路径,仍需要单独验证。若列表正常但视频打不开,先在 Emby 原客户端播放同一条目,确认服务器能读到媒体文件。

如果原客户端正常而云映异常,记录影片名称、文件容器、音视频信息以及具体失败阶段。服务器可能根据客户端能力提供不同播放方式,不能把一个客户端正常直接推断为其他客户端必然相同。不要在不了解原因时一口气更改转码、网络与字幕设置,先保持同一文件做对照。

区分家中连接与外出连接

局域网地址在家中有效,不代表在移动网络下同样可达。外出前应使用管理员已配置好的远程入口,并确认当前用户允许远程访问。可以给两个入口不同名称,避免误把家中地址用于外网。不要为了首次测试就自行开放服务器端口或关闭认证,本篇的范围是连接已有可用服务。

回到家后若远程地址仍然较慢,可以比较局域网来源,但先确认它们连接的是同一服务器和同一用户。观看进度是否一致,应通过实际退出重开核对,不把多个客户端之间的即时同步当成无条件保证。需要分析等待与缓冲时,可看网络卡顿排查。

常见失败与完成标准

登录成功却没有媒体库,是否需要重新扫描 NAS? 先不要。Emby 的库由服务器管理,登录用户可能没有获准访问,或服务器自身尚未完成整理。用同账号在原入口核对最直接;只有服务器端确认库存在,才继续排查客户端获取列表。

完整网址能打开,为什么添加失败? 完整网址可能包含网页界面路径、反向代理子路径或登录页面参数,当前表单不一定能按浏览器方式处理。向管理员索取适合客户端的直接服务地址;如果服务器通过带子路径的反向代理访问,需要单独检查客户端能否连接。

完成后应能用同一账号看到预期库、确认一部影片详情、播放并跳转成功,再返回服务器列表重新进入。把服务器名称与可用网络记清楚,后续增加其他服务时就不会把文件源、媒体服务器和用户权限混在一起。

资料来源与版本

依据云映官方商店页面公开的 Emby 支持、现有连接入口和上述 Emby 官方连接文档整理。2026 年 10 月 23 日核对云映公开版本为 1.1.0;服务器版本、代理路径与用户权限会影响结果,界面可能随版本变化。