6位码如何找到你?Emufii联机原理详解:WireGuard VPN+协调服务器架构全解析

原创2026-10-27 07:08:561,092 阅读

6位码如何找到你?Emufii联机原理详解:WireGuard VPN+协调服务器架构全解析

Emufii 是一款面向 Android 掌机的联机工具:它用一个 6 位码 把分散在世界各地的模拟器拉到"同一个房间",无需开放端口、无需共享 IP,即可实现 3DS、Switch、PSP、PS2、DS 和 Wii 的远程多人联机。下面我们从 6 位码的生成、协调服务器(Coordinator) 到 WireGuard VPN 隧道,完整拆解这套架构背后的原理。

Emufii 模拟器联机应用启动页图标

上图是 Emufii 的启动页:图标同时融合了 手柄十字键、存档(内存卡)与方向键 三元素,正暗示了它的本质——把每台设备"接入"同一个联机房间。


为什么一个 6 位码就能"拉进"同一个房间

传统联机最头疼的两件事:端口转发(端口映射) 和 公网 IP。而 Emufii 的巧妙之处在于——它把这两件事都"外包"给了两个角色:

  • 协调服务器(Coordinator):负责"发号码牌"。它不传游戏数据,只负责分配 6 位码、划分子网、登记谁在房间里、把房间信息广播出去。
  • WireGuard 中继(Relay):负责"铺网络"。所有玩家的 游戏流量 经过一条端到端加密的 VPN 隧道,让每台设备都以为自己处在同一个局域网 Wi-Fi 上。

一句话概括:码是"门牌号",协调服务器是"前台",WireGuard 是"内网"。三者配合,让模拟器完全无需改造就能联机。


核心组件:协调服务器到底干了什么

协调服务器是整套系统里唯一的"中心化"环节,但它 只搬运信令、不搬运游戏数据。它通过一组 HTTP 接口完成以下工作(客户端实现见 CoordinatorClient.kt):

接口 作用
POST /sessions(createSession) 房主创建房间,拿回 6 位码 + 子网 + 令牌(token)
POST /sessions/{code}/peers(claimAddress) 玩家提交 WireGuard 公钥,"领取"一个隧道内 IP 地址
POST /sessions/{code}/members(heartbeat) 成员心跳,报告人数、昵称、到中继的延迟
GET /sessions(listSessions) 列出当前可加入的公开房间
GET /relays(listRelays) 拉取可用中继区域,用于就近选点

会话码、子网与令牌

创建房间后,服务器返回三个关键值(见 CreatedSession):

  • code:面向玩家的 6 位码,是唯一的"公开入口"。
  • subnet:本次会话专属的私有子网,后续隧道内的 IP 都落在 10.0.0.0/8 网段。
  • token:房主的"修改凭证"。码是公开的,但 只有持 token 者才能改房间;客人拿到的成员令牌则只允许其"离开"。

6 位码的生成规则

6 位码并非随机"乱码",它的字符集经过精心设计,方便玩家 用实体按键输入(键盘上没有 0、1、I、O,避免形近混淆)。实现见 SessionCodes.kt:

  • 前 3 位:字母,取自 ABCDEFGHJKLMNPQRSTUVWXYZ(24 个字母,去掉易混的 I、O)。
  • 后 3 位:数字,取自 23456789(8 个数字,去掉易混的 0、1)。
  • 最终格式为 XXX-123,例如 KPN-482。
  • 随机源使用 SecureRandom(而非可预测的默认随机)。
  • 向下兼容:旧版本的 4 字母 + 4 数字 码(如 ABCD-2345)仍会被 normalize 接受并归一化。

💡 这意味着理论组合数为 24³ × 8³ ≈ 24 万,碰撞并不罕见——所以 EmufiiApp.kt 在房主建房时会做 最多 5 次重试:一旦服务器返回 409 Conflict(码已被占用),就重新生成一个再试。


WireGuard VPN:把全网变成一个"共享 Wi-Fi"

Emufii 复用了 Android 系统级的 VPN 能力(VpnService),在每台设备上动态生成一条 WireGuard 隧道。

密钥:一次生成,终身复用

每台设备第一次运行时会生成一对 WireGuard 公私钥 并持久保存(WgKeys.kt)。同一密钥 → 同一隧道身份。玩家把"公钥"交给协调服务器即可领取地址,私钥永远留在本机,用于加密流量。

隧道配置:一份动态生成的 ini

拿到协调服务器返回的 WgTunnelInfo(本端地址、子网、中继端点、中继公钥、允许网段)后,Emufii 渲染成一份标准 WireGuard 配置(WgConfig.render):

  • Address:本端在子网内的 IP + 掩码;
  • MTU = 1420:实测该值传输最稳(1300 以上会丢包);
  • PersistentKeepalive = 10:运营商 NAT 映射存活很短,10 秒保活防止隧道"断气";
  • 特殊照顾 PS2:它的虚拟键盘没有"点号",无法输入 IP,所以 PS2 走 DNS 解析主机名 emufii 的方式拨号(见 announceDns)。

隧道信息在写入前还有一道安全校验(checkTunnelInfo):所有地址 必须落在 10.0.0.0/8 内,防止恶意/异常配置把流量引到网段之外。

🔐 结果就是:所有玩家的游戏包都走这条 端到端加密 的私有隧道,外人无法窥探,也无需任何端口映射。


完整流程:从开机到坐下

下面以 房主建房 和 玩家加入 两条路径,还原真实链路(主流程见 EmufiiApp.kt)。

房主建房四步

  1. 选区:RelayRegions.pick 测量到各中继的延迟,自动挑最近的机房(可手动覆盖)。
  2. 建房间:createSession 申请 6 位码 + 子网 + token(撞码则重试)。
  3. 起隧道:授权 VPN → claimAddress 用公钥领地址 → 启动前台 WireGuard 服务 → 等待隧道 Online(超时 45 秒)。
  4. 上报就绪:patchSession 把房主隧道 IP 与端口写回服务器,房间对外可见。

玩家加入六步(startJoinFlow,L396)

  1. 查房间:getSession(code) 拉取远端信息;不存在则提示"会话未找到"。
  2. 三重校验:核对 游戏 Title ID 一致、DS 的 ROM 哈希 一致(差 1 字节都会导致单机)、模拟器版本 一致(不一致会弹窗询问)。
  3. 起隧道:授权 VPN → claimAddress(503 房间已满、429 请求过快)→ 等待隧道在线。
  4. 取房主 IP:房主尚未就绪时轮询等待。
  5. 发心跳:heartbeat 登记成员,拿到成员令牌。
  6. 进入会话:带着房主 IP、端口、角色(HOST/GUEST)打开对应模拟器。

中继区域:选离房主最近的机房

延迟是联机体验的生命线。RelayRegions.kt 的策略很务实:

  • 用系统 ping(无需 root)对每个中继发 3 个 ICMP 包取平均 RTT;
  • 用 15ms 容差 防止"抖动选错"——新机房必须明显更快才会接管;
  • 结果缓存 10 分钟,避免每次建房都重新测速拖慢启动;
  • 支持 手动锁定区域,搬家/出差的玩家可长期保持所选机房。

安全与隐私:HMAC 签名 + 时钟同步

客户端每次请求都会做一次 HMAC-SHA256 签名(ClientAuth.sign):

HMAC-SHA256( secret, "METHOD\n路径\n时间戳\nSHA-256(请求体)" )

签名连同时间戳一起放入请求头(X-Emufii-Auth / X-Emufii-Ts),服务器据此防重放、防篡改。

一个真实踩坑的细节:手机本地时钟若偏差过大,请求会被当作"重放"静默拒绝(403)。因此客户端会从服务器响应的 Date 头 学习时钟偏移(learnServerClock),被拒后自动用新偏移 重签重发一次。

隐私边界

  • 只有游戏流量 经过 Emufii 的网络,浏览器、聊天等都不走隧道。
  • 会话码、昵称、游戏名 仅存活于会话期间,房间结束即删。
  • 好友码永远不会 暴露给同房间的其他玩家。
  • 房间默认可设为 私有,避免陌生人"串门"。

支持的机型与对应模拟器

Emufii 本身 不是模拟器,它只负责"铺网 + 填地址",游戏仍由你已有的模拟器运行:

主机 模拟器 联机方式
Switch Eden 本地无线
3DS Azahar 本地无线
Wii / GameCube Dolphin Netplay(端口 2626)
PSP PPSSPP Ad hoc
PS2 ARMSX2 System Link / LAN
DS WatermelonDS Emufii Edition 本地无线

📌 所有玩家需使用 相同模拟器版本 + 相同游戏副本,否则画面/存档会不同步。


常见问题 FAQ

问:为什么要弹 VPN 授权? 答:Android 下动态隧道依赖系统级 VpnService。授权一次即可,且 只有游戏流量 经过这条隧道。

问:为什么我加不进去,提示"房间已满"? 答:claimAddress 返回 503 表示房间成员已达上限;429 表示请求过快,稍等片刻重试即可。

问:6 位码会不会重复? 答:会。所以建房端内置了 5 次重试机制,撞码自动换新,你无感。

问:我的游戏文件和密钥安全吗? 答:Emufii 不打包、不下载任何游戏/BIOS/密钥,也从不直连任天堂或索尼的官方服务器。


延伸阅读:关键源码位置

登录后查看全文
emufii