Automation15 min read

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 电脑

设置步骤

1

Download NOALBS

从 GitHub 下载最新的 NOALBS release。请选择适合你操作系统的版本:

将下载的 ZIP 文件解压到电脑上的文件夹中。你应该会看到 NOALBS 可执行文件和 config.json 文件。
2

Enable OBS WebSocket

NOALBS 通过 WebSocket 与 OBS 通信。请先在 OBS 中启用:

  1. 打开 OBS Studio
  2. 前往工具 → WebSocket 服务器设置
  3. 勾选“启用 WebSocket 服务器”
  4. 设置密码(配置 NOALBS 时需要用到)
  5. 记下端口号(默认为 4455)
3

Create Your Scenes

在 OBS 中创建以下场景:

  • LIVE包含媒体源的主直播场景
  • LOW低码率时显示(可包含画面和警告提示)
  • BRB断开连接时显示(片段播放器、静态图片等)
  • REFRESH(可选)在刷新媒体源时显示
场景名称区分大小写。请确保它们与您在配置中填写的名称完全一致。
4

Configure NOALBS

使用您的设置编辑 config.json 文件。使用我们的配置生成器即可轻松完成设置:

需要配置的关键项:

  • OBS WebSocket 主机、端口和密码
  • 您在 IRLServer 仪表板中的统计信息 URL
  • 比特率触发器(例如:低于 800 kbps 时切换到 LOW)
  • 与您的 OBS 场景名称完全一致的场景名称
5

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

6

Run NOALBS

启动 NOALBS 可执行文件。你应该会看到它连接到 OBS,并开始监控你的直播统计信息。

直播时请始终保持 NOALBS 运行。你可以将它最小化到系统托盘,或将其作为服务运行。

聊天命令

NOALBS 支持按权限等级划分的多种聊天命令。默认前缀是“!”。

管理员命令

!start

Start streaming in OBS

Admin
!stop

Stop streaming in OBS

Admin
!switch [scene]

Switch to a specific scene

Admin
!live

Switch to LIVE scene

Admin
!privacy

Switch to privacy scene

Admin
!record

Toggle recording

Admin

版主命令

!trigger [value]

Set low bitrate trigger threshold (kbps)

Mod
!otrigger [value]

Set offline trigger threshold (kbps)

Mod
!fix / !refresh

Try to fix the stream (refresh media source)

Mod
!sourceinfo

Show current source information

Mod

公开命令

!bitrate

Show current stream bitrate

Public

故障排查

NOALBS 无法连接到 OBS:请检查 OBS 是否已启用 WebSocket,并确认配置中的密码和端口与 OBS 设置一致。
场景切换不起作用:请确认 config.json 中的场景名称与 OBS 中的场景完全一致(区分大小写)。
统计信息 URL 返回错误:请确保你的 encoder 正在向该 endpoint 推流。请在浏览器中打开统计信息 URL——你应该能看到 JSON 数据。
需要帮助?加入我们的 Discord 社区,或查看 NOALBS Wiki

资源