SecureRedirect

插件

· 作者 codingsushi

哈希服务器重定向服务。

0 本站下载 0 关注 更新于 9 个月前

最新 v1.1.0+1.21.x · 1.21.11 · Bukkit / Paper

一键开服(送7天)

SecureRedirect 安装指南

本指南介绍了如何安装和配置 SecureRedirect Paper 插件,以便玩家能够使用传输数据包和 Cookie 从一个服务器(“主服务器”)安全地重定向到另一个服务器(“目标服务器”)。

推荐的 Paper 版本:1.21.11(或支持 Player#transfer 的更高版本)

免责声明!!!除非服务器已设置 SRV 记录(通常仅限自建服务器),否则您必须通过端口连接服务器


1. 安装插件

1.1. 构建或下载 JAR 文件

如果您直接使用此仓库:

  1. 运行:
    gradle build
    
  2. 插件 JAR 文件将位于:
    • build/libs/SecureRedirect-1.0.2.jar

将该 JAR 文件复制到所有参与重定向的 Paper 服务器上。

1.2. 将插件放入每个服务器

对于每个 Paper 服务器(包括主服务器和目标服务器):

  1. 如果服务器正在运行,请先停止它。
  2. 将 SecureRedirect-1.0.2.jar 放入 plugins/ 文件夹中。
  3. 启动服务器一次,以生成 plugins/SecureRedirect/config.yml。

2. 配置主(源)服务器

这是玩家正常加入并运行 /redirect 命令的服务器。

编辑 主 服务器上的 plugins/SecureRedirect/config.yml。

2.1. 基本重定向目标

# 在主服务器上使用 /redirect 时将玩家发送到的位置
target-host: "your-dest-host"   # 例如 "hello.exaroton.me"
# 可选。如果省略或无效,默认为 25565。
# target-port: 25565

# 将由 /redirect gen-hash 填充
send-hash: ""

# 主服务器上不需要此项,可以留空
receive-hash: ""

# 玩家可以直连主服务器
require-transfer: false

注意事项:

  • 如果您的目标服务器使用默认端口 25565,您可以完全省略 target-port。
  • 如果您的目标服务器使用自定义端口(例如 25566),请显式设置:
    target-port: 25566
    

2.2. 来源 ID(可选)

# 此服务器在重定向玩家时使用的标识符
origin-id: "main"

# 在主服务器上,您通常允许来自任何地方的重定向,因此此列表可以保持为空
allowed-origins: []

仅当您希望限制哪些服务器允许重定向进入另一台服务器时,才需要关注 origin-id 和 allowed-origins(请参阅目标服务器配置部分)。

2.3. 生成 send-hash

在 主 服务器的游戏内作为 OP 执行,或在控制台中执行:

/redirect gen-hash

这将:

  • 生成一个随机十六进制哈希值。
  • 将其保存到 config.yml 中的 send-hash。
  • 在聊天/控制台中打印该值。

复制此值;您需要将其粘贴到 目标 服务器的 receive-hash 中。


3. 配置目标服务器

这是玩家被重定向到的服务器。

3.1. 在 server.properties 中启用传输

编辑 目标 服务器上的 server.properties:

accepts-transfers=true

然后完全重启目标服务器。

3.2. 基础 config.yml

在 dest 服务器上编辑 plugins/SecureRedirect/config.yml:

# 仅当 DEST 需要继续重定向玩家时,才需要配置 target-host/target-port。
# 对于简单的双服务器设置,可以保留默认值。
target-host: "127.0.0.1"
# 可选。如果省略或无效,则默认为 25565。
# target-port: 25565

除非希望将玩家传送得更远,否则在 DEST 上可选。

send-hash: ""

重要:必须与 MAIN 的 send-hash 匹配

receive-hash: "<粘贴来自 /redirect gen-hash 的值于 MAIN>"

此服务器在重定向玩家时使用的标识符

origin-id: "dest"

允许哪些源服务器重定向到 DEST。

确保此列表包含 MAIN 的 origin-id。

allowed-origins:

  • "main"

阻止直接加入;仅允许传输

require-transfer: true

kick-no-transfer-message: "您必须通过安全重定向加入此服务器。"

kick-bad-hash-message: "无效或缺失的重定向令牌。"


### 3.3. 编辑后重启

在 DEST 上更改 `config.yml` 后,**重启服务器**(或至少重新加载插件),以便应用新值。

</details>

---

<details>
<summary><strong>4. 使用插件</strong></summary>

### 4.1. 重定向自己

在 **main** 服务器上,作为拥有权限的玩家:

```text
/redirect

这将:

  • 从 MAIN 向你的浏览器附加一个包含 <origin-id>:<send-hash> 的 Cookie。
  • 使用 Mojang 的传输数据包将你移动到 target-host:target-port。

4.2. 重定向其他玩家

/redirect <player>

权限:

  • secureredirect.redirect – 对自己使用 /redirect。
  • secureredirect.redirect.others – 对 <player> 使用 /redirect。
  • secureredirect.genhash – 使用 /redirect gen-hash。

4.3. 轮换令牌

任何时候你想要更改密钥令牌时:

  1. 在 MAIN 上运行:
    /redirect gen-hash
    
  2. 复制新的 send-hash 值。
  3. 在 DEST 上,将 config.yml 中的 receive-hash 更新为此新值。
  4. 重启 DEST 以读取新配置。

5. 高级用法:origin-id 和 allowed-origins

插件将重定向令牌编码为:

<origin-id>:<send-hash>

在 DEST 上,当玩家通过传输加入时,插件会执行以下操作:

  1. 验证 player.isTransferred()。
  2. 读取并解析 cookie 得到 origin-id 和 hash。
  3. 检查 hash 是否与 receive-hash 匹配。
  4. 如果 allowed-origins 非空,则检查 origin-id 是否列在其中。

这允许你限制哪些服务器可以重定向到 DEST。

多源示例设置:

  • MAIN 服务器:

    origin-id: "main"
    allowed-origins: []
    
  • LOBBY 服务器:

    origin-id: "lobby"
    allowed-origins: []
    
  • DEST 服务器:

    origin-id: "dest"
    allowed-origins:
      - "main"
      - "lobby"
    

现在只有 main 和 lobby 可以向 dest 发送玩家(前提是它们的哈希值也与 receive-hash 匹配)。


6. 故障排除

6.1. 卡在“Transferring to a new server...”

如果客户端一直无法完成传输,且控制台中未显示任何错误:

  • 检查 DEST 服务器:
    • server.properties 中已设置 accepts-transfers=true。
    • 服务器必须是 Paper 1.21.x(而非 Spigot 或代理二进制文件)。
  • 检查 MAIN 服务器:
    • target-host 和 target-port 指向正确的 DEST 地址。
  • 在运行 /redirect 时观察 DEST 控制台:
    • 如果没有出现登录/加入消息,说明客户端未能连接到该服务器(可能是主机/端口限制问题)。

6.2. 直接加入仍然可以在 DEST 上生效

  • 确保在 DEST 的 config.yml 中:
    require-transfer: true
    
  • 更改配置后重启 DEST 服务器。
  • 确保在 /plugins 命令中列出了 SecureRedirect 且状态为启用。

6.3. “Invalid or missing redirect token”

  • 确认在 DEST 端:
    • receive-hash 与 MAIN 端的 send-hash 完全匹配。
  • 确认在 DEST 端:
    • allowed-origins 包含 MAIN 端的 origin-id(或者为空以允许所有来源)。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源