NOALBS 设置指南
NOALBS(Nginx OBS Automatic Low Bitrate Switching)会监控你的直播状态,并在连接中断或码率过低时自动切换 OBS 场景。即使遇到连接问题,也能尽量让观众留在直播间。
NOALBS 能做什么?
比特率监控
实时监控你的直播比特率。当比特率低于你设定的阈值时,NOALBS 会自动切换到 LOW 或 BRB 场景。
断线检测
检测编码器是否完全断开连接,并切换到 BRB 场景,这样观众看到的就不会只是卡住的画面。
聊天命令
直接通过 Twitch/Kick 聊天控制 OBS。切换场景、查看比特率,无需碰电脑也能管理直播。
自动恢复
连接恢复后,会自动切回 LIVE 场景,并支持可配置的重试机制。
前提条件
- 已启用 WebSocket 的 OBS Studio(OBS 28+ 已内置)
- 在 OBS 中创建的场景:LIVE、LOW、BRB(以及可选的 REFRESH、STARTING、ENDING)
- 带有统计信息 URL 的 IRLServer endpoint(可在你的仪表板中找到)
- 用于运行 NOALBS 的 Windows、macOS 或 Linux 电脑
设置步骤
Download NOALBS
从 GitHub 下载最新的 NOALBS release。请选择适合你操作系统的版本:
Enable OBS WebSocket
NOALBS 通过 WebSocket 与 OBS 通信。请先在 OBS 中启用:
- 打开 OBS Studio
- 前往工具 → WebSocket 服务器设置
- 勾选“启用 WebSocket 服务器”
- 设置密码(配置 NOALBS 时需要用到)
- 记下端口号(默认为 4455)
Create Your Scenes
在 OBS 中创建以下场景:
LIVE包含媒体源的主直播场景LOW低码率时显示(可包含画面和警告提示)BRB断开连接时显示(片段播放器、静态图片等)REFRESH(可选)在刷新媒体源时显示
Configure NOALBS
使用您的设置编辑 config.json 文件。使用我们的配置生成器即可轻松完成设置:
需要配置的关键项:
- OBS WebSocket 主机、端口和密码
- 您在 IRLServer 仪表板中的统计信息 URL
- 比特率触发器(例如:低于 800 kbps 时切换到 LOW)
- 与您的 OBS 场景名称完全一致的场景名称
Setup Chat Integration (Optional)
如需使用 Twitch 聊天命令,您需要一个 Twitch OAuth token。请在 NOALBS 文件夹中创建一个 .env 文件:
TWITCH_BOT_USERNAME=your_bot_username
TWITCH_BOT_OAUTH=oauth:your_token_here从 twitchtokengenerator.com 获取你的 OAuth token
Run NOALBS
启动 NOALBS 可执行文件。你应该会看到它连接到 OBS,并开始监控你的直播统计信息。
聊天命令
NOALBS 支持按权限等级划分的多种聊天命令。默认前缀是“!”。
管理员命令
!startStart streaming in OBS
!stopStop streaming in OBS
!switch [scene]Switch to a specific scene
!liveSwitch to LIVE scene
!privacySwitch to privacy scene
!recordToggle recording
版主命令
!trigger [value]Set low bitrate trigger threshold (kbps)
!otrigger [value]Set offline trigger threshold (kbps)
!fix / !refreshTry to fix the stream (refresh media source)
!sourceinfoShow current source information
公开命令
!bitrateShow current stream bitrate