跳至主内容

DLNA

非官方测试版翻译

本页面由 PageTurner AI 翻译（测试版）。未经项目官方认可。 发现错误？ 报告问题 →

自 10.9 版本起，DLNA 支持已迁移至官方插件，不再包含在 Jellyfin 基础安装中。 如需使用 DLNA 功能，请从官方插件目录安装相应插件。 操作步骤：进入管理员控制台 → 打开插件目录 → 安装 DLNA 插件。Jellyfin 项目维护的插件默认都会在此目录中提供。 安装完成后请重启 Jellyfin 服务器以激活插件。

通用安装​

必要条件：

  • Docker 主机网络模式（如使用 Docker）

  • 开放 1900 UDP 端口

DLNA 基于 UPnP 协议实现。 因此将使用其运行在 1900 UDP 端口的服务发现功能(SSDP)。 由于 UPnP 是标准协议且固定使用 UDP 1900 端口，该端口不可配置。 请确保向本地网络开放此端口。详细操作请参阅防火墙指南。

DLNA 发现机制通过向当前子网发送广播并等待 DLNA 服务器响应实现。 这意味着如果客户端与服务器不在同一子网，将无法发现您的服务器。 远程使用 DLNA 功能不可行。 若使用 Docker，网络需设置为主机模式(Host Mode)，否则广播信号无法传递至 Docker 内部的桥接网络。

故障排除​

  • 若 DLNA 绑定失败，日志中应出现：[ERR] Failed to bind to port 1900: "Address already in use". DLNA will be unavailable

  • 将Alive message interval (seconds)设为 30 秒可改善部分客户端的发现能力

  • 若设置了基础 URL，尝试移除后重启服务器

DLNA 日志记录​

在 logging.default.json 中添加以下条目可启用 DLNA 调试日志

{
  "Serilog": {
    "MinimumLevel": {
      "Default": "Warning",
      "Override": {
        "Microsoft": "Warning",
        "System": "Warning",
        "Jellyfin.Plugin.Dlna": "Debug"
      }
    }
  }
}