Minecraft 游戏连接通常走 TCP,而 Simple Voice Chat 语音数据使用独立 UDP 端口。要让异地好友听见语音,需要在 Katofrp 分别建立或配置 TCP 与 UDP 通道,并让所有成员使用可达的语音地址。

- 游戏通道
- Minecraft 端口 / TCP
- 语音通道
- Simple Voice Chat 端口 / UDP
- 关键配置
- voice_host
- 成员要求
- 客户端模组和地址配置一致
先判断问题位置
只映射 Minecraft 游戏端口时,玩家可以进服,但语音图标可能显示未连接。语音端口必须由服务端模组实际监听,并通过 UDP 转发。
端口号、配置文件名和 voice_host 行为可能随模组版本变化。本文给出通用流程,具体字段以当前 Simple Voice Chat 服务端配置为准。
记录错误原文和发生阶段,完成一项后重复相同测试,才能确认真正有效的处理步骤。
处理前准备
- 使用支持多通道配置的 Katofrp 当前版本
- 确认 Simple Voice Chat 与加载器版本匹配
- 在房主服务端启动一次以生成配置
- 记录 Minecraft TCP 端口
- 记录语音 UDP 端口,常见默认值需以配置为准
- 备份语音配置文件
按顺序处理
- 确认游戏 TCP 映射
先让所有成员能通过 Katofrp 地址正常进入 Minecraft 世界。
- 找到语音端口
在 Simple Voice Chat 服务端配置中确认 port 字段,并检查服务端启动日志显示监听成功。
- 创建 UDP 通道
在 Katofrp 为语音端口建立 UDP 映射;不要误选 TCP。
- 记录 UDP 公网地址
复制 UDP 通道的节点主机与远程端口,端口不同就按实际值组合。
- 填写 voice_host
按当前模组文档在服务端配置中填入可供成员访问的主机:端口,并统一必要的客户端设置。
- 重启服务端
配置修改后完整重启,不只重载世界。
- 进行语音测试
两名成员进入后检查语音连接图标、按键和系统麦克风权限,再测试距离衰减。
验证与补充
TCP 与 UDP 分开
Minecraft 游戏端口和语音端口解决不同流量,协议写反会导致能进服但语音不可用。
原始地址与分享地址
voice_host 应填写成员实际能访问的 UDP 公网地址,不能填 127.0.0.1。
防火墙
精确允许 Java 和语音 UDP 端口通过房主防火墙,同时保留系统整体保护。
隐私与权限
语音模组会使用麦克风。每位玩家自行确认系统权限、输入设备和按键设置。
仍未解决时
根据当前现象选择对应分支,保留可工作的配置和存档备份。
检查 UDP 通道是否在线、端口是否与服务端配置一致,以及 voice_host 是否使用远程 UDP 地址。
该玩家检查客户端模组版本、麦克风权限、输入设备与本地防火墙。
UDP 对丢包敏感,比较节点、房主上传、Wi-Fi 和跨运营商路径。
常见问答
可以让语音和游戏共用一个端口吗?
通常不应假设可以。按模组配置分别准备游戏 TCP 与语音 UDP 端口。
所有人都要安装语音模组吗?
需要使用语音的成员通常都要安装与服务端兼容的客户端模组。
voice_host 填房主局域网 IP 吗?
异地联机应填写成员可访问的 Katofrp UDP 公网地址。