TC002 配网卡在 100%？排查指南
配网进度走到 100% 还不动，意思是 Ulanzi Studio 已经发出 Wi-Fi 配置，但在等设备连上局域网后回传上线信号。这个信号走 UDP 55555 端口，收到才算成功。
卡住不等于密码填错了。如果配网界面有错误提示，先对照下面的说明。
先看错误提示
配网卡在 100% 时，界面上可能出现两种提示：
- PWDERR：Wi-Fi 信息有误。意思是设备拿到了密码但连不上，要么密码打错了，要么 SSID 拼错了。回到配网界面，核对 Wi-Fi 名称和密码再试一次。
- WEAK：信号弱。设备所在位置的路由器信号不够，握手没完成。把设备挪到离路由器更近的地方，再重新配网。
如果界面上没有这两种提示，按下面的步骤继续排查。
Windows 排查
1. 确认设备有没有入网
打开路由器管理页面，看客户端列表里有没有一台 TC002 设备。
- 有：设备已经连上 Wi-Fi 了，问题出在电脑这边收不到广播，继续往下看第 2 步。
- 没有：设备没配网成功，跳到第 6 步。
2. 关掉 VPN 和虚拟网卡
VPN、Hyper-V、WSL、Docker、VMware 都会多出一块虚拟网卡，UDP 广播可能走了这块网卡而不是真实局域网。
把 VPN 断开，临时停用虚拟网卡，再试一次。
3. 检查网络类型
Windows 设置 → 网络和 Internet → 属性，确认当前连接是「专用网络」，不是「公用网络」。
公用网络会限制入站 UDP 通信。
4. 查防火墙
Windows 安全中心 → 防火墙和网络保护 → 允许应用通过防火墙，确认 Ulanzi Studio 在允许列表里，并且专用/公用网络的勾都打上了。
如果你装了第三方安全软件（火绒、360、迈克菲等），也去它们的网络防护规则里看一眼。
5. 端口有没有被占
别的程序占了 55555 端口，Studio 就收不到设备广播。
打开任务管理器，看有没有其他 Ulanzi 实例在跑。同一台电脑只留一个 Studio。
6. 设备没入网的情况
如果路由器里找不到设备，往这几个方向查：
- Wi-Fi 是不是 2.4 GHz。TC002 不支持 5 GHz 单频网络。
- Wi-Fi 加密方式。WPA3-only 或企业级 802.1X 不兼容。
- SSID 有没有中文、空格或特殊字符，部分固件不认。
- 路由器开了 AP 隔离或访客网络，设备之间互相看不到。
- Wi-Fi 信号太弱，把设备放近路由器试试。
- 密码有没有输错。在 Studio 的配网界面重新输一次，请勿在聊天中发送密码。
Mac 排查
1. 先查本地网络权限
系统设置 → 隐私与安全性 → 本地网络。
列表里有没有 Ulanzi Studio？
- 有，而且开关开着：权限没问题，继续往下。
- 有但开关关着：打开它，重启 Studio。
- 列表里没有 Ulanzi Studio：这是已知问题。Studio 的设备发现走的是 UDP 广播，不触发 macOS 的权限弹窗，所以不会出现在列表里。目前需要等软件更新修复。临时方案：在终端执行
tccutil reset All com.ulanzi.UlanziDeck，然后重启 Studio 再试。
2. 确认设备有没有入网
跟 Windows 一样，先去路由器客户端列表找 TC002。
- 有：设备在线，问题在 Mac 收不到广播，继续第 3 步。
- 没有：设备没配网成功，跳到第 6 步。
3. 关掉 VPN 和虚拟网卡
Mac 上的 VPN、Parallels、Docker、VirtualBox 同样会多出虚拟网卡，广播可能走错接口。
断开 VPN，停用虚拟网卡，再试。
4. 查防火墙
系统设置 → 网络 → 防火墙，确认防火墙已经打开，并且 Ulanzi Studio.app 被设置为「允许传入连接」。
如果防火墙没启用，先把开关打开，再回 Studio 重新配网。
5. 确认在同一个局域网
Mac 和 TC002 要在同一个 Wi-Fi 网段。如果你的 Mac 接的是有线网，设备接的是无线网，确认两者在同一个子网。
路由器开了 AP 隔离或访客网络的话，设备之间互相看不到。
6. 设备没入网的情况
跟 Windows 一样的排查方向：
- 确认是 2.4 GHz 网络
- 确认不是 WPA3-only 或企业网络
- SSID 别用中文、空格、特殊字符
- 关掉路由器的 AP 隔离和访客网络
- 把设备放近路由器
- 在 Studio 配网界面重新输入密码
还是不行？
需要联系客服时，准备好以下信息：
- 操作系统版本（Windows 还是 Mac，具体版本号）
- 路由器客户端列表里是否能看到 TC002
- Wi-Fi 频段（2.4 GHz 还是 5 GHz）
- 是否使用了 VPN 或虚拟网卡
- Ulanzi Studio 版本号
这些信息能帮我们快速定位问题。