這張卡做什麼（白話）

寫給客戶看的安裝手冊：一般 IT 人員（不是原廠工程師）照著做，就能完成安裝、開通、日後升級、必要時回滾。這是「不依賴原廠工程師到場」目標的文件面收口。

• 母案 CM-1189：https://app.notion.com/p/FR-065-Installer-3bc346da4cd081c4abf3ce74a28ba384
• 所屬子需求卡 CM-1246：https://app.notion.com/p/FR-065-4-3be346da4cd08150a5eadfc9d1913073
• 設計文件：docs/features/FR-065-2608-onprem-installer/design.md §5（T-4.1）；素材源：T-2.5 環境檢查清單、T-3.4 升級回滾、T-3.5 外連清單

具體實作內容

手冊章節（隨 bundle 出貨）：

• 安裝：宿主前提（OS／Docker 版本／磁碟記憶體門檻／/etc/machine-id 非空／時區／port）→ 解 bundle → install.sh 全流程 → 精靈設定
• 開通：精靈抄指紋 → 離線通路（mail／電話）向原廠申請 → 匯入 .license 檔
• 升級：install.sh --upgrade 四步＋注意事項（備份目錄空間、適用版號區間）
• 回滾：restore＋回 tag 步驟＋災難逃生定位與資料遺失警語
• 外連清單與停用法（T-3.5 產出收錄）
• 自備 DB／Redis 指引（改 DB_HOST／REDIS_HOST＋移除 service 段，D1）

易踩雷提醒

• 手冊絕不可含任何真實密碼／token／內部 host（憑證與內部資訊不出貨）
• 受眾是一般 IT 人員——術語首次出現要白話註解，指令可整段複製執行
• machine-id 補建警語要照 T-2.5 寫法帶「只在本來就沒有時補」（重生成＝既有憑證全失效）

驗收條件

• 一般 IT 人員照手冊可自助完成（T-4.2 真機驗收即用本手冊照走）

依賴