6位码如何找到你?Emufii联机原理详解:WireGuard VPN+协调服务器架构全解析
6位码如何找到你?Emufii联机原理详解:WireGuard VPN+协调服务器架构全解析
Emufii 是一款面向 Android 掌机的联机工具:它用一个 6 位码 把分散在世界各地的模拟器拉到"同一个房间",无需开放端口、无需共享 IP,即可实现 3DS、Switch、PSP、PS2、DS 和 Wii 的远程多人联机。下面我们从 6 位码的生成、协调服务器(Coordinator) 到 WireGuard VPN 隧道,完整拆解这套架构背后的原理。
上图是 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)。
房主建房四步
- 选区:
RelayRegions.pick测量到各中继的延迟,自动挑最近的机房(可手动覆盖)。 - 建房间:
createSession申请 6 位码 + 子网 + token(撞码则重试)。 - 起隧道:授权 VPN →
claimAddress用公钥领地址 → 启动前台 WireGuard 服务 → 等待隧道Online(超时 45 秒)。 - 上报就绪:
patchSession把房主隧道 IP 与端口写回服务器,房间对外可见。
玩家加入六步(startJoinFlow,L396)
- 查房间:
getSession(code)拉取远端信息;不存在则提示"会话未找到"。 - 三重校验:核对 游戏 Title ID 一致、DS 的 ROM 哈希 一致(差 1 字节都会导致单机)、模拟器版本 一致(不一致会弹窗询问)。
- 起隧道:授权 VPN →
claimAddress(503房间已满、429请求过快)→ 等待隧道在线。 - 取房主 IP:房主尚未就绪时轮询等待。
- 发心跳:
heartbeat登记成员,拿到成员令牌。 - 进入会话:带着房主 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/密钥,也从不直连任天堂或索尼的官方服务器。
延伸阅读:关键源码位置
- 6 位码生成:Session.kt
- 协调服务器客户端:CoordinatorClient.kt
- WireGuard 配置渲染:WgConfig.kt
- WireGuard 密钥管理:WgKeys.kt
- 中继区域选择:RelayRegions.kt
- HMAC 签名与时钟同步:ClientAuth.kt
- 建房 / 加入主流程:EmufiiApp.kt
- 自动配置说明:ARMSX2-AUTOCONFIG.md、PPSSPP-AUTOCONFIG.md
- 兼容游戏清单:COMPATIBLE-GAMES.md
