本版已被 design-v1.2.md 取代（新增 D8 發行版自帶 Docker 處理）。此檔凍結不改。

FR-193 設計 v1.1（已被 v1.2 取代）

整案一句話：Agent 被掃主機上的 Docker 引擎改成普通帳號 guidant 執行，三顆容器全由它開；客戶照常 sudo ./install.sh，多出來的主機設定全由安裝程式做。

依賴：決策者功課只有一件——A0 需要一台乾淨 Ubuntu 24.04 VM（有 TPM 2.0、能連 DEV 主系統）。主系統那套之後開 FR-193.1，照這份的做法抄。

2.1 三層身分

2.2 現況接入點盤點

3.1 主機準備層 lib/rootless_host.sh（A1）

install.sh 第①步環境檢查之後、寫設定之前呼叫 rootless_host_prepare，冪等，重跑無害。

1. 前提：stat -fc %T /sys/fs/cgroup 要 cgroup2fs；systemctl --version 有輸出；uname -r ≥ 5.11。任一不符 check_fail。
2. Docker 三段式：沒有 docker → 從包 debs/docker/<目標>/ 裝（deb 用 dpkg -i 加 apt-get -f，el-9 把目錄當本機 repo 給 dnf）；有且 Server.Version ≥ MIN_DOCKER_MAJOR → 只補 docker-ce-rootless-extras、uidmap、slirp4netns、dbus-user-session；太舊 → fail 印「請自行升級或移除後重跑」。裝完 systemctl disable --now docker.service docker.socket。
3. 帳號（D5）：GUIDANT_RUN_USER 預設 guidant。不存在 → useradd --system --create-home --shell nologin。存在 → 查 subuid 有無（無則 usermod --add-subuids）、shell 是否 nologin（否則 warn 不改）、是否在 sudo／wheel 群組（是則 fail）。
4. linger：loginctl enable-linger。
5. sysctl：寫 /etc/sysctl.d/90-guidant-rootless.conf 一行 net.ipv4.ping_group_range = 0 2147483647，sysctl --system。
6. cgroup 委派：寫 /etc/systemd/system/user@.service.d/delegate.conf（Delegate=cpu cpuset io memory pids），daemon-reload；若 guidant 的 user manager 已在跑，loginctl terminate-user 讓它重起。
7. 啟用 rootless：machinectl shell guidant@ /bin/bash -c 'XDG_RUNTIME_DIR=/run/user/$(id -u) dockerd-rootless-setuptool.sh install && systemctl --user enable docker'。沒有 machinectl 就裝 systemd-container。
8. 驗：以 dk info --format '{{.SecurityOptions}} {{.CgroupDriver}}' 要含 rootless 與 systemd，否則 fail。

3.2 docker 呼叫切身分（A3）

新增兩個共用函式，所有 docker 操作只准走它們：

RUN_UID="$(id -u "$GUIDANT_RUN_USER")"
dk()    { sudo -u "$GUIDANT_RUN_USER" XDG_RUNTIME_DIR="/run/user/$RUN_UID" DOCKER_HOST="unix:///run/user/$RUN_UID/docker.sock" docker "$@"; }
dc()    { dk compose --env-file "$ENV_FILE" -f "$COMPOSE_FILE" "$@"; }

陷阱：sudo -u 不帶起 user manager，但 daemon 已由 linger 常駐，所以這裡用 sudo -u 足夠；只有 dockerd-rootless-setuptool.sh install 那一次要 machinectl shell。ENV_FILE 在 /run/guidant-agent，guidant 要讀得到（A4）。守衛：scripts/install/lib/README.md 加一行規則，並補一支 test/check_no_bare_docker.sh grep 整個 install 樹。

3.3 uid 換算 lib/subuid_map.sh（A4）

subuid_base() { awk -F: -v u="$GUIDANT_RUN_USER" '$1==u{print $2; exit}' /etc/subuid; }
host_uid_for() { echo $(( $(subuid_base) + $1 )); }   # host_uid_for 1000 → 101000

三處 chown 改成 chown "$(host_uid_for 1000):$(host_uid_for 1000)"。local_admin.sh 走 docker run -u 0 在容器內 chown 1000 的那條不用改（容器內看到的仍是 1000，對映由引擎做）。

/run/guidant-agent：secrets.sh load 結尾 chown root:$GUIDANT_RUN_USER、chmod 750、.env 640。這是 tmpfs 每次開機重建，所以放在 load 裡不放 install。

3.4 升級單元（A5、D6）

三支單元維持 User=root。After=docker.service 改 After=user@$RUN_UID.service（install 時代入）。upgrade_order.sh 第 0 步的 docker load／docker tag／_uo_tags 與 upgrade_runner.sh 的 dc_up／docker images 全走 dk()。staging 目錄仍 root 700，解包、驗簽在 root 做完才交給 dk load。

3.5 出貨包（A2）

fetch_docker_debs.sh 照 fetch_tpm2_debs.sh：同一組目標 ubuntu-22.04 ubuntu-24.04 debian-12 el-9，在對應版本最精簡容器加 Docker 官方 repo 後 apt-get install --download-only／dnf download --resolve，輸出 debs/docker/<目標>/。釘版寫在腳本頂部一個變數，bump 走 commit。平台固定 linux/amd64。

• 主系統那套（對外改 8443、四支單元、資料庫目錄 owner）→ FR-193.1，等 Agent 這輪踩完坑再開。
• 容器內任何改動、image 重打（FR-180 的成果沿用）。
• 多 Agent 同主機、非 x86_64。
• pasta 驅動切換（A0 量出吞吐不夠才開卡）。

批＝可同時開 session 的一組；階段＝給 PM 看的分組。由 handoff/cards.py 產生並驗過依賴與撞檔。A8 在 BE repo（資安報告），其餘在 Agent repo。

1. 拿 A2 出的真包，乾淨 Ubuntu 24.04 與 Debian 12 各一台（有 TPM），sudo ./install.sh 到底，中間不手動介入。
2. scripts/build/audit_nonroot_stack.sh --agent 全 ✔；ps -eo user,comm | grep -E 'dockerd|containerd' 無 root。
3. 手冊第 5 節十二項逐項過。
4. 主系統核准 Agent → 派一次掃描 → 收到結果；網路診斷 ping／traceroute／mtu 三項有值。
5. 主系統發 Agent 更新 → 新版起來；中途拔電重開 → boot-check 退回舊版。
6. uninstall 後 grep guidant /etc/passwd /etc/subuid 空、sysctl 回預設、無 dockerd。

只改 D1。PM 2026-11-10 裁示：主系統對外一律 8443，不走「預設 443 貼能力、客戶可切」的路三。理由是產品還沒出給客戶，改預設沒有相容成本；省下 rootlesskit capability 的升級重貼與主機掃描報告解釋。

這條只影響主系統（FR-193.1），Agent 這輪十張卡的內容與批次完全不變。FR-193.1 開卡時要涵蓋：