伺服器與部署參考

本文講的是 Web BYOS 流程的技術面:你提供的伺服器需要能做到什麼、引導安裝會在上面放什麼、 以及如何檢驗結果。

具體細節因執行環境、應用程式版本與帳號而異。以用戶端在安裝過程中顯示的內容為準; 這裡解釋的是整個過程的形態,好讓你能分辨「真的出問題了」和「這是正常的一步」。

伺服器需求

網路需求

對外存取是必需的。 安裝期間伺服器要從公開來源下載套件與執行環境二進位檔。 如果主機禁止對外連線、或者對外連線被代理攔截,安裝會中途失敗。

入站連接埠通常不需要。 當部署使用 Cloudflare Tunnel 時,伺服器上會裝一個通道代理, 由它主動向外連線到 Cloudflare;流量經由這條連線到達你的 agent。 在這種設定下,你不需要開放任何入站連接埠,開了也沒有幫助。

安裝所執行的服務監聽在伺服器自己的回送或本機介面上 —— 它們是透過通道被存取的, 而不是直接暴露到公網。

安裝會在伺服器上放什麼

取決於你選擇的執行環境與目前流程的版本,安裝可能會放置下列組合:

• 一個 agent 執行環境 —— 你所選的那個 CLI agent。受支援的有多種,具體出現哪些取決於目前的應用程式與帳號。
• 一個閘道服務,受支援的用戶端透過它連線。
• 一個小型管理服務,用於檢視狀態、重新啟動等執行環境操作。
• 一個通道代理(當部署使用通道時),向外建立連線,從而在不開放入站連接埠的情況下公開閘道。
• 某些設定下還會有一個本機 Web 伺服器擋在閘道前面。

這些都以系統服務方式執行,因此重新啟動後仍會存活。具體的服務名稱因版本而異, 請從安裝輸出裡讀取,不要想當然。

驗證部署

1. 把安裝輸出看到結束。 它會回報每一步以及任何失敗。 耗時取決於伺服器、套件來源與網路狀況。
2. 確認用戶端能連上 agent —— 從受支援的 AgentAura 用戶端開啟它, 發一個能真正用到你所設定的模型服務商的請求。
3. 確認它能扛住重新啟動。 在主機商主控台重新啟動伺服器,然後檢查 agent 是否無需人工介入就恢復可用。 這是「它正在跑」和「它已經裝好了」之間的區別。

安裝失敗時

依順序排查,每一步都會排除掉一部分可能:

1. 伺服器真的起來了、並且能接受 SSH 嗎? 剛剛建立的伺服器可能還沒準備好。 這是最常見的原因:主機在主控台裡已經存在,但仍在啟動、或者還沒跑完自己的首次開機初始化。 等一等,先自己 SSH 上去確認,再重試。
2. 憑證在你自己的機器上能用嗎? 用同樣的位址、連接埠、使用者名稱與憑證手動連一次。 如果連不上,那問題在憑證或主機商的防火牆,而不是安裝流程。
3. 對外流量被允許嗎? 如果 SSH 正常、但安裝卡在拉取套件的階段, 多半是主機在攔截或阻斷對外連線。
4. 是不是有別的處理程序佔著套件管理員? 雲端映像常常在首次開機時跑無人值守升級,這會鎖住 apt。 安裝流程能容忍一段時間,但一次長時間的升級可能超出它的等待。等伺服器安定下來再重試。
5. 發行版真的是 Debian/Ubuntu 系、架構真的是 amd64 嗎? 這裡不匹配時, 失敗的表象往往看起來毫不相關。

日常運作

重新連線過期的憑證。 你為模型服務商設定的憑證可能過期或被撤銷。 發生時,即便伺服器與各項服務都還在正常執行,agent 也會不再回應請求 —— 這種故障看起來像 agent 壞了,而不像是驗證問題。 如果用戶端為該 agent 提供了重新連線/重新授權的控制項,請使用它; 它會在伺服器上重新整理憑證,無需重新部署。

更新。 執行環境更新應透過用戶端裡的流程進行,而不是手動去改伺服器上的檔案。 手動改動已安裝的服務,可能會被後續操作覆寫。

伺服器始終是你的。 作業系統更新、防火牆規則、儲存、備份與刪除, 都留在你自己的主機商主控台裡。在 AgentAura 裡移除一個 agent,不會取消或抹除那台伺服器。

值得了解的邊界

• agent 執行環境在你的伺服器上執行,但這並不表示每一條資料流都留在本機。 平台服務會參與帳號、安裝與連線流程。
• 你所選的模型服務商會收到你透過 agent 傳送的提示詞與回覆,並依其自身條款處理。
• 使用通道時,通道服務商承載著你的用戶端與伺服器之間的連線。

---