遠端
管理在 infra/remotes/*.yaml 中定義的遠端機器。
僅在觸發時讀取被引用的檔案。
守衛
remotes.enabled 必須在 bridge-config.yaml 中設定為 true。否則：告知並退出。
參數
| 參數 | 效果 | 預設值 |
|---|---|---|
(無) | 所有遠端機器的儀表板 | — |
{hostname} | 單一遠端機器的詳細檢視 | — |
health {hostname} | SSH 健康檢查 | — |
logs {hostname} {service} | 顯示最近的日誌 | — |
restart {hostname} {service} | 重新啟動服務 | — |
sync {hostname} | 同步設定檔 | — |
wake {hostname} | 網路喚醒 (Wake-on-LAN) | — |
connect {hostname} | 開啟 SSH / RDP 連線 | — |
shutdown {hostname} | 關機 (需要 [y]) | — |
reboot {hostname} | 重新啟動機器 (需要 [y]) | — |
決策樹
使用者想要...
├── 遠端概覽 / 儀表板 → 讀取 references/workflow.md (§ 儀表板)
├── 單一機器的詳細檢視 → 讀取 references/workflow.md (§ 儀表板, 單一主機)
├── 喚醒 / 開機 → 讀取 references/fleet.md (§ 第三階段 WoL)
├── 透過 SSH / RDP 連線 → 讀取 references/fleet.md (§ 第四階段 連線)
├── 重新啟動或關機 → 讀取 references/fleet.md (§ 第五階段)
├── 檢查可達性 / 線上狀態? → 讀取 references/fleet.md (§ 第二階段)
├── 變更後更新庫存 → 讀取 references/fleet.md (§ 第六階段)
├── 機器的健康檢查 → 讀取 references/workflow.md (§ 健康檢查)
├── 檢視服務日誌 → 讀取 references/workflow.md (§ 日誌)
├── 重新啟動服務 → 讀取 references/workflow.md (§ 重新啟動)
├── 同步設定到遠端機器 → 讀取 references/workflow.md (§ 同步)
├── 部署服務到遠端機器 → 讀取 references/workflow.md (§ 部署)
├── 識別「我的電腦」/ 僅意圖 → 讀取 references/fleet.md (§ 第一階段 + 學習路由)
└── 關於遠端機器的問題 → 從 CLAUDE.md § 遠端 回答
參考地圖
| 檔案 | 擁有者 |
|---|---|
references/fleet.md | 庫存, WoL, 連線, 關機, 可達性, 「我的電腦」路由 |
references/workflow.md | 服務儀表板, 健康, 日誌, 重新啟動, 同步, 部署 |
硬性規則 (不可協商)
- Tailscale 優先，LAN 作為備用 — LAN 在 VPN 或外部網路上會失敗
- 無破壞性操作 (關機、重新啟動、格式化) 未經每次操作確認
[y] - 永遠不要在
infra/remotes/*.yaml中儲存憑證 — 僅使用 KeyVault / 1Password URI - 遵守
wake_on_lan.enabled: false— 絕不強制喚醒選擇退出的機器 - 在任何操作之前讀取
infra/remotes/{target}.yaml— 不猜測