
鞋网
SneakerNet是一个NeoForge模组,通过手动交换的ECC加密JSON凭证,实现Minecraft服务器之间安全的物理隔离物品传输,无需实时网络连接。
SneakerNet
一个实验性的 Minecraft 1.21.1 NeoForge 模组,用于在服务器之间转移物品。
简体中文文档见 README.md
概述
SneakerNet 是一个安全的模组,它采用物理介质(“SneakerNet”)的方法在 Minecraft 服务器之间移动物品。它使用 ECC P-256 非对称加密(ECDH 密钥协商 + ECDSA 数字签名 + AES-256-GCM 加密)来保证物品传输的身份验证、防篡改和重放保护。
物品被导出为加密的凭证(JSON 格式)。玩家手动将文件携带到其他服务器并导入——服务器之间无需实时网络连接。
版本
- v0.5.0 — ECC P-256 非对称加密升级
- 模组 ID:
sneakernet - 运行环境: NeoForge 21.1.219+ / Minecraft 1.21.1 / Java 21
工作流程
SneakerNet 的核心思路是“互相信任对方的公钥”。管理员首先在各服务器上生成密钥并交换公钥;玩家随后绑定目标服务器并使用票据来转移物品。
简化的公钥交换(推荐:直接粘贴密钥)
服务器 A 服务器 B
│ │
├─ /sneakernet keygen ├─ /sneakernet keygen
│ → 生成密钥,自动信任自身 │ → 生成密钥,自动信任自身
│ → 打印可点击复制的公钥 │ → 打印可点击复制的公钥
│ │
│ (将 A 的公钥发送给 B 的管理员) ─→ │
│ ←─── (将 B 的公钥发送给 A 的管理员) │
│ │
├─ /sneakernet trustkey B <B 的公钥> ├─ /sneakernet trustkey A <A 的公钥>
│ │
▼ ▼
A 服上的玩家: B 服上的玩家:
├─ /sneakernet serverlist 查看受信任的服务器
├─ /sneakernet bind B 绑定目标服务器
├─ 用票据右键点击容器 → 加密导出至 voucher.json
│ (自动同步到客户端)
│ (将 json 文件发送到你在 B 服的自己) ─→
│ ├─ /sneakernet import → 兑换包裹物品
keygen命令打印的公钥在聊天中是可点击复制的。将其发送给其他管理员,对方只需一条trustkey命令即可完成信任——无需文件传输。如果你更喜欢文件方式,可以使用showpub导出公钥 JSON,并让对方用trust <名称> <文件>导入。
命令
不确定命令如何工作?随时输入
/sneakernet help(命令可以点击填入聊天栏)。
玩家命令
| 命令 | 描述 | 权限 |
|---|---|---|
/sneakernet help |
显示所有命令的描述 | 所有玩家 |
/sneakernet serverlist |
查看受信任的服务器名称列表 | 所有玩家 |
/sneakernet bind <名称> |
绑定目标服务器(使用票据前需要) | 所有玩家 |
/sneakernet bind clear |
清除目标服务器绑定 | 所有玩家 |
/sneakernet import |
扫描并上传所有本地客户端凭证 | 所有玩家 |
/sneakernet import <文件名> |
上传指定的凭证文件 | 所有玩家 |
管理员命令
| 命令 | 描述 | 权限 |
|---|---|---|
/sneakernet keygen |
生成/更新此服务器的密钥对,自动信任自身,并打印可复制的公钥 | OP (等级 2) |
/sneakernet showpub |
将此服务器的公钥导出为 JSON 文件(用于文件交换) | OP (等级 2) |
/sneakernet trust <名称> <文件> |
从公钥 JSON 文件导入信任 | OP (等级 2) |
/sneakernet trustkey <名称> <公钥> |
通过直接粘贴对方公钥 (Base64) 来建立信任 | OP (等级 2) |
/sneakernet rename <旧名称> <新名称> |
重命名一个受信任的服务器 | OP (等级 2) |
/sneakernet untrust <名称> |
移除一个受信任的服务器 | OP (等级 2) |
/sneakernet list |
列出所有受信任服务器的详细信息(KeyID、指纹) | OP (等级 2) |
管理员快速入门
/sneakernet keygen— 生成此服务器的密钥。它会自动信任本地服务器(默认名称为“当前服务器”)并在聊天中打印可复制的公钥。- 将你的公钥发送给其他服务器的管理员,并索要他们的公钥。
- 信任对方的公钥(选择一种方式):
- 选项 A · 命令信任:
/sneakernet trustkey <对方服务器名称> <对方公钥>— 一行搞定。 - 选项 B · JSON 文件导入: 请见下方的“手动 JSON 导入”。
- 选项 A · 命令信任:
- 使用
/sneakernet list验证,如有需要则用/sneakernet rename重命名。
手动 JSON 导入(当密钥太长无法发送,或命令方块被禁用时)
一个 ECC 公钥 Base64 字符串相当长,单条聊天消息上限为 256 个字符,因此你不能直接粘贴完整的公钥。如果你也没有可用的命令方块(某些服务器禁用了命令方块——见下面的注释),则改用文件交换:
- 导出方 运行
/sneakernet showpub,这将在config/sneakernet/local_pub.json写入一个公钥文件,格式如下:
{
"serverName": "...",
"keyId": "...",
"publicKeyBase64": "<完整公钥,不受 256 字符聊天限制>",
"fingerprint": "..."
}
- 通过任何带外渠道(聊天应用/邮件/云盘/U 盘等)将此
local_pub.json文件发送给其他管理员。 - 接收方 将收到的文件放入自己的
config/sneakernet/目录。建议重命名以表明来源,例如serverA_pub.json。 - 接收方 运行
/sneakernet trust <对方服务器名称> <文件名>,例如:
/sneakernet trust ServerA serverA_pub.json
<文件名>是相对于config/sneakernet/目录的路径——仅提供文件名即可。
- 双方完成以上步骤后,使用
/sneakernet list确认对方服务器现在出现在受信任列表中。
关于命令方块:像
trustkey/trust这样的 OP 命令可以在命令方块中运行——命令方块默认以权限等级 2(相当于 OP)运行,并且命令方块的输入框没有 256 字符的聊天限制,因此可以容纳完整的公钥。前提条件是服务器启用了命令方块(server.properties中的enable-command-block=true)。如果命令方块被禁用,请使用上面的“手动 JSON 导入”方法。
玩家快速入门
/sneakernet serverlist— 查看此服务器已经信任哪些目标服务器。/sneakernet bind <目标服务器名称>— 绑定你想要运送物品到的服务器。- 使用票据右键点击一个装满物品的容器以导出凭证(文件将同步到你的客户端,位于
.minecraft/sneakernet/vouchers/)。 - 将凭证文件携带到目标服务器(只需用同一客户端登录),然后运行
/sneakernet import兑换一个包裹。右键点击放置它,即可恢复容器及其物品。
物品
| 物品 | 获取方式 | 用途 |
|---|---|---|
| SneakerNet 票据 | 合成: 8 纸 + 1 墨囊 → 8 | 右键点击容器,将其内容加密并导出为 JSON 凭证 |
| SneakerNet 包裹 | 通过 /sneakernet import 获得 |
右键点击放置,恢复容器内容 |
安全机制
| 机制 | 实现方式 | 描述 |
|---|---|---|
| 非对称加密 | ECC P-256 (secp256r1) | 每个服务器独立的密钥对;无共享主密钥 |
| 前向安全性 | 每次导出生成临时 ECC 密钥对 | 私钥泄露不会危及历史凭证 |
| 数字签名 | ECDSA (SHA256withECDSA) | 防篡改、防伪造 |
| 数据加密 | AES-256-GCM + HKDF 密钥派生 | 传输中的容器 NBT 数据加密 |
| 双重花费保护 | JSON 文件黑名单 (blacklist.json) |
已兑换的凭证无法再次使用 |
| 玩家绑定 | UUID 匹配(可选) | 可要求导出者和导入者为同一玩家 |
| TTL 过期 | Unix 时间戳比较 | 凭证在超时后自动过期 |
构建
./gradlew build
构建产物: build/libs/sneakernet-0.5.0.jar
配置
服务器配置文件: sneakernet-server.toml(在 world/serverconfig/ 下生成)
| 选项 | 默认值 | 描述 |
|---|---|---|
voucherTtlHours |
24 | 凭证有效期(小时) |
maxItemsPerVoucher |
1728 | 每个凭证的最大物品数量 |
requirePlayerMatch |
true | 用户是否必须与导出者匹配 |
debugMode |
false | 调试模式 |
目录结构
config/sneakernet/ # 服务端密钥和配置目录
├── local_key.der # 本地 ECC 私钥 (PKCS#8 DER)
├── local_pub.der # 本地 ECC 公钥 (X.509 DER)
├── local_pub.json # 导出的公钥文件(用于交换)
├── trusted_keys.json # 受信任的服务器公钥列表
└── blacklist.json # 已兑换的凭证黑名单
.minecraft/sneakernet/ # 客户端目录
├── vouchers/ # 待导入的凭证
└── redeemed/ # 已兑换的凭证文件
网络协议
| 数据包 | 方向 | 描述 |
|---|---|---|
VoucherSyncPayload |
S2C | 导出成功后,将凭证 JSON 同步到客户端 |
ImportVoucherPayload |
C2S | 客户端将凭证 JSON 上传到服务器 |
ImportResultPayload |
S2C | 服务器返回导入结果,触发客户端兑换 |
依赖项
- 纯 Java 标准库 + Gson — 零外部运行时依赖
- NeoForge 内置 API — 所有模组注册、事件和网络均使用原生 NeoForge API
许可证
本项目采用 GPLv3 许可证。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。