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

解决方法
方法一:随机 / 建议端口(推荐)
创建或编辑时点 随机,系统分配可用端口。
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+ | 降低撞车概率 |
| 换节点后更新地址 | 域名与端口可能都变 |
| 勿公开完整连接串 | 降低扫描风险 |
与本地端口区别
| 本地端口 | 远程端口 | |
|---|---|---|
| 范围 | 本机服务监听 | 节点对外暴露 |
| 冲突范围 | 本机唯一 | 同节点全局唯一 |
| 示例 | 25565 | 23456 |