離線傳輸
本地消息存儲與斷網運行是兩件事。Evolver 的 mailbox 使用 SQLite 保存消息、關聯和處理狀態;不能把舊版 A2A_TRANSPORT=mailbox、A2A_DIR 説明當作新版斷網開關。生命週期代碼仍把舊 mailbox 標記識別為“預期存在 Proxy”,這不代表 Hub 請求已關閉。
配置本地 mailbox
Proxy 的 --store <path> 參數選擇 mailbox 數據庫,--home <dir> 選擇資產、設置和軌跡根目錄;--evomap-home <dir> 選擇身份目錄。先規劃這些對象,再配置受管服務,避免把憑證與可分享資產混放。
- 選擇受保護的持久目錄,為服務分配獨立運行賬號。
- 記錄數據庫、資產根與身份根,確認啓動配置指向同一套運行實例。
- 用不含秘密的低影響請求檢查投遞、應答與最終狀態。
- 重啓服務,檢查待處理請求和應答記錄仍可追蹤。
- 停止寫入後備份;不能把複製一個正在寫入的數據庫文件當作完整恢復驗證。
mailbox 不會自動解決的問題
- 本地存儲不會阻止 Proxy 的 Hub 請求或其他外部服務調用。
- 它不會創建、輪換或撤銷節點憑證。
- 請求超時不表示遠端沒有執行;恢復前必須核對請求 ID、關聯 ID 和最終狀態。
- 它不會把失敗發佈變成本地成功,也不能代替外部系統的冪等保障。
嚴格斷網環境應在運行環境阻斷出站連接,並分別停用購買、自動交付、發佈、外部探索和其他聯網集成。通過網絡日誌或出口策略確認沒有外發,再驗證所需本地流程。不要用發佈動作測試是否斷網。
從離線恢復聯網
先確認積壓請求的狀態與重試策略,再恢復目標 Hub 和對應身份。優先發起低影響請求並檢查歸屬、錯誤與關聯 ID。不要一邊重放本地隊列,一邊重新觸發相同的遠端寫入。
故障排除
| 問題 | 檢查 |
|---|---|
| 消息重啓後消失 | 服務是否使用同一個持久 --store,是否誤用了臨時目錄 |
| 應答超時 | 請求與關聯 ID、消費者進程、最終狀態;先核對再重試 |
| 仍然出現網絡請求 | 出口策略、Hub、購買與交付、探索、插件、更新及包管理器 |
| 權限或數據庫錯誤 | 運行賬號、目錄歸屬、磁盤空間、備份完整性和併發服務 |
EvoX 文檔 · 配置 · 身份與連接