Automation15 min read

NOALBS 设置指南

NOALBS(Nginx OBS Automatic Low Bitrate Switching)会监控你的直播状态,并在连接中断或码率过低时自动切换 OBS 场景。即使遇到连接问题,也能尽量让观众留在直播间。

NOALBS 能做什么?

比特率监控

实时监控你的直播比特率。当比特率低于你设定的阈值时,NOALBS 会自动切换到 LOW 或 BRB 场景。

断线检测

检测编码器是否完全断开连接,并切换到 BRB 场景,这样观众看到的就不会只是卡住的画面。

聊天命令

直接通过 Twitch/Kick 聊天控制 OBS。切换场景、查看比特率,无需碰电脑也能管理直播。

自动恢复

连接恢复后,会自动切回 LIVE 场景,并支持可配置的重试机制。

NOALBS Cloud:无需安装

NOALBS Cloud 是 NOALBS 的托管版本,由其原作者打造。它在线运行,因此无需下载,也无需在电脑上一直开着。你只需用 Twitch 或 Kick 登录,OBS 即可通过浏览器源连接到它。

想自己运行 NOALBS?下方的前提条件和设置步骤介绍了如何在你的电脑上运行 NOALBS。

一键添加你的端点

  1. 在 IRLServer 控制台 中打开你的 endpoint。
  2. 在“连接”标签页中,打开“自动切换场景”,然后打开“更喜欢 NOALBS?”,并选择 NOALBS Cloud。
  3. 点击“添加到 NOALBS Cloud”。登录后,选择要添加到的切换器,然后确认。
  4. 在 NOALBS Cloud 中完成设置:将其浏览器源添加到 OBS,并选择你的 LIVE、LOW 和 BRB 场景。
按钮背后的链接包含你的 stream 路径,其作用类似密码。请勿分享。

或者手动添加

  1. 在 next.noalbs.com 登录并打开你的 switcher。
  2. 前往“Stream 服务器”,添加服务器并选择 SLS (SRT Live Server)。
  3. 从端点“连接”标签页的 NOALBS Cloud 选项中复制统计信息 URL 和发布者。粘贴进去,然后保存。

IRLControl:我们的托管方案

IRLControl 是我们自己的托管切换器,而且免费。它使用与 NOALBS 相同的切换规则,并且可以导入你的 NOALBS config.json,因此你的触发条件、场景和 stream 服务器都会一并迁移过来。除了切换之外,它还能在一个屏幕上显示你的 stream 健康状况,并让你的管理员通过聊天来操控 stream。

NOALBS Cloud、IRLControl 以及你电脑上的 NOALBS 都可以配合你的 IRLServer 端点使用。选择最适合你的那一个。

打开 IRLControl

前提条件

  • 已启用 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。

资源