DistroAV 连不上 NDI 设备？从 0 到 1 排查 ERR-401 与 ERR-425 的修复手册

DistroAV 连不上 NDI 设备？从 0 到 1 排查 ERR-401 与 ERR-425 的修复手册

【免费下载链接】obs-ndiDistroAV (formerly OBS-NDI): NDI integration for OBS Studio项目地址: https://gitcode.com/gh_mirrors/ob/obs-ndi

你刚把 OBS 升级到新版本，顺手装了 DistroAV（OBS-NDI 插件），想着今晚终于能跟另一台电脑互传画面。结果打开"工具"菜单想找 NDI 输出设置，弹窗先一步把路堵上了：Error-401，NDI library failed to load。你照着网上的教程补装了一次 Runtime，再启动 OBS，弹窗却换了张脸：Error-425，需要 NDI 6.3.0 及以上。

先别急着卸载重装，八成概率，问题都出在同一个零件上——NDI Runtime。

把 NDI Runtime 想成一台"快递中转站"

DistroAV 干的事，是把你的画面和声音打包成 NDI 格式的"标准包裹"，发给局域网里其他支持 NDI 的设备。而NDI Runtime 就是小区门口那台中转站：包裹要经过它验收、分拣、装车，才能送到对面那台设备手上。插件是发货方，中转站是物流命脉，缺一环，货就出不了门。

所以两个报错的本质完全不同：

• ERR-401：中转站压根没建，系统里找不到 NDI 库，包裹没地方交。
• ERR-425：中转站是旧型号，只认老规格的包裹，新规格的一律拒收——Runtime 版本低于 6.3.0。

顺带一提，如果你的 CPU 太老，还可能撞上 ERR-406，那是中转站的分拣机本身跑不起来，属于硬件门槛，不在今天的修复范围。

这就是"缺 Runtime"和"版本太旧"的本质区别：一个是找不到，一个是找得到但不够格。

快速诊断：从上到下走一遍，别靠猜

不急着动手，先花两分钟对号入座。打开 OBS 的"帮助 → 日志文件 → 查看日志文件"，搜 "ERR-" 或 "NDI"：

日志里有没有 "NDI Library Version detected"？ ├─ 没有，且出现 ERR-401 / ERR-404 │ → 库没找到，跳到"分层修复"的第二层 ├─ 有，版本号 < 6.3.0 │ → 版本太旧，跳到第三层"清残留 + 装新版" ├─ 有，版本号 ≥ 6.3.0，但后面没有 "is compatible" │ → 版本够但初始化失败，查 ERR-406 / 硬件 └─ 有版本号，也有 "is compatible"，但功能还是灰的 → 多半是插件本体或旧插件冲突，先走第一层

看完日志，你已经知道自己属于哪一格了。下面按"代价从小到大"逐层修，每做一步就重启一次 OBS 验证。

分层修复：先把装配线换成官方渠道

很多"缺 Runtime"其实是装错了来源。DistroAV 的官方安装方式分平台：

• Windows：winget install --exact --id DistroAV.DistroAV
• macOS：brew install --cask distroav/distroav/distroav
• Linux：Ubuntu 系sudo apt install distroav，通用方案走 Flatpak

如果你是从"整合包"里拷进来的，插件本体可能不完整，或者和系统里残留的老版 OBS-NDI 打架。先卸掉手头版本，走官方渠道重装一遍，这一步能解决相当一部分"装完就报错"的案例。

Windows 怎么把 Runtime 各就各位

去 NDI 官网下载最新 Runtime 安装包（项目代码里PLUGIN_REDIRECT_NDI_REDIST_URL指向的就是它），安装时勾选"为所有用户安装"，装完重启一次电脑，让环境变量生效。

macOS 和 Linux 的打开方式

macOS 同样从官网下载 Runtime 拖入 Applications，装完打开终端看看/Library/NDI/下有没有运行时文件。Linux 情况最特殊：用apt install distroav时依赖一般会自动带进来，Flatpak 方案也会顺手把运行时处理妥当；还缺就查官方文档里针对你发行版的说明，别硬搜网上的"万能解法"。

装好后回 OBS 日志搜 "NDI Library Version detected"，只要数字 ≥ 6.3.0，且后面跟着 "is compatible"，这一层就算过了。

清走"旧房客"，再装新

版本太旧最常见的原因不是没升级，而是系统里还赖着一个旧版本没走。Windows 打开"设置 → 应用"，把所有带 NDI 字样的组件全卸干净；macOS 检查/Library/NDI/下的残留文件。原则就一句：先清后装，装完重启，对治 ERR-425 往往立竿见影。

还不行？让错误码自己开口

走到这一步还报错，就把日志里每个 ERR 编号记下来去搜官方知识库——ERR-401 是找不到库，ERR-425 是版本不够，ERR-406 是 CPU 不支持，ERR-424 是 OBS 版本太老（DistroAV 要求 OBS ≥ 31.1.1），ERR-403 是还残留着旧版 OBS-NDI。想较真研究源码的话，版本检查逻辑在src/plugin-main.cpp，最低版本要求定义在src/plugin-main.h的PLUGIN_MIN_NDI_VERSION里。

开发者专属后门，普通人别碰

DistroAV 留了几个命令行参数：--distroav-check-ndilib-ignore跳过 NDI 版本检查，--distroav-check-ndilib-forcefail强制检查失败（用于自动化测试）。它默认"宁可不干活，也不带病运行"。跳过检查或许能让插件"看起来能开"，但底层版本对不上，功能大概率是残的。除非你在开发调试，否则这条后门不建议碰。

修完还报错？对照这张"反向清单"

高频疑问，一次性答完

Q1：卸载重装插件，会不会丢了我 OBS 里的场景？不会。DistroAV 的配置存在 OBS 的配置目录里，卸载插件不影响场景和源，重装后设置照旧。

Q2：Runtime 装完也重启了，还是弹 425？十有八九是系统里还残留旧版本，按"清走旧房客"把带 NDI 字样的组件全卸了再装新版。

Q3：我只在 OBS 里用，其他软件也要装 Runtime 吗？要。Runtime 是 NDI 协议本身的地基，跟你在哪个软件里用没关系——只要是走 NDI 的功能，都得有这台"中转站"。

Q4：追新装了测试版 OBS，能配 DistroAV 吗？建议回退稳定版。DistroAV 要求 OBS ≥ 31.1.1（Qt6），太激进的测试版容易出兼容问题，回退或同步升级插件都值得一试。

让 NDI 不再掉链子的四个习惯

• 只走官方渠道：插件一律用 winget / brew / apt / Flatpak 装，别图省事用整合包。
• 更新后先看日志：每次升级 OBS 或插件，重启后扫一眼有没有新的 ERR，早发现早处理。
• 心里记两个门槛："NDI ≥ 6.3.0、OBS ≥ 31.1.1"，排查时能省一半时间。
• 卸载时顺手清残留：带 NDI 字样的组件一并处理，别让"旧房客"潜伏下来。

最后：它只是拒绝"带病出工"

DistroAV 的报错框看着吓人，本质上是它宁可把货拦在门口，也不让你发出半包坏件——把 NDI Runtime 这条地基补齐，剩下的路就顺畅了。这篇手册里的排查顺序都源自项目真实代码逻辑，想深入了解可以顺着src/plugin-main.cpp自己逛；要是卡在更细的坑里，比如防火墙拦了 NDI 设备发现，官方文档里有对应的排查章节，照着翻就行。祝你今晚的流，推得又稳又顺。

【免费下载链接】obs-ndiDistroAV (formerly OBS-NDI): NDI integration for OBS Studio项目地址: https://gitcode.com/gh_mirrors/ob/obs-ndi