Broadcast Box 本地网络运行时错误分析与解决方案

问题背景

在使用开源项目 Broadcast Box 进行局域网直播时，用户遇到了运行时错误。具体表现为：当从局域网内的客户端设备访问主播端时，虽然能够加载广播盒界面，但在输入流密钥并点击"观看"后，系统会抛出错误。

环境配置

典型的问题复现环境包括：

1. 主播端运行 OBS，服务器地址设置为 http://localhost:8080/api/whip
2. 流密钥设置为 StreamTest
3. 局域网内客户端通过主播端IP（如 http://192.168.60.114:3000）访问
4. 相同设备上使用 http://localhost:3000 可以正常观看

错误现象

客户端浏览器控制台显示网络请求失败，主要涉及 WHIP/WHEP 服务器的连接问题。从网络抓包分析来看，请求未能正确路由到媒体服务器。

深度分析

经过技术排查，发现该问题可能由以下几个因素导致：

1. 开发环境与生产环境混淆：使用 npm start 启动的是开发服务器（端口3000），而媒体服务器运行在8080端口，导致跨域问题。

2. 防火墙设置：Windows 系统防火墙可能阻止了端口8080的入站连接。

3. 环境变量配置不当：未正确设置 APP_ENV 环境变量，导致服务器运行模式不符合预期。

4. IP地址绑定问题：服务可能只绑定到 localhost 而非所有网络接口。

解决方案

推荐方案：生产环境部署

1. 克隆项目仓库
2. 进入web目录执行 npm install 和 npm run build
3. 返回上级目录，设置环境变量：APP_ENV=production
4. 运行 go run . 启动服务

关键配置要点：

• OBS 应使用 http://<主机IP>:8080/api/whip 作为服务器地址
• 观众端访问 http://<主机IP>:8080/<流密钥>
• 确保始终使用主机实际IP而非localhost
• 统一使用8080端口，避免3000端口

备选方案

如果仍遇到问题，建议：

1. 检查Windows防火墙设置，确保8080端口开放
2. 验证环境变量是否正确加载（查看服务启动日志）
3. 尝试在干净的环境中重新部署
4. 考虑使用最新稳定版本的浏览器

技术建议

对于教育机构部署场景，还应注意：

1. 确保所有客户端设备使用相同网络环境
2. 考虑使用固定IP地址而非DHCP分配
3. 提前测试网络带宽是否满足直播需求
4. 准备备用方案（如录播）以防实时传输出现问题

通过以上方法，大多数局域网直播场景下的连接问题都能得到有效解决。如遇特殊情况，建议寻求专业技术支持进行实时调试。