鞋网

鞋网

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)

管理员快速入门

  1. /sneakernet keygen — 生成此服务器的密钥。它会自动信任本地服务器(默认名称为“当前服务器”)并在聊天中打印可复制的公钥。
  2. 将你的公钥发送给其他服务器的管理员,并索要他们的公钥。
  3. 信任对方的公钥(选择一种方式):
    • 选项 A · 命令信任: /sneakernet trustkey <对方服务器名称> <对方公钥> — 一行搞定。
    • 选项 B · JSON 文件导入: 请见下方的“手动 JSON 导入”。
  4. 使用 /sneakernet list 验证,如有需要则用 /sneakernet rename 重命名。

手动 JSON 导入(当密钥太长无法发送,或命令方块被禁用时)

一个 ECC 公钥 Base64 字符串相当长,单条聊天消息上限为 256 个字符,因此你不能直接粘贴完整的公钥。如果你也没有可用的命令方块(某些服务器禁用了命令方块——见下面的注释),则改用文件交换:

  1. 导出方 运行 /sneakernet showpub,这将在 config/sneakernet/local_pub.json 写入一个公钥文件,格式如下:
{
  "serverName": "...",
  "keyId": "...",
  "publicKeyBase64": "<完整公钥,不受 256 字符聊天限制>",
  "fingerprint": "..."
}
  1. 通过任何带外渠道(聊天应用/邮件/云盘/U 盘等)将此 local_pub.json 文件发送给其他管理员。
  2. 接收方 将收到的文件放入自己的 config/sneakernet/ 目录。建议重命名以表明来源,例如 serverA_pub.json。
  3. 接收方 运行 /sneakernet trust <对方服务器名称> <文件名>,例如:
/sneakernet trust ServerA serverA_pub.json

<文件名> 是相对于 config/sneakernet/ 目录的路径——仅提供文件名即可。

  1. 双方完成以上步骤后,使用 /sneakernet list 确认对方服务器现在出现在受信任列表中。

关于命令方块:像 trustkey/trust 这样的 OP 命令可以在命令方块中运行——命令方块默认以权限等级 2(相当于 OP)运行,并且命令方块的输入框没有 256 字符的聊天限制,因此可以容纳完整的公钥。前提条件是服务器启用了命令方块(server.properties 中的 enable-command-block=true)。如果命令方块被禁用,请使用上面的“手动 JSON 导入”方法。

玩家快速入门

  1. /sneakernet serverlist — 查看此服务器已经信任哪些目标服务器。
  2. /sneakernet bind <目标服务器名称> — 绑定你想要运送物品到的服务器。
  3. 使用票据右键点击一个装满物品的容器以导出凭证(文件将同步到你的客户端,位于 .minecraft/sneakernet/vouchers/)。
  4. 将凭证文件携带到目标服务器(只需用同一客户端登录),然后运行 /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 许可证。