neko-rooms 网络配置详解EPR 端口池、MUX 单端口模式与 NAT 穿透【免费下载链接】neko-roomsSelfhosted collaborative browser - room management for n.eko项目地址: https://gitcode.com/gh_mirrors/ne/neko-roomsneko-rooms 是一个开源自托管的协作浏览器房间管理系统它基于 n.eko 提供多人共享浏览器的能力。对新手来说最头疼的往往不是安装而是网络配置——端口到底开多少为什么连不上本文将以neko-rooms 网络配置为核心用通俗的语言讲透 EPR 端口池、MUX 单端口模式与 NAT 穿透三大关键概念帮你一次搞定部署。为什么 neko-rooms 的网络配置如此重要neko-rooms 的每个房间都是一个独立的 Docker 容器浏览器画面通过 WebRTC 实时传输。WebRTC 依赖 UDP 端口通信而每个房间的端口分配方式直接决定了你能开多少个房间每个房间能容纳多少用户客户端在公网/内网下能否顺利连接先看一张房间管理界面感受一下整体的管理方式一、EPR 端口池WebRTC 的临时端口仓库什么是 EPR 端口池EPREphemeral Port Range是 n.eko 为 ICE UDP 连接分配的临时端口范围。neko-rooms 默认提供59000-59999共 1000 个端口作为端口池通过环境变量NEKO_ROOMS_EPR配置默认值定义在 internal/config/room.go。EPR 端口池如何分配端口每次创建房间时neko-rooms 会根据房间的最大连接数Max connections从端口池中连续划走对应数量的 UDP 端口。例如房间最大连接数为 10则占用 10 个连续 UDP 端口端口池不够时会返回 not enough ports 错误具体的分配算法在 internal/room/ports.go 中实现它会扫描所有已存在房间的标签自动跳过已被占用的端口区间。如何调整 EPR 端口池在 docker-compose 中修改环境变量即可NEKO_ROOMS_EPR59000-59999配置建议端口池越大能开的房间越多但要注意防火墙必须放行整个端口池范围否则客户端将无法连接。二、MUX 单端口模式一房一端口的神奇开关MUX 单端口模式解决了什么问题默认模式下一个房间的 UDP 端口数 最大连接数。如果端口池只有 1000 个端口每个房间最多 50 人那最多只能开 20 个房间——端口消耗太快了。开启MUX 单端口模式NEKO_ROOMS_MUXtrue后每个房间只需 1 个 UDP 端口 1 个 TCP 端口所有连接通过端口复用MUX共享。1000 个端口可以支撑近千个房间端口利用率大幅提升。MUX 模式背后的原理开启 MUX 后neko-rooms 会把端口通过环境变量传给 n.eko 容器v2 镜像使用NEKO_UDPMUX/NEKO_TCPMUXv3 镜像使用NEKO_WEBRTC_UDPMUX/NEKO_WEBRTC_TCPMUX对应代码在 internal/types/room_api_v2.go 和 internal/types/room_api_v3.go。同时 internal/room/manager.go 会在 MUX 模式下同时暴露该端口的 UDP 和 TCP 绑定。开启 MUX 单端口模式的配置方法在 docker-compose.yml 中加入NEKO_ROOMS_MUXtrue开启后创建房间时最大连接数参数不再影响端口占用你可以在创建房间界面自由设置三、NAT 穿透让内网/云服务器上的房间可被访问为什么需要 NAT 穿透配置WebRTC 建立连接时会向客户端发送候选地址ICE candidates。如果 neko-rooms 运行在 NAT 之后如云服务器、内网 NAS客户端收到的可能是内网 IP导致无法连接。此时就需要NEKO_ROOMS_NAT1TO1指定对外可达的公网 IP。NAT1TO1 的正确配置方法NEKO_ROOMS_NAT1TO1203.0.113.10该配置会映射为 n.eko 的NEKO_NAT1TO1v2或NEKO_WEBRTC_NAT1TO1v3环境变量让客户端优先使用公网 IP 建立连接。注意不要照抄示例中的127.0.0.1那是仅供本机测试用的。生产环境务必填写客户端实际能访问的公网 IP。同时neko-rooms 默认启用 ICE LiteNEKO_ICELITEtrue进一步减少候选地址数量加速连接建立。四、推荐配置速查表场景环境变量推荐值端口池范围NEKO_ROOMS_EPR59000-59999开启单端口复用NEKO_ROOMS_MUXtrue公网 NAT 映射NEKO_ROOMS_NAT1TO1你的公网 IP外部访问地址NEKO_ROOMS_INSTANCE_URLhttps://rooms.example.com/五、常见故障排查指南问题 1客户端一直卡在连接中检查防火墙是否放行了 EPR 端口池的 UDP 端口以及NEKO_ROOMS_NAT1TO1是否填了正确的公网 IP。问题 2创建房间报 not enough ports说明 EPR 端口池不够用扩大NEKO_ROOMS_EPR范围或开启 MUX 单端口模式减少单房间端口占用。问题 3一个端口被多个房间抢占确认NEKO_ROOMS_MUXtrue后端口池应至少与房间数相同避免端口复用冲突。总结neko-rooms 的网络配置并不复杂抓住三个核心即可EPR 端口池决定房间容量上限MUX 单端口模式是提升端口利用率的利器NAT 穿透是公网访问的关键一环把这三点配置好你的 neko-rooms 就能稳定承载多人协作浏览了。如果你在部署中遇到连接问题不妨按本文的排查清单逐项检查大概率能快速定位问题所在。【免费下载链接】neko-roomsSelfhosted collaborative browser - room management for n.eko项目地址: https://gitcode.com/gh_mirrors/ne/neko-rooms创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 neko-rooms 网络配置详解：EPR 端口池、MUX 单端口模式与 NAT 穿透
neko-rooms 网络配置详解EPR 端口池、MUX 单端口模式与 NAT 穿透【免费下载链接】neko-roomsSelfhosted collaborative browser - room management for n.eko项目地址: https://gitcode.com/gh_mirrors/ne/neko-roomsneko-rooms 是一个开源自托管的协作浏览器房间管理系统它基于 n.eko 提供多人共享浏览器的能力。对新手来说最头疼的往往不是安装而是网络配置——端口到底开多少为什么连不上本文将以neko-rooms 网络配置为核心用通俗的语言讲透 EPR 端口池、MUX 单端口模式与 NAT 穿透三大关键概念帮你一次搞定部署。为什么 neko-rooms 的网络配置如此重要neko-rooms 的每个房间都是一个独立的 Docker 容器浏览器画面通过 WebRTC 实时传输。WebRTC 依赖 UDP 端口通信而每个房间的端口分配方式直接决定了你能开多少个房间每个房间能容纳多少用户客户端在公网/内网下能否顺利连接先看一张房间管理界面感受一下整体的管理方式一、EPR 端口池WebRTC 的临时端口仓库什么是 EPR 端口池EPREphemeral Port Range是 n.eko 为 ICE UDP 连接分配的临时端口范围。neko-rooms 默认提供59000-59999共 1000 个端口作为端口池通过环境变量NEKO_ROOMS_EPR配置默认值定义在 internal/config/room.go。EPR 端口池如何分配端口每次创建房间时neko-rooms 会根据房间的最大连接数Max connections从端口池中连续划走对应数量的 UDP 端口。例如房间最大连接数为 10则占用 10 个连续 UDP 端口端口池不够时会返回 not enough ports 错误具体的分配算法在 internal/room/ports.go 中实现它会扫描所有已存在房间的标签自动跳过已被占用的端口区间。如何调整 EPR 端口池在 docker-compose 中修改环境变量即可NEKO_ROOMS_EPR59000-59999配置建议端口池越大能开的房间越多但要注意防火墙必须放行整个端口池范围否则客户端将无法连接。二、MUX 单端口模式一房一端口的神奇开关MUX 单端口模式解决了什么问题默认模式下一个房间的 UDP 端口数 最大连接数。如果端口池只有 1000 个端口每个房间最多 50 人那最多只能开 20 个房间——端口消耗太快了。开启MUX 单端口模式NEKO_ROOMS_MUXtrue后每个房间只需 1 个 UDP 端口 1 个 TCP 端口所有连接通过端口复用MUX共享。1000 个端口可以支撑近千个房间端口利用率大幅提升。MUX 模式背后的原理开启 MUX 后neko-rooms 会把端口通过环境变量传给 n.eko 容器v2 镜像使用NEKO_UDPMUX/NEKO_TCPMUXv3 镜像使用NEKO_WEBRTC_UDPMUX/NEKO_WEBRTC_TCPMUX对应代码在 internal/types/room_api_v2.go 和 internal/types/room_api_v3.go。同时 internal/room/manager.go 会在 MUX 模式下同时暴露该端口的 UDP 和 TCP 绑定。开启 MUX 单端口模式的配置方法在 docker-compose.yml 中加入NEKO_ROOMS_MUXtrue开启后创建房间时最大连接数参数不再影响端口占用你可以在创建房间界面自由设置三、NAT 穿透让内网/云服务器上的房间可被访问为什么需要 NAT 穿透配置WebRTC 建立连接时会向客户端发送候选地址ICE candidates。如果 neko-rooms 运行在 NAT 之后如云服务器、内网 NAS客户端收到的可能是内网 IP导致无法连接。此时就需要NEKO_ROOMS_NAT1TO1指定对外可达的公网 IP。NAT1TO1 的正确配置方法NEKO_ROOMS_NAT1TO1203.0.113.10该配置会映射为 n.eko 的NEKO_NAT1TO1v2或NEKO_WEBRTC_NAT1TO1v3环境变量让客户端优先使用公网 IP 建立连接。注意不要照抄示例中的127.0.0.1那是仅供本机测试用的。生产环境务必填写客户端实际能访问的公网 IP。同时neko-rooms 默认启用 ICE LiteNEKO_ICELITEtrue进一步减少候选地址数量加速连接建立。四、推荐配置速查表场景环境变量推荐值端口池范围NEKO_ROOMS_EPR59000-59999开启单端口复用NEKO_ROOMS_MUXtrue公网 NAT 映射NEKO_ROOMS_NAT1TO1你的公网 IP外部访问地址NEKO_ROOMS_INSTANCE_URLhttps://rooms.example.com/五、常见故障排查指南问题 1客户端一直卡在连接中检查防火墙是否放行了 EPR 端口池的 UDP 端口以及NEKO_ROOMS_NAT1TO1是否填了正确的公网 IP。问题 2创建房间报 not enough ports说明 EPR 端口池不够用扩大NEKO_ROOMS_EPR范围或开启 MUX 单端口模式减少单房间端口占用。问题 3一个端口被多个房间抢占确认NEKO_ROOMS_MUXtrue后端口池应至少与房间数相同避免端口复用冲突。总结neko-rooms 的网络配置并不复杂抓住三个核心即可EPR 端口池决定房间容量上限MUX 单端口模式是提升端口利用率的利器NAT 穿透是公网访问的关键一环把这三点配置好你的 neko-rooms 就能稳定承载多人协作浏览了。如果你在部署中遇到连接问题不妨按本文的排查清单逐项检查大概率能快速定位问题所在。【免费下载链接】neko-roomsSelfhosted collaborative browser - room management for n.eko项目地址: https://gitcode.com/gh_mirrors/ne/neko-rooms创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考