跳至主要內容

Gateway 常駐服務

要關閉終端機後繼續收訊息、執行 Cron 和管理背景任務,需要常駐 Gateway。Dashboard、TUI、CLI 和訊息通訊管道都連線到它;僅有一個頁面開啟,無法證明它仍線上。

先看目前管理的是哪個 Home​

anyy gateway status
anyy status

第一個指令檢查服務與執行環境,輸出解析到的 Profile Home、服務主機和 Socket;能獲取版本時,還會比較執行中的 Gateway 與目前 CLI。第二個指令檢視產品狀態。排查多 Profile 時,先確認 Home 和 Socket,再決定是否停止或重啟。

常用維護指令​

anyy gateway start
anyy gateway restart
anyy gateway stop

start 在服務缺失時安裝支援的服務並等待可連線;restart 也會修復缺少服務安裝的情況。macOS 使用 launchd 使用者服務,常見 Linux 使用 systemd 使用者服務,受支援部署還包括 procd 或 s6。

服務定義綁定一個 Home。macOS 的 com.anyy.anyy 和 systemd 的 anyy.service 不是每個命名 Profile 各有一份;已有資產屬於另一 Home 時,不應靠手改服務檔案覆蓋它。--profile 選擇要解析的 Profile,例如:

anyy --profile work gateway status

命名 Profile 的資料保持獨立,服務能否管理它仍以實際宿主和所屬檢查為準。詳見Profiles。

臨時執行和常駐不同​

TUI 在沒有可用預設 Socket 時,可以為目前互動臨時啟動 Gateway;結束 TUI 會清理這次臨時執行。需要長期線上時,顯式啟動常駐服務後再連線。

Gateway 停止會斷開通訊管道並中斷依賴它的即時工作。Dashboard 的獨立程序或瀏覽器標籤可能仍在,但不能繼續使用已停止的 Gateway。維護前檢查活動任務與需要保留的資料。

修改後用 Reload 還是 Restart​

帳號儲存通常會觸發執行環境協調;通訊管道需要重新協調時用 anyy channel reload。改變 channel_webhooks.enabled/listen 這類啟動監聽設定,需要重啟 Gateway。Webhook 監聽不是 Dashboard 連接埠,設定見訊息平台。

執行中的 Gateway 與目前 CLI 版本不同、服務已安裝但無法連線,或修復提示明確要求時,再使用 restart。不要透過刪除 Socket 繞過 Profile 所有權。

排查順序:

anyy gateway status
anyy doctor
anyy gateway restart

隨後再次檢查 status/doctor。若離線維護無法獲得 Profile 鎖,先停止持有該 Home 的執行環境再重試;不能只憑程序名稱結束其他 Profile。診斷欄位見狀態檢查與 Doctor。