ZSFrp 文档
排障

远程端口冲突

同一 节点 上,远程端口全局唯一——任意用户的隧道都不能重复使用同一端口。提示 「端口已被占用」 即该端口在该节点已被使用。

同一 节点 上,远程端口全局唯一——任意用户的隧道都不能重复使用同一端口。提示 「端口已被占用」 即该端口在该节点已被使用。

原因

1787034290260.png

解决方法

方法一:随机 / 建议端口(推荐)

创建或编辑时点 随机,系统分配可用端口。

GET /api/v1/tunnels/suggest-remote-port?nodeId=1
Authorization: Bearer zsfrp_pat_xxx

方法二:手动换端口

建议 10000–65535,避开常见服务端口。

校验:

GET /api/v1/tunnels/check-remote-port?nodeId=1&port=23456

编辑时加 excludeTunnelId=当前隧道ID 排除自身。

响应 available: true 表示可用。

方法三:换节点

不同节点端口占用 互不影响。固定「纪念号」端口可换节点再试。

方法四:克隆

克隆 隧道到目标节点并分配新端口。见 创建隧道。

编辑时的冲突

修改 远程端口 或 迁移节点 会重新校验;仅改 本地端口 通常不触发远程冲突。

最佳实践

建议原因
开服优先「随机」最快、最少冲突
固定端口用 30000+降低撞车概率
换节点后更新地址域名与端口可能都变
勿公开完整连接串降低扫描风险

与本地端口区别

本地端口远程端口
范围本机服务监听节点对外暴露
冲突范围本机唯一同节点全局唯一
示例2556523456

相关文档

On this page