- 新 workspace 成员 examples/(crate mpc-examples,publish = false):一场景一 bin, 跑法 cargo run -p mpc-examples --bin 03_vertical_lr;src/lib.rs 只提供参与方启动、 定点编解码、输出与断言,算法全在正文,调的是 mpc-* 真接口 - 12 个场景:01 密文四则/矩阵/sigmoid、02 PSI、03 纵向 LR、04 FedAvg、05 出域策略、 06 DP-FedAvg、07 密文推理、08 PIR、09 SCQL、10 分箱 WOE/IV、11 试跑、12 两方部署 - 12 的部署物在 examples/12_k8s_two_party/:多阶段 Dockerfile + namespace / alice(Headless Service + Job,--listen)/ bob(Job,--connect)+ README; 单二进制一条 TCP,不经 Ray,调度交给 k8s - tools/ci.sh 加第 4 关「示例冒烟」,调新增的 tools/examples.sh:逐 bin 跑, 判据为退出码 0 且输出无 [!!](check() 只打印不中断,只看退出码会漏断言) - 正文记录三条实测契约:matmul_trunc 两入参都须是分片,否则结果翻倍; sigmoid_poly 只在 ±6 内有效,越界发散到 1e6;多项式输出须先 reveal 再解码 - 实测:07 密文与明文偏差 1.97e-5 且 AUC 一致;09 密态与明文逐组一致; 11 同为 4 组 GROUP BY,逐组比较 156 轮 vs 整数码 23 轮
示例 12:在 Kubernetes 上起两个参与方
本例是 mpc 的真实分布式形态:两个参与方各跑在一个 Pod 里,密文分片只留在
自己的 Pod,明文不出域。业务代码与单机演示完全一致,变的只有 transport
(Pipe → TcpTransport)。
与 Python 版 nax 的 12_k8s_two_party 最大的不同:mpc 不需要 Ray。单二进制 +
一条 TCP 就够了,Ray 那套 --resources={"alice_node":1} 的资源打标在这里是多余的。
架构
┌──────────────────────── mpc-demo namespace ────────────────────────┐
│ │
│ Job mpc-alice Job mpc-bob │
│ ┌──────────────────────┐ ┌──────────────────────┐ │
│ │ mpc node │ │ mpc node │ │
│ │ --site=alice │◀── TCP ──────│ --site=bob │ │
│ │ --listen 0.0.0.0:9449 │ --connect ...:9449 │ │
│ │ --data=1,2,3,4 │ │ --data=5,6,7,8 │ │
│ └──────────────────────┘ └──────────────────────┘ │
│ ▲ │
│ │ Headless Service mpc-alice:9449 │
│ └── bob 通过 DNS 直连 Pod IP,不经 kube-proxy 转发 │
└────────────────────────────────────────────────────────────────────┘
两边挂同一个 Secret 做 PSK 认证;没配 PSK 也能跑,但既不认证身份也不加密链路。
文件
| 文件 | 作用 |
|---|---|
Dockerfile |
多阶段构建,产出只含 mpc 二进制的 debian-slim 镜像 |
k8s/00-namespace.yaml |
命名空间 mpc-demo |
k8s/10-alice.yaml |
被动方:Headless Service + Job(--listen) |
k8s/20-bob.yaml |
主动方:Job(--connect) |
../src/bin/12_k8s_two_party.rs |
本地等价演练 + 清单自检(cargo run -p mpc-examples --bin 12_k8s_two_party) |
跑起来
# 0) 先本地确认应该看到什么(秒级,不需要集群)
cargo run -p mpc-examples --bin 12_k8s_two_party
# → 期望值 74 / 密态结果 74,清单自检全绿
# 1) 构建镜像(上下文必须是仓库根目录)
docker build -f examples/12_k8s_two_party/Dockerfile -t mpc:demo .
# 2) 建 PSK
kubectl create namespace mpc-demo
kubectl -n mpc-demo create secret generic mpc-psk \
--from-literal=psk=$(openssl rand -hex 32)
# 3) 部署
kubectl apply -f examples/12_k8s_two_party/k8s/
# 4) 看结果 —— 两个 Job 的日志里都应该是 74
kubectl -n mpc-demo logs job/mpc-alice
kubectl -n mpc-demo logs job/mpc-bob
# 5) 清理
kubectl delete ns mpc-demo
backoffLimit 让 bob 在 alice 还没起来时自动重试,不需要 initContainer 轮询。
部署注意要点
--sites顺序决定 party 下标。两边必须逐字一致(alice,bob不能写成bob,alice), 否则两边对「谁是 0 号」的理解不同,第一个open就会拿到长度对不上的帧。--fxp必须一致。18 和 16 混用会在第一个算子报尺度不符,而不是在握手时报错。- 域分隔标签变更 = 换钥。从
nax/*切到mpc/*(v0.2.0)后,旧的 TEE blob、 PSI 缓存、离线物料全部作废;两方必须同步升级,没有双读兼容。 - 内存与 CPU 很小。这一课只跑 4 个元素的会话,512Mi 绰绰有余;真实任务要按 矩阵规模 × 列数估算,MPC 的中间态是数据量的数倍。
- 只绑内网。
--listen 0.0.0.0在 Pod 里没问题(Pod 网络本身就是隔离的), 但把 Service 暴露成NodePort/LoadBalancer就等于把 MPC 端口放到公网。 - 镜像可以先不推仓库。单节点集群(kind / k3s / OrbStack)与 docker 共享镜像库,
imagePullPolicy: IfNotPresent直接吃本地mpc:demo。
为什么不用 Ray
deploy/ray/ 里有一套 Ray 适配,但那条路的收益在调度(把 N 个参与方分到 N 台机器),
代价是引入一个 Python 运行时和一套 GCS。k8s 已经把调度做完了,剩下的只是「两个进程
互相连一条 TCP」——mpc node 原生就会,不需要中间层。