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强制检查失败（用于自动化测试）。它默认"宁可不干活，也不带病运行"。跳过检查或许能让插件"看起来能开"，但底层版本对不上，功能大概率是残的。除非你在开发调试，否则这条后门不建议碰。
修完还报错？对照这张"反向清单"
| 你还卡在哪 | 先去自查 | 大概率是 | 下一步 |
|---|---|---|---|
| 日志已显示 compatible，但"NDI 源/输出"还是灰的 | 日志里有没有 ERR-403 / ERR-424 | 旧插件残留或 OBS 版本太老 | 清掉旧 OBS-NDI，升级 OBS ≥ 31.1.1 |
| 能加源，但扫不到局域网设备 | 防火墙是否放行 NDI 相关端口 | 网络组播被拦 | 查防火墙与路由器的组播设置 |
| 初始化时报 ERR-406 | 电脑 CPU 型号是否过老 | 硬件不支持 NDI 库 | 查阅官方 CPU 要求 |
高频疑问，一次性答完
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
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
