feat(tee): 固化真机双机重跑环境,补齐预检与症状速查,避免每次从零探索

核实结论:这两天 AMD / 海光真机测试内容**早已在仓库** —— 36 个脚本、
288 行复现 README、630 行 FINDINGS、nodes 真机路径样例、fixtures 真实
CSV/SNP 报告与证书链。真正导致「每次重跑重新拼」的只有三处缺口:
参数散在 5+ 个脚本头部、没有预检、踩坑结论按探索时间组织不好按症状查。

- 新增 real-machines.env.example:2026-11-08 证明门控 + 双 guest 会话合流
  跑通那组值的脱敏快照。28 个变量与脚本 ${VAR:-default} 逐字一致(已自动
  核对,无一处笔误);凭据只放 xop 键名;区分组级与编排层实例级变量,
  运行时生成项明确标注「不要手填」。
- 新增 preflight-real-machine.sh:本地工具 / xop 键 / 参数一致性 / SSH /
  远端物料一次性报缺;缺环境显式 SKIP 或 FAIL,不静默通过;
  --self-test 用 6 个构造样例逐条破坏参数判据(7/7),证明非恒绿。
  只查环境,不产生 TEE_PAIR_OK 之类业务结论。
- README 增「重跑前先看」:三步重跑、参数真相源、17 条症状→根因→处置
  速查表、/tmp 60+ 探索脚本处置说明(过程产物,结论已沉淀,不许重跑确认)。
- INDEX §2/§3/§6 与 CLAUDE.md 登记;.gitignore 屏蔽本地实际 env 配置。

校验:bash -n、lint-shell-vars 33 脚本无隐患、预检自测 7/0、离线实跑
ok=15 SKIP=1 FAIL=0、判据零依赖自测 22/0、diff --check、路径与密钥扫描
全过。未改 tools/ci.sh,门禁条数仍为 22。
This commit is contained in:
admin committed 2026-11-08 19:41:31 +08:00
1 parent c51190b20c
commit fc0dcec93b
6 files changed
+416 -4

No files matched your search

+4
View File
@@ -37,3 +37,7 @@ __pycache__/
# FISCO 节点二进制 52M,不进 git;由 build-and-push.sh 从 FISCO_BIN 拷进临时 context
deploy/k8s/fisco/*.bin
# 真机本地实际配置(从 real-machines.env.example 复制后按现场改;只放 xop 键名,
# 但仍可能含现场 IP / 内部路径,不进 git)。仓库只留脱敏样例。
deploy/tee/real-machine/real-machines.env
+7 -1
View File
@@ -490,7 +490,13 @@ AMD SNP(alice)+ 海光 CSV(bob)两侧**各自**完成
**部署与复现**
- `deploy/k8s/fisco/README.md` — 链迁 k8s 的 SOP、账本迁移、持久化证据、回滚与边界
- `deploy/tee/real-machine/README.md` — 真机证明门控 + 双 guest 会话 e2e 复现
- `deploy/tee/real-machine/README.md` — 真机证明门控 + 双 guest 会话 e2e 复现;
**开头「重跑前先看」** 有重跑三步、参数真相源、症状 → 根因 → 处置速查表
- `deploy/tee/real-machine/real-machines.env.example` — **双机参数唯一集中入口**
(IP / xop 键名 / MAC / 网段 / 端口 / 超时),脱敏可 source;换机器改这一份,
别逐个脚本 export。`real-machines.env` 是本地实际配置,已 gitignore
- `deploy/tee/real-machine/preflight-real-machine.sh` — 重跑前一次性报缺
(工具 / xop 键 / 参数一致性 / 远端物料);`--self-test` 负向矩阵,缺环境显式 SKIP/FAIL
- `demo/k8s/README.md` — 站点部署与 PVC 持久化
- `tools/fisco-realnode/README.md` — 真链复现工具索引、环境变量、审计轨迹、密钥边界
+65
View File
@@ -4,6 +4,71 @@
xop 键名经环境变量注入,PSK / seed / 根密钥由 KBS 下发(或离线演练层),
仓库里只有占位值与示例节点描述。
## 重跑前先看(2026-11-08 起)
**脚本、判据、真机样例都已经在仓库里**,别再去 `/tmp` 翻旧脚本或重新拼参数:
36 个脚本 + `nodes/*.node.example`(真机 qemu / 固件 / 内核路径 / TCB)
+ `fixtures/`(真实 CSV 报告 2548B、SNP 报告、两侧证书链、采集时的 `session.env`)。
前两天「每次从零调整」的根源只有三个:参数散在 5+ 个脚本头部、没有预检、
踩坑结论按探索时间写在 630 行文档里不好按症状查。这三处已补齐:
### 三步重跑
```bash
cd deploy/tee/real-machine
cp real-machines.env.example real-machines.env # 已 gitignore,按现场改
set -a; . ./real-machines.env; set +a
./preflight-real-machine.sh # 一次性报缺:工具 / xop 键 / 参数 / 远端物料
./tee-pair-attest-e2e.sh # 一键:编译 → OCI → 双 KBS → 双 guest → 双判据
./tee-pair-attest-negative.sh # 负向:证明被拒 ⇒ 拿不到密钥
```
- **`real-machines.env.example` 是参数的唯一集中入口**:IP / xop 键名 / MAC / 网段 /
端口 / 超时全在里面,变量名与脚本 `${VAR:-default}` 逐字一致。换机器改这一份,
**不要逐个脚本 export**。凭据只放 xop 键名,不放明文口令。
- **`preflight-real-machine.sh` 只查环境,不判业务**:`TEE_PAIR_OK` /
`TEE_ATTEST_GATE_OK` 仍只由 `check-pair-verdict.py` / `check-attest-verdict.py` 判定。
`--skip-remote` 离线查、`--self-test` 用 6 个构造样例逐条破坏参数判据(非恒绿)。
缺环境一律显式 `SKIP` / `FAIL`,不静默当通过。
- 编排层生成的变量(`MPC_TEE_MPC_BIN` / `MPC_TEE_MANIFEST` / `MPC_KBS_PLATFORM` /
`MPC_KBS_TOKEN_KEY_FILE` …)**不要手填**,见 env 样例 H 段。
### 症状 → 根因 → 处置(速查)
调环境时按「症状」查这张表,不用通读 `docs/REAL_MACHINE_FINDINGS.md`:
| 症状 | 根因 | 处置 / 权威位置 |
|---|---|---|
| `Platform is already owned` | direct boot 缺 `kernel-hashes=on` 或 pflash(报错具误导性) | 框架 `PlatformProfile` 已修;**别在部署层覆盖** `-machine` / 固件 / CPU。`nodes/*.node.example` 注释、`docs/TEE_DIRECT_LAUNCH.md` |
| `os error 11`(EAGAIN,像 KBS 挂了) | 证明提交超时 10s < KBS 判定超时 30s | `ATTEST_POST_TIMEOUT_SECS=90`;`docs/REAL_MACHINE_FINDINGS.md` §10.8 |
| KBS 403「平台不一致」 | `serve.py --platform` 缺省 `csv`,AMD 机拿 csv 判 SNP | KBS **显式** `--platform`;编排层按 `PLATFORM_OF_GRP` 注入。`kbs-net.sh`、`pair-attest-run.sh` |
| KBS 起不来 / token 无效 | token 密钥须在**远端**生成 | `MPC_KBS_TOKEN_KEY_FILE` 读入,不落命令行。`kbs-net.sh:158` |
| 会话通了但取不到密钥,或反之 | 想把 `socket`(二层)与 `tap`(三层)合成一张卡 | **两张卡,不能合成**。`tee-pair-attest-e2e.sh` 文件头 |
| 偶发认错网卡 | 按 `/sys/class/net` 枚举顺序(= PCI slot 顺序,会漂) | **按 MAC 认**,认不到就 die。同上 |
| `IPv6 duplicate address fe80::... detected` | 两侧数据面 MAC 相同(同二层域抢地址;会话照样跑通 ⇒ 隐患) | 两侧 MAC 必须不同,已有判据。`check-pair-verdict.py`、env 样例 D/E 段 |
| 前台 `ssh` 永久挂住 | guest halt 后 qemu 不退出 | 起 guest 一律走 `guest-watch.sh`(后台 + 轮询 `MPC TEE GUEST DONE`) |
| 串口无输出 / 日志丢 | `-nographic` + `-serial stdio` 抢 stdio;init 未建 `/dev/console` | `MPC_TEE_SERIAL_LOG` 换 chardev file;init 用 `mknod` + `exec > /dev/console 2>&1` |
| `Connection refused`,但宿主端口已 LISTEN | **假就绪信号**:qemu 一启就 listen,guest 内 bind 要等证明验签完成 | 证明门控判据必须**独立于**会话判据。`check-attest-verdict.py`、§10.6 |
| 连接预算耗尽 / 两侧表现不对称 | `SESSION_WAIT_BUDGET_SECS=180` 与 `connect_within` / `accept_within` 不对称 | 两侧对称;看门狗 420 > 180(先看到真原因再被杀)。§10.5、env 样例 C 段 |
| `MAC verify failed` 永不命中 | 海光官方 SM2 签名**不覆盖 MAC**,是死判据 | 已去掉,别再加回来。`docs/REAL_MACHINE_FINDINGS.md` §1 |
| `ro****【xop...】fs_files: verified` | xop 密钥防护把 `root` 误判成密钥片段 | 判据只认稳定后缀 `fs_files` / `fs_links` |
| `open /dev/csv-guest failed` | 报告必须在 **CSV guest 内**取,宿主没有该设备 | `capture-csv-report.sh` + `csv-attest-request.c`(支持自定义挑战值) |
| 截断报告也打印 `verify success` | 官方验签器对截断报告 **fail-open** | wrapper 自卡长度 == 2548 字节。`csv-verify-attestation.sh` |
| 官方验签器悄悄联网 | 缺证书时会联网下载 | 链校验模式强制 `unshare -rn` 断网。同上、`docs/REAL_MACHINE_FINDINGS.md` §2 |
| 绑定值对不上,报错像「重放攻击」 | 手工抄 site / measurement / tcb,或没还原 `anonce` 混淆 | 用采集时的 `session.env` 重算;`csv-report-restore.py --field all`。`fixtures/csv/session.env` |
| `scp -r` 把目录铺平 / 真机冒出 `._*` | `scp -r` 语义 + macOS tar 注入 AppleDouble | 用 `tar` 传目录、`COPYFILE_DISABLE=1` |
### `/tmp` 里那 60+ 个探索脚本怎么办
`amd7-kds-*.sh` / `amd7-vcek-*.sh` / `amd7-ghcb-*.sh` / `amd7-clean*.sh` 等是
2026-11-07 的**探针与清扫过程产物**(probe / sweep / dump),不是运行依赖。
它们的结论已经沉淀到 `snp-verify-attestation.sh`(KDS 取 VCEK 链 + 证书链校验)、
`selftest-snp-verify.py`、`snp-attest-matrix.sh` 与 `docs/REAL_MACHINE_FINDINGS.md`。
**不要整批拷进仓库,也不要重跑一遍去「确认」** —— 那正是「从零探索」。
真机报告与证书链的可复现样本已在 `fixtures/`,可直接喂自测。
---
## 前置物料
1. **Linux 静态 `mpc`**(macOS 上交叉编译):
+239
View File
@@ -0,0 +1,239 @@
#!/usr/bin/env bash
# 真机双机 e2e **重跑前**的环境预检:一次性把「缺什么 / 哪项不对」报出来,
# 而不是等 tee-pair-attest-e2e.sh 跑起来再逐个撞错、回头翻 630 行探索结论。
#
# 用法:
# ./preflight-real-machine.sh # 本地 + 远端全查
# ./preflight-real-machine.sh --skip-remote # 不连真机(离线查看配置是否有问题)
# ./preflight-real-machine.sh --self-test # 零依赖:逐条破坏参数判据,验证非恒绿
# ./preflight-real-machine.sh --env /path/to.env
#
# ★ 只做**环境检查**,不产生任何业务判据结论:
# TEE_PAIR_OK / TEE_ATTEST_GATE_OK 仍只由 check-pair-verdict.py /
# check-attest-verdict.py 判定。两份判定实现 = 没有门禁。
# ★ 缺环境一律显式 SKIP 或 FAIL,绝不静默当成通过。
# ★ 凭据只经 xop 键名注入,本脚本不取值、不打印口令。
set -u
HERE=$(cd "$(dirname "$0")" && pwd)
REPO=$(cd "$HERE/../../.." && pwd)
SSHO="-o StrictHostKeyChecking=no -o UserKnownHostsFile=/dev/null -o PreferredAuthentications=password -o PubkeyAuthentication=no -o ConnectTimeout=20"
OK_N=0
SKIP_N=0
FAIL_N=0
ok() { OK_N=$((OK_N + 1)); printf 'ok %s\n' "$1"; }
skip() { SKIP_N=$((SKIP_N + 1)); printf 'SKIP %s\n' "$1"; }
fail() { FAIL_N=$((FAIL_N + 1)); printf 'FAIL %s\n' "$1" >&2; }
warn() { printf 'WARN %s\n' "$1"; }
# ── 纯判据:参数一致性(不连机、不依赖外部工具,可被 --self-test 逐条破坏)──
net_prefix() {
local s=${1%%/*}
printf '%s' "${s%.*}"
}
mac_shape_ok() {
local m=$1 part
local IFS=:
set -- $m
[ "$#" -eq 6 ] || return 1
for part in "$@"; do
[ "${#part}" -eq 2 ] || return 1
case "$part" in *[!0-9a-fA-F]*) return 1 ;; esac
done
return 0
}
# 参数:amd_mac hy_mac amd_br_ip hy_br_ip guest_timeout wait_budget amd_port hy_port
verify_params() {
local amd_mac=$1 hy_mac=$2 amd_net=$3 hy_net=$4 timeout=$5 budget=$6 amd_port=$7 hy_port=$8
mac_shape_ok "$amd_mac" || { printf 'MAC 格式不对: %s\n' "${amd_mac}"; return 1; }
mac_shape_ok "$hy_mac" || { printf 'MAC 格式不对: %s\n' "${hy_mac}"; return 1; }
[ "$amd_mac" != "$hy_mac" ] || {
printf '两侧数据面 MAC 相同(同一二层域会 IPv6 冲突,且会话照样跑通 ⇒ 隐患)\n'; return 1; }
[ "$(net_prefix "$amd_net")" != "$(net_prefix "$hy_net")" ] || {
printf '两侧 KBS 网段相同(两台宿主的 bridge 会撞,guest 认错路由)\n'; return 1; }
case "${timeout}${budget}" in *[!0-9]*) printf '超时必须是整数\n'; return 1 ;; esac
[ "$timeout" -gt "$budget" ] || {
printf 'guest 看门狗 %ss 未大于连接预算 %ss(会只看到「被杀」看不到真原因)\n' "${timeout}" "${budget}"; return 1; }
[ "$amd_port" != "$hy_port" ] || {
printf '两侧 KBS 端口相同\n'; return 1; }
return 0
}
selftest() {
local good="02:00:00:00:0a:01 02:00:00:00:0a:02 10.93.0.1/24 10.94.0.1/24 420 180 18093 18094"
local ok_n=0 bad_n=0 name expect out rc
printf '=== 参数判据负向自测(每条都要能被构造样例推翻)===\n'
set -- $good
out=$(verify_params "$@" 2>&1); rc=$?
if [ "$rc" -eq 0 ]; then printf 'ok 正向对照:合法参数通过\n'; ok_n=$((ok_n + 1));
else printf 'FAIL 正向对照竟然失败:%s\n' "$out"; bad_n=$((bad_n + 1)); fi
check_bad() {
name=$1; expect=$2; shift 2
out=$(verify_params "$@" 2>&1); rc=$?
if [ "$rc" -eq 0 ]; then
printf 'FAIL %s:判据恒真(坏样例竟然通过)\n' "$name"; bad_n=$((bad_n + 1)); return
fi
case "$out" in
*"$expect"*) printf 'ok %s\n' "$name"; ok_n=$((ok_n + 1)) ;;
*) printf 'FAIL %s:期望特征未命中,实际=%s\n' "$name" "$out"; bad_n=$((bad_n + 1)) ;;
esac
}
set -- $good
check_bad '负向① 两侧数据面 MAC 相同' 'MAC 相同' \
"$2" "$2" "$3" "$4" "$5" "$6" "$7" "$8"
set -- $good
check_bad '负向② 两侧 KBS 网段相同' '网段相同' \
"$1" "$2" "$3" "$3" "$5" "$6" "$7" "$8"
set -- $good
check_bad '负向③ 看门狗不大于连接预算' '看门狗' \
"$1" "$2" "$3" "$4" 120 "$6" "$7" "$8"
set -- $good
check_bad '负向④ 两侧 KBS 端口撞车' '端口相同' \
"$1" "$2" "$3" "$4" "$5" "$6" "$7" "$7"
set -- $good
check_bad '负向⑤ MAC 格式坏' 'MAC 格式' \
'not-a-mac' "$2" "$3" "$4" "$5" "$6" "$7" "$8"
set -- $good
check_bad '负向⑥ 超时非整数' '整数' \
"$1" "$2" "$3" "$4" abc "$6" "$7" "$8"
printf -- '---\n判据自测:%s 通过 / %s 失败\n' "$ok_n" "$bad_n"
[ "$bad_n" -eq 0 ]
}
# ── 环境检查 -------------------------------------------------------------
have() { command -v "$1" >/dev/null 2>&1; }
check_local_tools() {
local t
for t in xop sshpass python3 cargo docker ssh scp awk; do
if have "$t"; then ok "本地工具 ${t}"; else fail "缺本地工具 ${t}"; fi
done
if [ -f "${REPO}/.cargo/config.toml" ]; then ok 'musl 链接配置 .cargo/config.toml';
else fail '缺 .cargo/config.toml(guest 静态产物依赖 rust-lld + crt-static)'; fi
if [ -d "${REPO}/deploy/tee/real-machine" ]; then ok '真机脚本目录完整';
else fail '真机脚本目录缺失'; fi
}
check_xop_keys() {
local keys list k
keys="${MPC_TEE_AMD_USER_KEY:-tee_amd_7_user} ${MPC_TEE_AMD_PASS_KEY:-tee_amd_7_pass} ${MPC_TEE_HYGON_USER_KEY:-tee_hg_102_user} ${MPC_TEE_HYGON_PASS_KEY:-tee_hg_102_pass}"
if ! have xop; then skip 'xop 键检查(xop 未安装)'; return; fi
# ★ stdin 必须重定向,否则 xop 会等 Touch ID 超时;不打印完整清单,只报缺哪个键。
list=$(xop list < /dev/null 2>/dev/null) || { fail 'xop list 失败(凭据未就绪?)'; return; }
for k in $keys; do
case "$list" in
*"$k"*) ok "xop 键 ${k}" ;;
*) fail "缺 xop 键 ${k}" ;;
esac
done
}
check_params() {
local out rc
out=$(verify_params "$1" "$2" "$3" "$4" "$5" 180 "$6" "$7" 2>&1); rc=$?
if [ "$rc" -eq 0 ]; then ok '参数一致性(MAC / 网段 / 端口 / 超时顺序)';
else fail "参数不一致:${out}"; fi
}
remote_cmd() {
local host=$1 uk=$2 pk=$3 cmd=$4
xop run --secret "SSHPASS=${pk}" --secret "TEE_USER=${uk}" -- \
sh -c "sshpass -e ssh ${SSHO} \"\$TEE_USER@${host}\" \"${cmd}\"" < /dev/null 2>&1
}
node_value() {
awk -F= -v k="$2" '$1 == k { print substr($0, index($0, "=") + 1) }' "$1"
}
check_remote_side() {
local label=$1 host=$2 uk=$3 pk=$4 node=$5 out
out=$(remote_cmd "$host" "$uk" "$pk" 'echo REMOTE_OK' 2>&1)
case "$out" in
*REMOTE_OK*) ok "${label} SSH 可达(${host})" ;;
*) fail "${label} SSH 不可达(${host}):${out}"; return ;;
esac
if [ ! -f "$node" ]; then fail "${label} 缺节点描述 ${node}"; return; fi
local qemu fw kernel
qemu=$(node_value "$node" qemu)
fw=$(node_value "$node" firmware)
kernel=$(node_value "$node" kernel)
out=$(remote_cmd "$host" "$uk" "$pk" \
"test -x ${qemu} && test -f ${fw} && test -f ${kernel} && echo MATERIALS_OK" 2>&1)
case "$out" in
*MATERIALS_OK*) ok "${label} 远端物料(qemu / 固件 / 内核)" ;;
*) fail "${label} 远端物料缺失(qemu=${qemu} fw=${fw} kernel=${kernel}):${out}" ;;
esac
warn "${label} 建 tap/bridge 需要 root;若远端非 root,请确认 kbs-net.sh 的提权方式"
}
main() {
local env_file="${HERE}/real-machines.env" skip_remote=0
while [ "$#" -gt 0 ]; do
case "$1" in
--self-test) selftest; return $? ;;
--skip-remote) skip_remote=1; shift ;;
--env) env_file=$2; shift 2 ;;
-h|--help) sed -n '2,18p' "$0"; return 0 ;;
*) printf '未知参数:%s\n' "$1" >&2; return 2 ;;
esac
done
printf '=== 真机双机 e2e 重跑预检 ===\n'
if [ -f "$env_file" ]; then
# shellcheck disable=SC1090
. "$env_file" && ok "已加载环境配置 ${env_file}"
else
warn "未找到 ${env_file}(从 real-machines.env.example 复制);以下用脚本默认值核对"
fi
check_local_tools
check_xop_keys
check_params \
"${MPC_AMD_DATA_MAC:-02:00:00:00:0a:01}" \
"${MPC_HY_DATA_MAC:-02:00:00:00:0a:02}" \
"${MPC_AMD_BR_IP:-10.93.0.1/24}" \
"${MPC_HY_BR_IP:-10.94.0.1/24}" \
"${MPC_TEE_GUEST_TIMEOUT:-420}" \
"${MPC_AMD_KBS_PORT:-18093}" \
"${MPC_HY_KBS_PORT:-18094}"
if [ "$skip_remote" -eq 1 ]; then
skip '远端 SSH / 物料检查(--skip-remote)'
elif ! have xop || ! have sshpass; then
skip '远端 SSH / 物料检查(缺 xop 或 sshpass)'
else
check_remote_side 'AMD SNP' \
"${MPC_TEE_AMD_HOST:-192.168.1.7}" \
"${MPC_TEE_AMD_USER_KEY:-tee_amd_7_user}" \
"${MPC_TEE_AMD_PASS_KEY:-tee_amd_7_pass}" \
"${HERE}/nodes/amd-sev-snp.node.example"
check_remote_side '海光 CSV' \
"${MPC_TEE_HYGON_HOST:-192.168.1.102}" \
"${MPC_TEE_HYGON_USER_KEY:-tee_hg_102_user}" \
"${MPC_TEE_HYGON_PASS_KEY:-tee_hg_102_pass}" \
"${HERE}/nodes/hygon-csv2.node.example"
fi
printf -- '---\n汇总:ok=%s SKIP=%s FAIL=%s\n' "$OK_N" "$SKIP_N" "$FAIL_N"
if [ "$FAIL_N" -gt 0 ]; then
printf '预检未通过:先修 FAIL 项,再跑 ./tee-pair-attest-e2e.sh\n' >&2
return 1
fi
if [ "$SKIP_N" -gt 0 ]; then
printf '有 SKIP 项(已显式列出,不是静默通过);远端未核验\n'
printf '本地预检通过:可以跑 ./tee-pair-attest-e2e.sh,但远端状态仍未验证\n'
else
printf '预检通过(含远端):可以跑 ./tee-pair-attest-e2e.sh\n'
fi
return 0
}
main "$@"
@@ -0,0 +1,89 @@
# 真机双机环境配置样例 —— 2026-11-08「证明门控 + 跨物理机密文会话」跑通的那一组值。
#
# 用法(在本目录或仓库根均可):
# cp real-machines.env.example real-machines.env # 本地实际配置,已 gitignore
# set -a; . ./real-machines.env; set +a
# ./preflight-real-machine.sh # 一次性报缺,别靠跑起来再试错
# ./tee-pair-attest-e2e.sh # 一键:编译 → OCI → 双 KBS → 双 guest → 双判据
#
# ★ 这是**参数的唯一集中入口**。以前这些值散在 pair-run.sh / pair-attest-run.sh /
# tee-pair-attest-e2e.sh / kbs-net.sh / kbc-*.sh 的 ${VAR:-default} 里,换机器或换网段
# 要逐个脚本翻、逐个 export —— 那就是「每次从零调整」的根源。改这里即可。
# ★ 变量名与脚本里的 ${VAR:-default} **逐字一致**;不要改名,不要另起一套别名。
# ★ 凭据只放 **xop 键名**,绝不放明文口令。脚本内部统一走
# `xop run --secret SSHPASS=<键名> -- ... < /dev/null`,键名泄露不等于口令泄露。
# ★ 一键脚本会用 ${VAR:-default} 读取;已 source 的值优先,脚本默认值只是兜底。
# ★ 判据逻辑不在这里:本文件只描述环境,不产生任何「通过 / 失败」结论。
# ── A. 两台真机与凭据键名(换机器只改这一段)────────────────────────────
# .7 = AMD SEV-SNP(本身是 SNP guest 虚机);.102 = 海光 CSV(裸机 / hypervisor)
export MPC_TEE_AMD_HOST=192.168.1.7
export MPC_TEE_HYGON_HOST=192.168.1.102
export MPC_TEE_AMD_USER_KEY=tee_amd_7_user
export MPC_TEE_AMD_PASS_KEY=tee_amd_7_pass
export MPC_TEE_HYGON_USER_KEY=tee_hg_102_user
export MPC_TEE_HYGON_PASS_KEY=tee_hg_102_pass
# 远端物料目录 / 本地串口日志目录(两侧同名,互不干扰因为是两台机器)
export MPC_TEE_REMOTE_DIR=/tmp/mpc-tee-run-attestpair
export MPC_TEE_LOG_DIR=/tmp/mpc-tee-logs
export MPC_TEE_WORK=/tmp/mpc-tee-attest-e2e
# ── B. 本地构建 ─────────────────────────────────────────────────────────
export MPC_TEE_ALPINE_IMAGE=alpine:3.18
# 跨 guest 的 qemu socket 监听端口(二层点对点,不是 KBS 端口)
export MPC_TEE_LINK_PORT=19777
# ── C. 超时(有依赖顺序,别乱改)────────────────────────────────────────
# mpc_node::SESSION_WAIT_BUDGET_SECS = 180(两侧必须对称)。
# guest 看门狗必须**大于**连接预算:先看到「连接预算耗尽」这个真原因,
# 再轮到看门狗杀进程。看到 GUEST_TIMEOUT 只知道「被杀了」,那是假安全感。
export MPC_TEE_GUEST_TIMEOUT=420
# ── D. 拓扑:AMD 侧(组级参数,编排层会转成实例级 MPC_TEE_*)────────────
export MPC_AMD_KBS_PORT=18093
export MPC_AMD_BR=mpcbr-pa
export MPC_AMD_TAP=mpctap-pa
export MPC_AMD_BR_IP=10.93.0.1/24
export MPC_AMD_GUEST_IP=10.93.0.2/24
# 固定 MAC 不是随机:guest 按 MAC 认卡,变了就认不到。
export MPC_AMD_DATA_MAC=02:00:00:00:0a:01
export MPC_AMD_KBS_MAC=02:00:00:00:0a:11
# ── E. 拓扑:海光侧 ─────────────────────────────────────────────────────
export MPC_HY_KBS_PORT=18094
export MPC_HY_BR=mpcbr-pb
export MPC_HY_TAP=mpctap-pb
export MPC_HY_BR_IP=10.94.0.1/24
export MPC_HY_GUEST_IP=10.94.0.2/24
export MPC_HY_DATA_MAC=02:00:00:00:0a:02
export MPC_HY_KBS_MAC=02:00:00:00:0a:12
# ★★ 两侧网段必须不同(KBS 各在宿主 bridge 上)、两侧数据面 MAC 必须不同
# (socket netdev 是同一个二层域,MAC 相同 ⇒ IPv6 冲突,且会话照样跑通 ⇒ 隐患)。
# 预检脚本会逐条破坏验证过,不是口头约束。
# ★ 两张网卡不能合成一张:跨 guest 走 socket(二层),访问宿主 KBS 走 tap(三层)。
# socket 侧没路由到宿主网段,tap 侧够不到跨 guest 对端 —— 合成必挂。
# ── F. 演练用会话值(不要用于生产)──────────────────────────────────────
export MPC_TEE_SESSION_ID=abababababababababababababababababababababababababababababababab
export MPC_TEE_PUBKEY=cdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcdcd
# ── G. 可选开关 ─────────────────────────────────────────────────────────
# export MPC_TEE_DRY_RUN=1 # 只跑到 dry-run,不连真机
# export MPC_TEE_KBC=offline_fs_kbc::null # 离线演练密钥(不经过证明,只跑会话)
# ── H. 运行时生成,**不要手填**(列出来只是为了避免误以为漏配)──────────
# MPC_TEE_MPC_BIN / MPC_TEE_INITRD / MPC_TEE_AMD_NODE / MPC_TEE_HYGON_NODE
# MPC_TEE_MANIFEST ← 从 oci-image.py build 输出解析,不许手抄
# MPC_TEE_DATA_MAC / MPC_TEE_KBS_MAC / MPC_TEE_GUEST_IP / MPC_TEE_TAP
# MPC_KBS_BRIDGE / MPC_KBS_BRIDGE_IP / MPC_KBS_PORT / MPC_KBS_SESSION
# MPC_KBS_TOKEN_KEY_FILE ← 远端生成,值为 ${MPC_TEE_REMOTE_DIR}/kbs-token.key
# MPC_KBS_PLATFORM / MPC_KBS_VERIFIER / MPC_KBS_CHAIN_DIR
# ← 编排层按平台分派:AMD 走 KDS/VCEK,海光走官方验签器
# MPC_KBS_MEASUREMENT / MPC_KBS_PIN / MPC_KBS_TCB / MPC_KBS_MIN_TCB
# MPC_TEE_SERIAL_LOG ← 串口必须落盘,否则 guest stdout 会丢
#
# ★ 区分「组级」与「实例级」:上面 D/E 段的 MPC_AMD_* / MPC_HY_* 是两组配置,
# pair-attest-run.sh 会按当前 guest 角色挑一组,转成 MPC_TEE_* / MPC_KBS_*
# 注入远端。别在 env 里同时写实例级变量,会覆盖编排层的分派。
+12 -3
View File
@@ -49,7 +49,8 @@
| 跑真链验收 | `tools/selftest-fisco-contract.py`(`--self-test` 零依赖) | 自己拼交易;`fisco-realnode-probe.py`(历史契约,未销账) |
| 查门禁条数 / 跑全量闸门 | `tools/ci.sh` | 任何文档里写的数字 |
| 查链端点 / 链配置 | `tools/fisco-realnode/example.chain.json` + `deploy/k8s/fisco/README.md` | `127.0.0.1:20200`(旧本机容器,已停) |
| 复现真机证明门控 | `deploy/tee/real-machine/README.md` | `docs/REAL_MACHINE_FINDINGS.md` 第 7/9 节的「当时边界」 |
| 复现真机证明门控 | `deploy/tee/real-machine/README.md`(开头「重跑前先看」) | `docs/REAL_MACHINE_FINDINGS.md` 第 7/9 节的「当时边界」 |
| 重跑真机双机 e2e:配置 / 预检 / 症状速查 | `deploy/tee/real-machine/real-machines.env.example` + `preflight-real-machine.sh` + 该 README 速查表 | 逐个脚本 export 参数;去 `/tmp` 翻 60+ 个探索脚本 |
| 部署 / 回滚链节点 | `deploy/k8s/fisco/`(含 `migrate-ledger.sh`、`README.md`) | 手动 `docker start fisco-gm`(会与 k8s 链分叉) |
| 看真链实证期的审计轨迹 | `tools/fisco-realnode/README.md` | `/tmp`(会被清) |
| 查两台真机硬事实 / 踩坑 | `docs/REAL_MACHINE_FINDINGS.md`(第 10 节最新) | 记忆或口头结论 |
@@ -98,7 +99,11 @@
### D 部署与复现
`deploy/k8s/fisco/README.md`(链迁移 SOP / 账本 / 回滚 / 边界)、
`deploy/tee/real-machine/README.md`(真机 e2e)、`deploy/tee/README.md`、
`deploy/tee/real-machine/README.md`(真机 e2e;**开头有重跑三步、参数真相源与症状速查表**)、
`deploy/tee/real-machine/real-machines.env.example`(**双机参数唯一集中入口**,脱敏、可 source)、
`deploy/tee/real-machine/preflight-real-machine.sh`(重跑前环境预检,`--self-test` 负向矩阵)、
`deploy/tee/real-machine/nodes/*.node.example` + `fixtures/`(真机路径与真实报告 / 证书链样本)、
`deploy/tee/README.md`、
`deploy/tee/oci/README.md`、`deploy/ray/README.md`、
`demo/README.md`、`demo/k8s/README.md`(站点 + PVC)、
`tools/fisco-realnode/README.md`(复现工具与审计轨迹)、
@@ -164,4 +169,8 @@
9. **架构结论只改 `docs/ARCHITECTURE_SYSTEM.md`**:新增 / 变更组件、边界、端点先改它,
再跑 `python3 tools/render-share-html.py`(重新生成 `.html`)与 `--check`(校验同步)。
HTML 是**派生产物不许手改**;历史决策文档正文不因架构变更而改写。
文档里写「部署了什么」必须区分 [实证] 实证 / [桩验] 桩验 / [设计] 设计角色,不许把蓝图写成现状。
文档里写「部署了什么」必须区分 [实证] / [桩验] / [设计] / [禁用],不许把蓝图写成现状。
10. **真机参数只认 `deploy/tee/real-machine/real-machines.env.example`**:换机器 / 换网段
改这一份,不要逐个脚本 export;重跑前先 `preflight-real-machine.sh`(`--self-test`
用构造样例钉死参数判据非恒绿)。`/tmp` 的 60+ 个探索脚本是过程产物,结论已
沉淀进验签器与 `REAL_MACHINE_FINDINGS.md`,**不许整批入库或重跑确认**。