回環與內網暴露對照(多節點池)
池化 Mac 上勿預設只信 127.0.0.1 示意;常需內網位址供同網段建置機回呼,同時把管理面收斂到 SSH 隧道。
| 綁定 | 誰直連 | 權杖風險面 | 建議收斂 |
|---|---|---|---|
| 僅回環 | 本機使用者 | 低 | 單機開發足夠 |
| 內網介面+固定埠 | 同網段服務 | 中 | 防火牆白名單+隧道收斂管理面 |
| 對公網零信任外裸奔 | 網際網路 | 高 | 須前置反代、mTLS,勿在 MeshMac 生產裸聽 |
最小複現六步(對齊公開文件)
各節點在同一維護窗執行;變更前後各存一份 openclaw gateway status(或文件同等指令)文字以利 diff。
- Install:依 Getting Started 使用
npm install -g openclaw@latest(或團隊釘選的 tarball/內部鏡像),確認openclaw --version主版本一致。 - Onboard:
openclaw onboard --install-daemon寫入工作區、模型憑證與 launchd 服務,避免只裝 CLI 而無常駐網關。 - Doctor:執行
openclaw doctor;詳見 doctor 文件(無人值守可用--non-interactive,政策允許時--repair)。macOS 可搭配launchctl getenv查權杖是否被環境覆寫。 - 非 loopback 綁定:將監聽改為例如
10.0.0.5:18789,各節點lsof -nP -iTCP:18789 -sTCP:LISTEN輸出形狀應一致。 - LocalForward:筆電執行
ssh -N -L 18789:10.0.0.5:18789 user@jump.example.internal,瀏覽器或curl改打https://127.0.0.1:18789,並帶與網關組態相同的 Bearer 權杖。 - 合併驗收:多節點各映到不同本機埠(例如
118789、218789)以免衝突;權杖輪替後請全員重連跳板工作階段。長時操作可併讀 螢幕共享與 SSH 交接清單。
單行探測範例:curl -k -H "Authorization: Bearer 權杖" https://127.0.0.1:18789/health(路徑名稱依實際環境替換)。各機再跑 openclaw validate --profile gateway --format json 彙整 listen/auth 區塊。
合併多條 SSH LocalForward
在 ~/.ssh/config 同一 Host 區塊寫多行 LocalForward 118789 node-a.internal:18789 與 LocalForward 218789 node-b.internal:18789,一條 ssh 工作階段即可合併;改檔後須斷線重連才生效。
排障表:埠 18789、auth token、服務未執行
| 現象 | 埠 18789 | auth token | 服務未執行 |
|---|---|---|---|
| 瀏覽器 connection refused | 本機 lsof 無監聽,或轉發目標內網 IP 寫錯 | 尚未進入鑑權 | 查 openclaw gateway status、launchctl list 是否無網關單元 |
| 隧道已建立仍 refused | 確認遠端監聽為 0.0.0.0:18789 或正確內網介面,而非僅回環 | — | 行程崩潰時看 openclaw logs(或文件建議之 log 路徑) |
| HTTP 401/unauthorized | 埠已通 | 比對權杖檔與請求標頭;清 launchctl getenv 殘留覆寫 | 權杖熱更後未 reload 服務 |
| 間歇 502 | 反代逾時或上游擁塞 | 反代子請求未透傳 Authorization | 後端 worker 未起,依 doctor 深度檢查與 gateway 重裝指引整理單元 |
可引用檢查點
- 監聽三元組:協定、綁定位址、18789 在 status/validate 輸出中多節點逐字一致。
- 權杖權限:檔案模式建議 0440,勿把明文權杖寫進 Git。
- 巡檢節拍:滾動發佈前後各跑一次
openclaw doctor與網關狀態,附在變更單。
結尾購買引導
若要在真實多節點 MeshMac 池練習網關綁定與跳板策略,請免登入開啟 購買/方案 比對配額,並搭配 幫助中心 的 SSH 與節點說明;更多 OpenClaw 實務見 站內 OpenClaw 專欄 與 部落格列表。Apple Silicon 遠端建置席位與計費細節以購買頁為準,接上機後將本文六步與排障表貼進運維手冊即可降低 on-call 負擔。