网络要求和防火墙设置

何时需要参考本文？

大多数家庭和小型办公网络可以直接使用 Screenbird，无需任何配置。仅当你的网络出现以下情况时，才需要本文：

• 严格的防火墙会拦截未知域名
• 网页过滤器或代理限制出站流量
• 显示设备所在的独立 VLAN 没有互联网访问权限

必需的域名

请将以下域名加入白名单，供仪表盘（管理内容的人员使用）和播放器（在屏幕上运行）使用。

仪表盘域名

• screenbird.app，主应用
• dev.screenbird.app，预发布环境（仅当你的团队使用预发布环境时需要）
• api.screenbird.app，设备 API
• *.supabase.co，数据库与身份验证
• cdn.screenbird.app，静态资源和内容
• media.screenbird.app，图片和视频

播放器域名

• player.screenbird.app，播放器应用
• cdn.screenbird.app，内容分发
• *.supabase.co，与你的账户的连接
• api.screenbird.app，心跳和内容同步

可选域名（部分应用和集成会用到）

• apis.google.com，Google Slides、Sheets、Docs 选择器
• *.googleusercontent.com，Google Drive 缩略图
• images.pexels.com，Pexels 图库
• api.qrserver.com，模板中的二维码
• geocoding-api.open-meteo.com，天气应用中的位置自动补全
• challenges.cloudflare.com，Cloudflare Turnstile（在注册和联系表单中使用）

如果不使用某项集成，则无需将其域名加入白名单。

必需的端口

• HTTPS（443），所有通信通过 443 端口的 HTTPS 进行
• WebSocket（443），实时通信也走 443 端口

Screenbird 不使用任何非标准端口。

必需的协议

• 所有流量使用 HTTPS
• 仪表盘到播放器的实时更新使用 WebSocket Secure（WSS）

带宽要求

• 播放器空闲时，每分钟低于 10 KB（仅心跳）
• 播放器播放静态图片，内容下载完成后，流量极低
• 播放器播放 1080p 视频，初始下载取决于文件大小，播放期间流量为 0（视频已缓存到本地）
• 播放器播放直播流（YouTube、RSS），取决于流的码率

对于大多数标牌网络而言，每个屏幕 5 Mbps 的下载速率已绰绰有余。Screenbird 设计为内容下载完毕后可离线工作，因此短暂的网络中断不会影响播放。

测试网络

要验证屏幕能否访问 Screenbird，请在设备上打开浏览器并访问：

• https://player.screenbird.app，应加载播放器登录界面
• https://screenbird.app，应加载仪表盘登录页面

如果其中任一无法访问，请检查防火墙日志中是否有针对上述域名的拦截记录。

需要企业级部署支持？

如果你正在企业网络后部署大量屏幕，并且需要白名单文档、IT 验证或代理配置方面的帮助，请通过 support@screenbird.app 联系我们，我们将提供协助。