
端口桥接
PortBridge 是一个服务端实用模组,可自动让你的 Minecraft 服务器公开可加入
🌐 Port Bridge
Minecraft 服务器自动端口转发(Forge / NeoForge)
Port Bridge 是一个服务器端 Minecraft 模组,它通过路由器端口转发逻辑自动将你的服务器开放到互联网。 无需手动配置路由器。无需为 UPnP 感到困惑。只需启动服务器并分享加入地址即可。
本模组专为自托管服务器、家庭网络,以及希望让朋友轻松加入而无需处理网络烦恼的创作者设计。
✨ Port Bridge 的功能
当你的 Minecraft 服务器启动时,Port Bridge 将:
检测你的本地服务器端口
发现你的公网 IP 地址
尝试在你的路由器上创建临时端口转发映射(UPnP/NAT-PMP 风格逻辑)
验证该映射
显示最终的公网加入地址:
- 在服务器控制台中
- 作为 OP 广播消息(可配置)
当服务器停止时,Port Bridge 会清理端口映射,确保不留下未使用的转发规则。
🚀 主要功能
🔌 自动端口映射
- 启动时自动转发 Minecraft 服务器端口
- 无需手动登录路由器
- 完全在服务器端运行
🔁 租约 / TTL 续期
- 后台任务在端口映射过期前进行续期
- 防止长时间服务器会话期间突然断开
- 如果续期失败会记录警告
🧹 关闭时清理映射
- 服务器停止时移除端口转发
- 防止遗留或“卡住”的路由器规则
➕ 多端口支持
可选转发额外端口:
- RCON
- Query
- Web 地图
每个端口均可完全配置
🧠 强大的诊断功能
/portbridge diag命令显示:- 路由器 / 网关信息
- WAN 服务类型
- 映射状态
- 最后错误详情
有助于调试路由器兼容性
🧪 试运行模式
- 模拟端口转发而不实际更改路由器设置
- 非常适合测试和开发
- 通过
advanced.dryRun = true启用
🌍 基于配置文件 / 世界的配置
- 每个服务器配置文件或世界可使用不同的端口规则
- 适用于多实例部署
🔒 网络安全控制
- 将端口转发尝试限制在特定的本地子网
- 防止在不安全的网络上意外暴露
💬 自定义加入消息模板
控制台 + OP 消息完全可自定义
使用如下占位符:
{PUBLIC_IP}{PORT}{PROTOCOL}
示例:
🌍 Server is live! Join using: {PUBLIC_IP}:{PORT}
📜 控制台输出示例
[Port Bridge] Server port detected: 25565
[Port Bridge] Public IP resolved: 103.xxx.xxx.xxx
[Port Bridge] Port mapping successful (TCP)
[Port Bridge] Share this address:
[Port Bridge] 103.xxx.xxx.xxx:25565
🧩 支持的加载器
- ✅ Forge(服务器)
- ✅ NeoForge(服务器)
- ❌ 无需客户端
⚠️ 重要说明
- 路由器必须支持自动端口映射协议
- 部分 ISP 会封锁入站端口或使用 CGNAT
- 如果端口映射失败,模组不会使服务器崩溃
- 所有操作都会被清晰记录以保证透明度
🛠️ 使用场景
- 在家中托管服务器
- 与朋友一起游玩而无需手动端口转发
- 在动态 IP 连接上测试服务器
- 临时或短期服务器
🔐 安全理念
Port Bridge:
- 仅在服务器运行时开放端口
- 在关闭时进行清理
- 绝不会暴露超出你所配置范围的内容
- 通过配置和命令提供完全控制
📦 模组名称
Port Bridge 将你的本地服务器桥接到世界。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。