
非 Paper 官方项目。 PaperGuard 与 PaperMC 无关,也未获得其认可。
PaperGuard
为代理后方的服务器提供已签名且防重放的 IP 转发功能。
旧版服务器和许多插件仅支持 BungeeCord(“传统”)转发。这种转发方式没有任何保护:任何能访问后端端口的人都可以使用任意名称和 UUID(包括管理员的)加入。虽然共享令牌有所帮助,但一旦泄露,它将在所有服务器上永久有效。
PaperGuard 改为对每次登录进行签名。
功能
|
|
| 每次登录独立签名 |
对名称、UUID、IP、主机、皮肤数据、目标服务器和时间进行 HMAC-SHA256 计算。更改一个字节即可拒绝该登录。 |
| 防重放攻击 |
每次登录都包含一次性随机数(nonce),且仅在几秒内有效。录制的登录无法再次使用。 |
| 每台服务器独立密钥 |
从某个后端泄露的密钥无法打开其他后端。 |
| 故障关闭(Fail closed) |
如果未正确配置 PaperGuard,则无人可以加入,而不是所有人都能加入。 |
| 兼容旧版服务器 |
支持 Paper 1.12.2 及更高版本、Folia 和 Purpur,Java 8+。 |
| 开放协议 |
提供文档化的规范、测试向量以及 MIT 授权库,以便任何代理都能支持它。 |
使用 PaperProxy 设置
PaperProxy 开箱即用支持登录签名。
- 在代理端的
paperproxy.toml 中,将服务器设置为 PaperGuard:
[forwarding.servers]
survival = "paperguard"
- 在代理控制台中运行
paperproxy paperguard key survival。
- 将 PaperGuard 放入后端的
plugins/ 文件夹并启动一次。
- 在
plugins/PaperGuard/config.yml 中输入 server-name 和 key,在 spigot.yml 中设置 settings.bungeecord: true 然后重启。
通过代理加入的玩家可以正常进入,而直接连接的所有玩家将被踢出。
来自 PaperProxy-Bridge?这是该插件的旧名称。替换 jar 文件后,您的设置将自动迁移。
链接
MIT 许可证。由 LucasTHCR 制作。

Not an official Paper project. PaperGuard is not affiliated with or endorsed by PaperMC.
PaperGuard
Signed, replay-proof IP forwarding for servers behind a proxy.
Old servers and many plugins only work with BungeeCord ("legacy") forwarding. That forwarding has no protection at all: whoever reaches the backend port can join with any name and UUID, including your admins. A shared token helps, but once it leaks it works forever, on every server.
PaperGuard signs every single login instead.
Features
|
|
| Signed per login |
HMAC-SHA256 over name, UUID, IP, host, skin data, target server and time. Change one byte and the login is rejected. |
| Replay-proof |
Every login has a one-time nonce and is only valid for a few seconds. A recorded login cannot be used again. |
| One key per server |
A leaked key from one backend does not open the others. |
| Fail closed |
If PaperGuard is not set up, nobody can join, instead of everybody. |
| Old servers too |
Paper 1.12.2 and newer, Folia and Purpur, Java 8+. |
| Open protocol |
Documented spec, test vectors and an MIT library, so any proxy can support it. |
Setup with PaperProxy
PaperProxy signs logins out of the box.
- In
paperproxy.toml on the proxy, set the server to PaperGuard:
[forwarding.servers]
survival = "paperguard"
- In the proxy console run
paperproxy paperguard key survival.
- Put PaperGuard into the backend's
plugins/ folder and start it once.
- Enter
server-name and key in plugins/PaperGuard/config.yml, set settings.bungeecord: true in spigot.yml and restart.
Players joining through the proxy get in, everyone connecting directly is kicked.
Coming from PaperProxy-Bridge? That was the old name of this plugin. Replace the jar, your settings are taken over automatically.
Links
MIT licensed. Made by LucasTHCR.
评论 0
登录后参与评分
还没有评论,来抢沙发吧