端口桥接

端口桥接

PortBridge 是一个服务端实用模组,可自动让你的 Minecraft 服务器公开可加入

管理

🌐 Port Bridge

Minecraft 服务器自动端口转发(Forge / NeoForge)

Port Bridge 是一个服务器端 Minecraft 模组,它通过路由器端口转发逻辑自动将你的服务器开放到互联网。 无需手动配置路由器。无需为 UPnP 感到困惑。只需启动服务器并分享加入地址即可。

本模组专为自托管服务器、家庭网络,以及希望让朋友轻松加入而无需处理网络烦恼的创作者设计。


✨ Port Bridge 的功能

当你的 Minecraft 服务器启动时,Port Bridge 将:

  1. 检测你的本地服务器端口

  2. 发现你的公网 IP 地址

  3. 尝试在你的路由器上创建临时端口转发映射(UPnP/NAT-PMP 风格逻辑)

  4. 验证该映射

  5. 显示最终的公网加入地址:

    • 在服务器控制台中
    • 作为 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 将你的本地服务器桥接到世界。