Files
ssw-mpc/docs/ZYNQ.md
T
ssw c5b2cf69a5 feat: nax-rs P0/P1/P1.5 —— Rust 重写隐私计算框架
算子核(nax-core):零依赖 no_std
- Z_2^64 定点算术 + AVX2 矩阵乘,与 Python 参考实现 215 条逐位一致
- 加性分享 / Beaver 三元组 / 截断对 / edaBit,ChaCha20 PRG,SHA-256
- 自实现银行家舍入(f64::round_ties_even 是 std-only,no_std 编不过)

协议栈
- nax-proto:手写帧协议(12 字节头 + u64 payload),无 protobuf 依赖
- nax-vault:Beaver 乘 / 定点截断 / open / reveal
- nax-node:TCP 传输 + 密文会话 + PSI 会话
- nax-psi:X25519 ECDH-PSI(唯一外部依赖 dalek,因恒定时间约束)
- nax-tee:HAL trait(seal/unseal/attest/sign)+ Mock + TrustPlan 四级降级

验收
- 83 用例全绿;armv7 全 workspace 编译通过
- 两进程密文计算:(1·4+1)+(2·5+1)+(3·6+1) = 35
- 两进程 PSI:[1..5] ∩ [3..7] = {3,4,5}
- 单二进制 450 KB,零运行时依赖

文档
- docs/ARCHITECTURE.md:分层、Ray 定位、TEE 分工与降级梯度
- docs/ZYNQ.md:A9 性能预算(比 i5 慢 8-12x,非 50x)与部署形态
2026-10-29 11:10:54 +08:00

6.7 KiB
Raw Blame History

在 Zynq-7015 上跑 nax

目标:ACZ7015(双核 Cortex-A9 @ 667 MHz)能跑基本隐私计算。 场景定位是"安全关键、计算量小、时间不敏感",不是"追性能"。

x86 + SEV-SNP 是算力上去以后的横向扩展,不是 Zynq 的替代品—— 两者用同一份 nax 二进制、同一套协议,只是规模档位不同。


1. 它能跑什么(性能预算)

数字来自本机实测(i5-5250U @ 2.7 GHz Turbo)按 IPC 折算到 A9: A9 是双发射顺序核,Broadwell 是四发射乱序核,同频大约慢 2.5–3×, 再算上主频差(667 MHz vs 2.7 GHz Turbo)约 4×,合计 8–12×。

负载 i5 实测 A9 估算 判断
matmul 64³ u64 0.26 ms ~2.5 ms ✅ 随便跑
matmul 128³ 2.2 ms ~22 ms ✅
逐元素乘 100 万元素 ~3.6 ms ~35 ms ✅
纵向 LR 400×7 × 40 轮 ~15 ms ~150 ms ✅ 秒级
PSI 1 万条(2×X25519) — ~8–15 s ✅ 可接受
PSI 10 万条 — ~2 min ⚠️ 能跑但慢
Paillier 1024 位 × 1000 元素 ~0.1 s(Rust 估) ~1–2 s ✅
Paillier 1024 位 × 1 万 ~1 s ~15 s ⚠️
密文 MLP(256³ × 150 轮) 18 ms×150 = 2.7 s ~40 s/轮 → 不可行 ❌ 上 x86

结论:Zynq 适合 PSI / 安全统计 / 小规模纵向 LR / 密钥管理与策略执行。 不适合大矩阵密文训练——那类负载直接上 x86。

注意上表是推算,不是板上实测。真数字要等第一次上板跑 nax selftest 与一个 64³ matmul 基准。不要拿推算当验收结论。


2. 交叉编译

目标三元组:armv7-unknown-linux-gnueabihf(板子是 armv7 hard-float)。

rustup target add armv7-unknown-linux-gnueabihf

# 只验类型(不需要 linker,几秒钟,适合 CI)
cargo check --workspace --target armv7-unknown-linux-gnueabihf

# 真出二进制:需要一个 arm 交叉 linker
export CARGO_TARGET_ARMV7_UNKNOWN_LINUX_GNUEABIHF_LINKER=arm-linux-gnueabihf-gcc
cargo build --release -p nax-cli --target armv7-unknown-linux-gnueabihf

macOS 上没有 arm-linux-gnueabihf-gcc,出二进制要在 Linux 上做 (沙箱 / HK 服务器 / 板子本机编译都行)。

已知约束(都是已经踩过或必须防的):

约束 原因 守它的方式
nax-core 必须 no_std 要能编进 TA cargo build -p nax-core --no-default-features
不能用 f64::round_ties_even std-only,no_std 编不过 已自实现银行家舍入
不能假设 AVX2/NEON A9 有 NEON 但 64 位整数乘用不上 simd 是可选 feature,默认标量
栈只有 8–32 KB(TA 内) OP-TEE TA 的栈很小 nax-core 所有临时缓冲上限 64 个 u64

3. 两种部署形态

形态 A:普通 world + TEE 管密钥(推荐先做)

┌─────────────────────── Linux (normal world) ───────────────────────┐
│  nax node  ── 分片计算、TCP、审计日志                              │
│      │                                                              │
│      └── /dev/tee0 ──▶ OP-TEE ──▶ TA:seal/unseal/attest/sign      │
└────────────────────────────────────────────────────────────────────┘
  • 计算在普通 world:A9 的双核都能用,内存不受 secure world 限制。
  • 密钥与策略在安全 world:会话主种子、设备绑定密钥、出域判定签名。
  • 攻击面:宿主 root 能读到明文和分片,但读不到密钥,也伪造不了 attestation。

这条路径能立刻验证,且复用 ../op-tee-test 已经跑通的 syvault-core(HKDF 派生 + AES-GCM 密封 + 设备 DNA 绑定)。

形态 B:计算进 TA(只在极小规模可行)

把分片计算搬进 TA 的收益是"宿主彻底看不到分片",代价是:

  • TA 是单线程、无文件系统、栈很小;
  • secure world 内存通常只有几 MB,装不下大矩阵;
  • 每次 TEEC_InvokeCommand 有固定开销(微秒到毫秒级)。

只建议:把 nax-core 的比较/排序/小规模聚合这类 "数据量 KB 级、但泄露后果严重"的算子放进 TA。 不要指望在 TA 里跑 256³ 矩阵乘。


4. 上板步骤(待执行)

# 1. 在 Linux 上交叉编译
cargo build --release -p nax-cli --target armv7-unknown-linux-gnueabihf

# 2. 拷到板子(假设 ssh 可达)
scp target/armv7-unknown-linux-gnueabihf/release/nax root@<board>:/usr/local/bin/

# 3. 板上自检(不依赖网络,纯算子核 + TEE mock)
nax selftest

# 4. 板上跑两进程会话(本机 loopback,验证协议栈)
nax node --site bob   --sites alice,bob --listen 127.0.0.1:9444 --data 4,5,6 &
nax node --site alice --sites alice,bob --connect 127.0.0.1:9444 --data 1,2,3
# 期望两侧都输出:会话结果: 35

验收判据(三条,缺一不可):

  1. nax selftest 四项全过 —— 说明算子核在 armv7 上数值正确 (尤其银行家舍入与 u64 回绕,这两处在 32 位架构上最容易出偏差)。
  2. 两进程会话得到 35 —— 说明帧协议、TCP、Beaver 协议栈在板上成立。
  3. nax selftest 的耗时 —— 这是唯一的性能实测基线,记下来, 后续所有规模判断都从它推算,而不是从 i5 的数字猜。

5. 与 x86 + SNP 的分工

Zynq-7015 x86 + SEV-SNP
定位 边缘节点 / 数据源侧 / 密钥守门 计算节点
优势 TEE 天然在板上、低功耗、便宜、可离线 算力、内存带宽、大矩阵
适合 PSI、安全统计、小 LR、策略执行 密文训练、大 SQL、批量 Paillier
不适合 大矩阵、10 万级 PSI 现场部署、低功耗场景

同一份二进制、同一套协议,靠 TrustPlan 决定这一轮走 MPC 还是 "双方 TEE 互验后明文直算"(见 docs/ARCHITECTURE.md §4.3 的 L2)。

配置方式(规划中):

# nax-cluster.yaml
sites:
  edge-a: { kind: optee,  addr: 10.0.0.11:9443 }
  edge-b: { kind: optee,  addr: 10.0.0.12:9443 }
compute:
  kind: sev-snp
  addr: 10.0.1.10:9443
trust_plan: TeeAssisted      # 边侧有 TEE,计算节点独立

6. 还没做的(诚实清单)

  • 板上实测性能数字(上表全是推算)
  • nax-tee 的 OP-TEE 实现(复用 op-tee-test/src/vault-core)
  • TA 侧的最小算子(比较、聚合)
  • NEON 优化(A9 的 NEON 对 64 位整数乘帮助有限,但要试)
  • 交叉编译产物的 CI 校验(目前只 check 不 build)