开始前准备
- OBS Studio 28 或更新版本；这些版本已内置 WebSocket，无需另外安装旧插件。
- OBS 与直播进场特效在同一台 Windows 电脑运行。自动读取适用于相同 Windows 用户的一般安装；便携版或读取失败时改用手动设置。
- 先在未开播时完成设置，保持两个程序开启。不要把 OBS 密码与连接信息画面放进直播或公开截图。
手机可以先阅读，设置请在直播电脑操作。请用 Chrome 或 Edge 打开，勿使用微信内置浏览器。
先区分两种连接
ws://127.0.0.1:4455http://127.0.0.1:178914455 是 OBS WebSocket 默认端口，可按 OBS 实际设置调整。17891 是特效播放器的端口。
在 OBS 打开 WebSocket 设置
先打开 OBS，在顶部菜单点击“工具”→“WebSocket 服务器设置”。英文界面为 Tools → WebSocket Server Settings。
如果找不到此项目，先查看 OBS 版本；本教程使用 OBS 28 以上的内置 WebSocket 5。菜单名称可能随语言或版本略有不同。
开启服务器，确认端口与密码
勾选“开启 WebSocket 服务器”。服务器端口通常保持 4455；如果已使用其他值，记住该数字，稍后两边要一致。
保持“开启身份认证”勾选，使用 OBS 生成的服务器密码。需要查看或复制时，可以点击“显示连接信息”。
设置完成后点击“应用”，再点击“确定”关闭设置窗口。WebSocket 密码与本程序的授权码不同。
OBS WebSocket 端口：4455（默认）回到特效程序，先试自动读取
在桌面版直播进场特效中，展开顶部连接区域下方的“OBS 自动化连接设置”。
“连接方式”选择“自动读取本机 OBS”。程序会读取本机 OBS 的端口与密码；如果刚切换方式，先点击“保存连接设置”。
本程序固定连接同一台电脑的 127.0.0.1，没有另外填写主机 IP 的输入框。
自动失败时，手动填入同一组数据
将“连接方式”改为“手动指定密码”。在“WebSocket 端口”填写 OBS 中的数字，例如 4455；在“WebSocket 密码”粘贴 OBS 的服务器密码。
点击“保存连接设置”。如果提示“已保存手动密码；留空保留”，输入框留空会继续使用旧密码；需要更换时，请重新粘贴新值。
也可以使用本程序的“生成专用密码”→“复制密码”，但必须亲自把它粘贴到 OBS 的服务器密码并应用，再回本程序保存。生成密码不会自动修改 OBS。
点击“测试连接”，确认真正连上
保持 OBS 开启，在特效程序点击“测试连接”。成功时会显示“OBS 连接成功。”和 OBS 版本。
如果按钮无法点击，先处理“请先保存更改，再测试连接”的提示。如果失败，按下方常见问题排查后重试。
此测试只确认控制连接和版本，不会开始直播或新增来源；测试结束会关闭本次测试连接。上方的“直播来源已连接”是另一个画面来源状态，不能代替本步测试。
加入特效来源，核对竖屏或横屏画布
在 OBS 选定实际输出的场景；开启工作室模式时，要确认右侧实际输出场景，不只是切换左侧预览。再到“设置”→“视频”确认基础画布尺寸：竖屏常用宽 1080、高 1920；横屏常用宽 1920、高 1080。
回特效程序点击上方“添加到 OBS”。程序会根据 OBS 基础画布尺寸创建或更新“直播進場特效 - 獨立中文版”浏览器来源；再确认来源可见，并位于摄像头图层上方。
如果自行添加浏览器来源，请复制本程序“直播网页来源”的地址。下方是默认示例；不要把 WebSocket 的 4455 填进浏览器来源。两种端口的用途不同。
http://127.0.0.1:17891/overlay/screen-1#tiktok.studio需要监听时，开启音频保持选项
先确认 OBS 混音器中的特效来源未静音，音量合适。需要自己听到特效并输出声音时，勾选程序上方“保持 OBS 特效音频为‘监听与输出’”。
此选项默认关闭；勾选后立即保存，并每 5 秒检查本程序的特效来源。请保留默认来源名称和本程序的来源地址；尚未创建来源时会等待重试。
取消勾选只停止自动保持，不会恢复 OBS 现有音频模式。请用耳机和短段录像确认没有桌面音频与来源音频重复收音。
测试画面和声音，再连接聊天室
在特效程序点击“动画预览”检查动画，再用“测试进场”确认指定观众、横幅和欢迎语等已设置内容。没有播放时画面透明是正常待机状态。
如果来源已经存在，但更新后没有刷新，可以点击“修复 OBS”，完成后重新测试；此按钮同样需要 WebSocket 已连接。
确认主播已经实际开播后，填写真正的 TikTok 账号并点击“连接聊天室”。OBS 控制连接、特效画面来源和聊天室是三件事，需要分别确认。
常见问题
提示服务器未开启，或无法连接 OBS
先确认 OBS 正在运行；回“工具 → WebSocket 服务器设置”勾选开启并应用。确认本程序的手动端口与 OBS 一致，不要填成网页来源的 17891。
提示密码不匹配／身份验证失败
重新从 OBS 复制当前密码，切到“手动指定密码”，粘贴后保存再测试。如果曾点击“生成专用密码”，必须同时粘贴到 OBS 并应用；只在一边保存不会成功。
便携版 OBS、另一个 Windows 账号，或自动读取了错误设置
改用“手动指定密码”，填写当前这个 OBS 的端口与密码。主机仍固定为本机 127.0.0.1；此设置区域不提供跨电脑连接。
无法读取已保存的密码
在当前登录的 Windows 账号中重新输入并保存 OBS 密码，或切回自动读取。如果设置区域完全加载失败，可以点击“恢复自动读取”后再测试。
连接成功，但没有动画或没有声音
WebSocket 成功只代表可以控制 OBS。确认已添加正确的浏览器来源、地址和画布尺寸正确、图层可见且未静音，再点击动画预览与测试进场；需要监听时检查第 7 步。
持续提示同名来源冲突，音频保持没有生效
检查“直播進場特效 - 獨立中文版”是否确实是本程序的浏览器来源和地址。如果其他内容使用了相同名称，先将它改成不同名称，再用“添加到 OBS”建立本程序来源。
需要开放路由器端口或全部用管理员运行吗？
本程序使用同一台电脑的 127.0.0.1 连接，无需为此流程设置路由器转发或开放公网。先核对开启状态、端口与密码；不要用关闭身份认证或全面停用防火墙来代替排查。
最后检查
参考资料
- OBS Remote Control Guide
- OBS WebSocket official project — default port and authentication
- OBS Browser Source
- OBS WebSocket official Traditional Chinese labels
- OBS WebSocket official Simplified Chinese labels
公开文件请勿填入或分享你的授权码与 WebSocket 密码。