参考手册
端口
Vfinity 使用的端口和连接、发起连接的程序及设置位置
本机
VfinityVTube Studio8001
Vfinity 通过端口 8001 连接到 VTube Studio API，以触发快捷键并移动你的模型。
VfinityOBS · WebSocket 服务器4455
Vfinity 连接到 OBS 内置的 WebSocket 服务器（端口 4455），以切换场景和显示来源。
OBS · 浏览器源Vfinity · 叠加层 + 本地 API21424
OBS 浏览器源打开 Vfinity 自己的服务器（端口 21424），以绘制投掷物、提醒和组件。
你的脚本Vfinity · 叠加层 + 本地 API21424
你的脚本使用令牌在相同的端口 21424 访问本地 API。
VfinityTikTok LIVE · Twitch · Kick · YouTube互联网
TikTok LIVE、Twitch、Kick 和 YouTube 通过互联网访问。Vfinity 自身发起这些连接。
箭头：谁发起连接
端口：谁在监听
这里列出 Vfinity 的本地端口和互联网连接，以及由哪一方发起连接。连接失败时，可据此确认要检查哪个程序。
本地端口
| 端口 | 用途 | 谁发起连接 | 设置位置 |
|---|---|---|---|
21424 | 叠加层与本地 API 共用服务器 | OBS 与脚本连接 Vfinity | 设置连接本地服务器 的共享服务器端口 |
8001 | VTube Studio 插件 API | Vfinity 连接 VTube Studio | VTube Studio API 卡片的端口 |
4455 | OBS WebSocket 服务器 | Vfinity 连接 OBS | OBS Studio 卡片的端口 |
8080 | Streamer.bot WebSocket 服务器 | Vfinity 连接 Streamer.bot | Streamer.bot 卡片的端口 |
8080 | 触发 API | Vfinity 连接你自己的服务器 | 触发 API 卡片的 WebSocket 端口 |
21213 | 自定义 TikTok 连接器 | Vfinity 连接你的连接器 | 高级 TikTok 连接的 WebSocket 端口，仅限自定义 WebSocket |
21215 | Kick 登录 | 浏览器回连 Vfinity | 固定 |
Vfinity 监听
21424 始终为叠加层和本地 API 提供服务。Kick 登录期间，21215 最多监听五分钟。
Vfinity 向外连接
8001 连接 VTube Studio，4455 连接 OBS，8080 连接 Streamer.bot 或你的触发 API 服务器，21213 连接自定义 TikTok 连接器。
向外连接的端口均由其他程序监听。如果连接不上，请检查目标程序是否运行、服务器是否开启。
共用服务器
叠加层、本地 API 的 HTTP 路由与事件 WebSocket 共用 21424。
- 启动时若
21424被占用，Vfinity 会选择可用端口并通知你。请从应用中复制叠加层 URL。 - 修改共享服务器端口后，需重启 Vfinity 才会生效。
- 默认只响应本机。开启允许另一台电脑上的 OBS 使用这些叠加层后，也会凭访问密钥响应家庭网络中的叠加层请求。
- 即使开启局域网访问，本地 API 也只响应本机且要求令牌。
Vfinity 1.x 曾为 API 打开 21214，为 TikTok 辅助程序打开 21213。2.0 不再开放这两个端口；请将 API 集成迁至共用端口。
互联网连接
以下服务由 Vfinity 主动连接，互联网上的服务不会直接连接进来。
| 服务 | 连接地址 | 时机 |
|---|---|---|
| TikTok LIVE | 通过内置桥接连接 TikTok | 连接期间；桥接通过进程管道与 Vfinity 通信，无需端口 |
| Twitch | eventsub.wss.twitch.tv、api.twitch.tv、id.twitch.tv | 连接期间及设备代码登录时 |
| Kick | Kick 的 Pusher 聊天套接字、kick.com、api.kick.com、id.kick.com | 连接和登录时 |
| YouTube | www.youtube.com | 连接期间，用于读取直播及其聊天，无需登录 |
| Microsoft Edge 免费文本转语音 | speech.platform.bing.com | 朗读时 |
| 付费文本转语音 | api.elevenlabs.io、api.sws.speechify.com、api.murf.ai、api.cartesia.ai、api.fish.audio | 朗读或列出声音时 |
| HTTP webhook 步骤 | 你填写的地址 | 步骤运行时 |
Twitch 使用浏览器批准短代码登录，不需要本地回调端口。YouTube 完全无需登录，因此也不会开放任何端口。