常见问题

📚目录（点击可跳转）#

1. 播放卡顿
2. Emby 登录问题自助指南
3. 搜索问题
4. 资源问题
5. 播放提示“没有兼容的流”
6. 其他

1.🌀播放卡顿#

播放卡顿是比较常见的问题。排查时，可以先关注两个主要因素：

1. 服务器的性能以及负载
2. 用户访问 Emby 服务器的网络线路

当服务器运行正常、没有受到攻击且网络负载不高时，访问线路通常是影响播放体验的主要因素。

对于直连不稳定的情况，建议尝试通过代理访问。国内的网络环境差异较大，服务器提供的线路未必适合所有用户，高峰时段也可能影响连接质量。

使用代理可以增加线路选择的灵活性。有多个可用节点时，可以根据实际播放效果切换，但代理本身也可能出现波动。

此外，视频码率也会影响播放流畅度。Emby 服收录的资源不设码率上限，包含较多 4K 和高码率内容。5 Mbps 与 20 Mbps 的视频对网络的要求不同，播放高码率内容前，请确认可用带宽能够满足需求。

如果播放仍不流畅，可以按下面的顺序排查：

• 先查看服务器负载是否正常。如发现异常，可以向服主反馈。
• 如果服务器负载正常，建议测试不同线路和节点。节点测速或 YouTube 播放速度不一定能反映访问 Emby 的效果，价格较高的代理服务也可能波动。请以实际播放体验为准，灵活切换线路。

🔧 Emby 登录问题自助指南#

遇到 Emby 无法连接、登录失败或错误提示时，可以先对照下面的错误代码，初步判断问题所在。

不同客户端、反向代理和 Cloudflare 环境显示的提示可能略有差异，错误代码只能作为初步判断的依据。如果没有显示代码，可以直接从后面的快速排查步骤开始。

快速错误代码表

错误代码	优先检查
400、404	服务器地址、路径与最新线路
401	账号、密码与旧 Token
403	账号权限、IP 与安全规则
405、501	客户端兼容性与代理配置
408	请求超时与网络质量
410	失效资源、旧地址与客户端记录
429、1015	请求频率；停止重试后等待
500、503	服务端异常、维护与负载
502、504	代理与上游 Emby 服务
520～524	Cloudflare 与源站响应或连接
525、526	源站 HTTPS / TLS 与证书
530、1000、1001、1016	完整 Cloudflare 错误与 DNS 配置
1020 / Access Denied	Cloudflare 访问规则

📱 客户端 / HTTP 4xx 错误#

400 Bad Request｜请求格式错误

可能是服务器地址或 URL 格式异常、客户端请求参数错误，也可能是反向代理改写了请求。

检查服务器地址是否完整，例如 https://example.com，并确认没有多余空格、错误路径或重复的 http / https 前缀。只有服主明确提供端口或子路径时才需要填写。地址确认无误后，完全退出 Emby App，再重新打开。

401 Unauthorized｜登录认证失败

请求缺少有效凭证。常见原因包括用户名或密码错误、Token 失效、客户端保存旧凭证，或服务端重置过密码。

重新手动输入当前账号和密码，不要依赖旧登录信息。仍然报错时，删除客户端中保存的服务器后重新添加。忘记密码时，使用服主提供的 Bot 或重置渠道。

403 Forbidden｜拒绝访问

可能涉及账号禁用、IP 封禁、资源权限、反向代理访问限制，或 Cloudflare WAF / 安全规则拦截。

先用浏览器打开服务器地址。如果网页本身也出现 403，通常不只是 Emby App 的问题。账号被停用时联系服主确认；持续显示安全拦截时，记录完整提示供服主排查。

404 Not Found｜地址或资源不存在

常见于地址或域名拼写错误、旧线路失效、请求路径不存在，或反向代理路径配置错误。

通过服务器公告或 Bot 获取最新地址。不要自行追加接口路径；如果正确首页能打开、只有部分功能出现 404，向服主说明具体操作。

405 Method Not Allowed｜请求方式不被允许

当前资源不接受客户端使用的 HTTP 请求方法。可能是客户端与服务端不兼容、Nginx 规则异常，或 Cloudflare Worker 错误改写请求方式。

可以尝试重新添加服务器，确认客户端版本是否适配。多个用户同时出现时，由管理员检查反向代理及请求方法。

408 Request Timeout｜请求超时

HTTP 标准含义是服务端未在等待期限内收到完整请求。客户端单纯显示“连接超时”时，不一定真的收到了 HTTP 408。

网络不稳定、跨境线路质量差或服务繁忙都可能影响请求。切换 Wi-Fi / 手机流量重新测试；多人同时出现时，交由服主检查服务器和线路。

410 Gone｜资源已不可用 / 旧服务器记录排查

HTTP 410 表示源站上的目标资源已不可用，而且这种状态很可能是永久的。

在部分 Emby 或第三方客户端、特定服务环境中，410 类提示也可能伴随旧地址或本地服务器记录异常。本站用户可先彻底删除客户端中保存的该服务器，再使用最新地址重新添加。

删除并重新添加服务器只是排查方法，并非 Emby 官方对 410 的固定定义。如果重新添加后仍然报错，请联系服主，确认资源或线路是否已停用。

429 Too Many Requests｜请求过多

可能是短时间登录或刷新过多、Cloudflare Rate Limiting、服务端频率限制，或共享 IP 被临时限流。

停止反复登录和刷新，等待几分钟再试。若页面提示等待时间，以该提示为准。

🔧 服务器 / 反向代理 5xx 错误#

500 Internal Server Error｜服务器内部错误

处理请求的服务发生内部异常，可能来自 Emby Server、插件、服务端程序或代理后端。不能仅凭 500 判断是本地网络问题。

稍后再试。如果其他用户也同时出现，则更可能需要管理员检查服务端日志。

501 Not Implemented｜服务器不支持请求

比较少见，表示服务端不支持完成该请求所需的功能。可能涉及服务端组件、代理配置，或客户端与服务端兼容性。

确认客户端版本；持续出现时，将具体操作和错误交给管理员检查。

502 Bad Gateway｜网关错误

代理或网关未取得有效的上游响应。Emby 环境中常见原因包括服务未运行、Nginx upstream 地址或端口配置错误、源站临时故障；Cloudflare 层也可能产生 502。

普通用户可等待 2～3 分钟再试。持续出现时，需要管理员检查代理与源站。

503 Service Unavailable｜服务暂时不可用

可能正在重启、维护、负载过高，或上游服务不可用。错误可能由 Emby、代理或 CDN 返回。

查看公告并稍后访问；若提供了重试时间，按提示等待。

504 Gateway Timeout｜网关超时

代理未在规定时间内取得上游的及时响应，可能是连接阶段或等待响应阶段超时，不能仅凭此代码断定已连接成功。

常见原因是 Emby 卡住、服务负载高、上游响应慢或网络线路异常。等待 2～3 分钟后再试；持续出现时联系服主。

☁️ Cloudflare 常见错误#

这些代码描述 Cloudflare 与源站之间的异常。源站配置问题通常需要管理员处理。普通用户可以先查看维护公告，或测试管理员已提供的其他线路。

520 Web Server Returned an Unknown Error｜源站响应异常

源站返回空响应、格式异常或 Cloudflare 无法识别的响应。等待约 30 秒后刷新一次；持续出现时交由管理员检查。

521 Web Server Is Down｜源站拒绝连接

源站 Web Server 拒绝 Cloudflare 的连接。可能是源站或 Nginx 未运行、防火墙拒绝 Cloudflare。通常需要服主处理。

522 Connection Timed Out｜源站连接超时

Cloudflare 联系源站超时，可能发生在 TCP 建连期间，也可能是建连后等待请求确认超时。常见原因包括防火墙丢包、网络异常或源站负载过高。

普通用户稍后再试，持续出现时联系服主。

523 Origin Is Unreachable｜源站不可达

Cloudflare 无法访问源站，通常涉及源站 IP 错误、路由或网络问题。管理员需要检查 DNS 中的源站地址及网络可达性。

524 A Timeout Occurred｜源站响应超时

Cloudflare 已连接源站，但源站未及时返回 HTTP 响应；部分情况也涉及向源站写入请求超时。Emby 负载过高、程序卡住或处理时间过长都可能造成此问题。

稍后重试，持续发生时交由管理员处理。

525 SSL Handshake Failed｜源站 TLS 握手失败

Cloudflare 与源站之间 SSL / TLS 握手失败。需要管理员检查源站 HTTPS、端口、证书及 TLS 配置。

526 Invalid SSL Certificate｜源站证书无法验证

Cloudflare 无法验证源站 SSL 证书，常见于 Full (strict) 模式下证书过期、域名不匹配或证书链问题。

管理员应检查证书有效期、域名、证书链及 Cloudflare SSL / TLS 模式。如管理员正在排查，可临时测试其他已提供的服务器线路。

530 Cloudflare 错误｜结合具体 1xxx 提示判断

530 是 HTTP 响应的外层状态码；在 Cloudflare 的常见场景中涉及源站主机名解析失败，响应正文会包含更具体的 1xxx 错误。

不要只把它记成“530 = DNS 错误”。记录页面中的完整 Cloudflare Error Code，并按对应说明排查。

Error 1000｜DNS points to prohibited IP

DNS 记录指向 Cloudflare 不允许代理的 IP，也可能涉及代理回环或相关配置异常。一般需要管理员检查 DNS 和代理配置。

Error 1001｜DNS Resolution Error

Cloudflare 相关 DNS 解析失败，例如 CNAME 目标无法解析。先确认使用了正确地址，再由管理员检查 DNS 记录。

Error 1015｜You Are Being Rate Limited

访问频率触发站点在 Cloudflare 上的限流规则。停止刷新，等待几分钟或页面规定时间后再访问。

Error 1016｜Origin DNS Error

Cloudflare 无法解析源站地址。需要管理员检查源站 A / AAAA / CNAME 等相关 DNS 配置。

Error 1020 / Access Denied｜访问被安全规则拒绝

1020 通常与 Cloudflare 防火墙规则拒绝访问有关；其他 Access Denied 提示也可能来自 WAF 或访问控制策略，需结合完整页面判断。

可以关闭异常代理、切换网络并稍后测试。持续出现时联系服主。不同产品与新版错误页面的提示方式可能变化，并非所有安全拦截都固定显示 1020。

DNS / HTTPS / 本地网络问题#

“找不到服务器”或 DNS 解析失败：先确认域名拼写和公告中的最新地址，再切换网络。单一网络失败时，可能涉及本地 DNS、路由器或运营商；不同网络都失败时，也可能是域名或服务器 DNS 配置问题。

“证书无效”“连接不安全”或 SSL 错误：检查设备日期、时间与时区是否自动同步，确认域名正确。证书过期或域名不匹配需由管理员处理，不要绕过浏览器的证书警告输入密码。

只有 App 失败，浏览器能打开：优先检查 App 版本、旧 Token、缓存和保存的服务器记录。网页能打开只说明网页请求可达，不保证登录接口或所有 App 请求正常。

⚡ 快速排查步骤#

1. 刷新一次页面 / 完全退出并重新打开 Emby App。 如果已经提示限流，先等待，不要连续重试。
2. 检查服务器地址。 确认 http / https 正确、域名没有拼错、没有多余路径，并使用 Bot 或公告提供的最新线路；端口和子路径以服主说明为准。
3. 切换网络。 Wi-Fi ↔ 手机流量，用于比较不同线路。
4. 关闭代理 / VPN 后测试。 判断是否与当前代理线路有关；需要代理才能访问的线路，应再与服主提供的可用线路对照。
5. 用浏览器直接打开服务器地址。 浏览器也打不开时，通常不只是 Emby App 的问题。
6. 用浏览器隐私 / 无痕模式访问。 用于排除普通窗口的 Cookie 和旧登录状态；它不会自动修复 DNS、网络或证书问题。
7. 检查设备日期和时间。 时间严重错误可能导致 HTTPS / SSL 证书验证失败。
8. 重新手动输入当前账号密码。 不要依赖旧密码或自动填充；忘记密码时使用服主提供的重置渠道。
9. 删除客户端中的服务器后重新添加。 适用于缓存或 Token 异常、服务器迁移、线路维护后的旧记录问题；不会删除服务端账号。
10. 重启设备。 可以解决一部分由缓存、网络状态或客户端异常造成的问题。
11. 确认是否只有自己出现问题。 通过公告或其他用户反馈判断，避免仅凭单次报错认定服务器故障。

💡 如何判断故障位置#

如果问题仍未解决，请向服主提供完整错误代码、发生时间及所在时区、客户端名称和版本、其他用户是否也遇到问题，以及已经测试过的网络。Cloudflare 页面如显示 Ray ID，也可一并提供。截图前遮住密码、Token 和私人信息，不要在公开群组泄露服务器地址。

技术参考：HTTP 状态码（RFC 9110）、429（RFC 6585）、Cloudflare 5xx、Cloudflare 1xxx。

3.🔍搜索问题#

Emby 的搜索功能，尤其是中文搜索，仍有一些使用限制，部分服务器已做过优化。如果遇到问题，欢迎向开发者提交具体反馈，帮助改进搜索体验。

以下是关于搜索的一些使用技巧：

• 使用中文关键词搜索时，至少输入两个字符
• 搜索单字片名时，可以尝试“片名 + 逗号”，例如输入“咒，”查找《咒》
• 中文搜索没有结果时，可以尝试作品的原语言片名
• 中文片名以 TMDB 元数据为准
• 部分资源的 TMDB 元数据缺少简体中文译名，可以尝试繁体中文关键词
• 电影库建议选择“按加入日期排序”，方便查看新加入的电影
• 剧集库建议选择“按最后一集添加日期排序”，方便查看最近更新的剧集

4.📦资源问题#

频道发布资源后，还需要经过下载、整理和入库等环节，因此发布时间不等于资源在 Emby 中可用的时间。

📺 频道发布剧集（不包含新番）#

流程：发布 → 下载上传 → 补字幕 → 入库 → 刮削 → Emby 呈现

如果英美剧迟迟没有在 Emby 中上线，通常是在等待字幕。字幕发布时间取决于字幕组。我们不会为了加快入库而采用画质较差的硬字幕版本，也不会通过脚本批量添加机翻字幕，请耐心等待。

🎬 频道发布电影#

流程：发布 → 下载上传 → 刮削入库 → Emby 呈现 → 字幕组出了非机翻字幕再补

新电影与剧集的处理方式不同：无论是否有中文字幕，都会先入库，非机翻字幕会在后续补充。也欢迎大家向服主分享合适的非机翻字幕，帮助改善观看体验。

❗注意#

• 各个环节都需要时间，看到频道的资源推送后，请耐心等待入库
• 新内容集中入库时，扫描和整理可能需要排队处理。部分资源尚未显示，可能是扫描任务还未完成
• 请先阅读说明再提问。反复发布缺乏基本了解的评论或提出不合理要求，可能导致频道和群组的发言权限被取消
• Emby 服不收录正在中国大陆院线放映的电影，建议大家到影院支持
• 询问仍在院线放映的电影资源，可能导致发言权限被取消，甚至账号被封禁
• 流媒体、高清录制以及蓝光原盘压制 是 Emby 服资源的唯一来源，劣质偷跑、枪版、低画质硬字幕等资源不会被收录
• 提问前请先确认该资源是否已在上述渠道中发行

5.🚫播放提示“没有兼容的流”#

• 大多数浏览器无法解码 HEVC(H265) 10bit 视频，所以会弹出这个提示。请使用客户端进行播放（多数 Emby 服已禁止浏览器播放）
• 如果 Android 官方客户端出现此提示，可以先重启 App 再试
• 如果使用客户端播放时仍频繁出现此提示，请向服主反馈，并详细说明客户端版本、播放的资源和具体报错

6.❓⋯其他#

使用 Emby 时，请注意保护个人隐私，并牢记以下事项：

• 避免使用真实姓名
• 不要使用相册上传功能！
• 不要公开 Emby 服的服务地址。 服务器受到攻击会影响所有用户的使用体验；公开泄露地址将导致账号被封禁