[BUG]: Mobile pairing QR code points to the wrong network interface on Windows

快速结论：该报错通常发生在 Windows 桌面版 AnythingLLM 生成移动端配对二维码时，程序错误地选取了 VPN 或虚拟网卡（如 WireGuard/TAP）的 IP 地址，而非物理网卡（Ethernet）地址，导致手机扫码后连接失败并提示 “Network request failed”。优先排查系统网卡优先级，可先临时禁用 VPN 适配器或手动输入正确 IP 连接。

适用环境：AnythingLLM Desktop 应用（Windows 系统），已确认存在 VPN 网卡与物理网卡共存的环境，移动端 AnythingLLM 配对功能。

最快修复方案：暂无确认的一步修复方案。Issue 中已验证的临时绕过方案是：禁用 VPN 网卡后重新打开配对对话框，此时应显示以太网 IP；或者在手机端手动输入 http://<ethernet-ip>:3001 进行连接，跳过二维码扫描。

注意事项：开发者回复表明该问题已在桌面版后续补丁中通过 Node.js 的 dgram 内置模块修复，但此修复尚未在 Issue 关闭时验证。手动输入 IP 的方式需确保手机与电脑处于同一局域网，且 Windows 防火墙放行 TCP 3001 端口（针对专用网络配置文件）。

问题场景

用户在 Windows 上运行 AnythingLLM 桌面版，尝试使用 AnythingLLM Mobile 应用通过扫描配对二维码连接桌面端。生成的二维码指向的是 VPN 虚拟网卡的 IP 地址而非以太网物理网卡地址，导致移动端请求失败。

报错原文

[BUG]: Mobile pairing QR code points to the wrong network interface on Windows
"Network request failed" error in the mobile app when trying to connect using the QR code

原因分析

可能原因：AnythingLLM 桌面版在生成配对二维码时，通过系统 API 获取本机 IP 地址，但获取逻辑只是抓取第一个非回环（non-loopback）地址。在多网卡环境中，WireGuard、TAP 等虚拟网卡适配器通常会优先于物理以太网适配器返回，导致二维码包含错误的 IP 地址。这是一个网卡接口优先级（interface-priority）问题，并非连接超时或防火墙拦截。

环境排查

确认是否安装了 VPN 客户端（如 WireGuard、OpenVPN TAP 适配器）或其他虚拟网卡软件。
在 Windows 命令提示符中执行 ipconfig，对比 VPN 网卡与以太网卡的实际 IP 地址。
确认手机与电脑处于同一局域网网段，且电脑端 TCP 3001 端口未被防火墙拦截。
如果是后续补丁版本，验证是否为最新版 AnythingLLM 桌面版（Issue 中未提供具体版本号）。

解决步骤

临时禁用 VPN 网卡：打开 Windows 网络连接设置，右键禁用 VPN 或虚拟网卡适配器，重新打开 AnythingLLM 的配对对话框，确认以太网 IP 是否正常显示。
手动输入 IP 连接（可优先尝试）：在手机端 AnythingLLM 应用中，不扫描二维码，改为手动输入 http://<以太网IP>:3001，确认内网连接是否成功。
二维码手动替换（原 Issue 提供的 Workaround）：先用任意二维码扫描工具扫描错误二维码获取配对 URL，将其中 IP 替换为以太网 IP，再用二维码生成工具生成新二维码，最后用 AnythingLLM Mobile 扫描新二维码。
检查防火墙规则：若手机能解析地址但连接超时，检查 Windows 防火墙是否为 TCP 3001 端口添加了入站允许规则，适用范围选择“专用”（Private）网络配置文件。
升级桌面版：开发者回复已通过 Node.js 的 dgram 内置模块修复此问题，可更新到最新补丁版本后重试。