遠端存取與用戶端

機器(在設定編輯器中稱為工作區)只存在於一台 Mac 上,但想要操作它的人並不總是坐在那台 Mac 前。Bromure Agentic Coding 可以從遠端存取,而每一條遠端路徑都經過同一道選用、預設停用的 SSH 前門。開啟後,你會得到三種進入方式:任何人都能從任一終端機以 ssh 登入並進入選單;你可以從命令列管理這道前門本身;而完整用戶端——另一台執行此 App 的 Mac,或 iPhone、iPad、Apple Vision Pro 上的 Bromure Remote——可以連線,並在即時視窗中鏡像整個實例——其工作階段、房間與總機、機器、終端機與看板。

完整用戶端以兩種方式連到伺服器。在同一個網路中,你直接以位址新增它。從其他任何地方,你登入一個 bromure.io 帳戶,並從目錄中挑選伺服器:兩台裝置由 bromure.io 相互引介,接著以點對點通訊,不需連接埠轉送、不需 VPN,也不需記住任何位址——而且一旦登入,你自己的裝置便會彼此授權,因此連線是免密碼的,不需手動設定金鑰。

本章涵蓋在主機上啟用遠端存取、各個進入點、完整用戶端如何鏡像遠端(透過位址與透過 bromure.io)、編輯遠端的偏好設定、iPhone、iPad 與 Vision Pro 用戶端、存取遠端 VM 內的服務、將開發伺服器公開到網際網路,以及確保這一切安全的安全模型。機群規模的註冊與雲端遙測是完全不同的系統——請參閱企業版。完整的指令參考位於 CLI、API 與 MCP。

三種進入方式

以下所有內容都取決於 SSH 前門已啟用(預設為關閉)。一旦它開始執行,同一個伺服器便服務所有三種對象:

進入方式使用者你能取得什麼
純 SSH位於任何終端機前的使用者(ssh -p 2222 you@mac)遠端選單 — 一個 curses 風格的 TUI。永遠無法取得原始 shell。
bromure-cli remote CLI你,在主機本身上管理前門:啟用/停用、金鑰、狀態。請參閱在主機上啟用遠端存取。
完整用戶端另一台執行此 App 的 Mac,或 iOS / iPadOS / visionOS 上的 Bromure Remote遠端實例的即時鏡像,可雙向編輯——在區域網路上以位址連線,或從任何地方透過 bromure.io 帳戶連線。

該伺服器是內嵌的 — 它是內建於應用程式中的 Apple swift-nio-ssh 函式庫,而非 macOS 自己的 sshd。這個區別很重要:因為應用程式執行自己的伺服器,它可以透過 OpenDirectory 驗證你的 macOS 帳戶密碼,而你完全不需要在「系統設定」中啟用遠端登入,也不需要管理員權限。它只為執行應用程式的那個確切 macOS 使用者接聽,並強制每一次互動式登入都進入遠端選單。唯一面向機器的例外是完整用戶端使用的四個白名單指令(bromure-fatclient/1 control、forward <ip> <port>、forward-udp <ip> 與 browser-mcp <vm>);使用者輸入的任何其他內容都會被當成登入處理,並進入選單。

附註: 遠端存取視窗將該伺服器描述為「應用程式自有的系統 SSH 伺服器實例」。更精確地說,它是一個內嵌的 swift-nio-ssh 伺服器,刻意不是 macOS 的 sshd — 這正是讓它能在不啟用遠端登入或管理員權限的情況下運作的原因。

在主機上啟用遠端存取

遠端存取在你開啟之前都是關閉的,而且可以用兩種等效方式管理:遠端存取視窗或 bromure-cli remote CLI。兩者寫入同一個位置,因此在其中一處所做的變更會反映在另一處,並即時生效。

遠端存取視窗

開啟 Bromure Agentic Coding(應用程式名稱選單)→ Remote Access…。視窗標題是遠端存取。一個綠色或灰色圓點顯示 sshd 執行中或 sshd 已停止;當伺服器運作時,一個 ssh -p <port> <user>@<host> 形式的可複製連線字串會出現在標題下方。

區塊欄位用途預設值
標題透過 SSH 啟用遠端存取啟動與停止伺服器。關閉
接聽器繫結 IP要接聽的介面。0.0.0.0 = 每個介面;127.0.0.1 = 僅此 Mac。0.0.0.0
接聽器連接埠接聽器 TCP 連接埠;必須 ≥ 1024(非 root 程序無法繫結特權連接埠)。2222
驗證macOS 帳戶密碼接受執行應用程式的使用者的 macOS 登入密碼(透過 OpenDirectory 驗證)。開啟
驗證公開金鑰接受下方已授權金鑰清單中的金鑰。開啟
伺服器主機金鑰指紋伺服器自己的 ed25519 主機金鑰指紋,供頻外驗證使用。在首次使用前顯示為**(於初次啟用時產生)**。—
已授權公開金鑰清單已註冊的 ssh-ed25519 / ecdsa 公開金鑰。透過貼上金鑰行來新增;以垃圾桶圖示移除。清單為空時顯示尚未註冊任何金鑰。空白

編輯繫結 IP 或連接埠並按下 Return 即可即時套用變更。驗證區塊註明**已針對 <user> 驗證 — 執行 bromure-ac 的使用者。**因此可清楚知道是誰的密碼解鎖了這扇門。

警告: 至少必須維持一種驗證方式啟用 — 你無法同時關閉密碼與公開金鑰驗證。貼上無效金鑰會被拒絕並顯示並非有效的公開金鑰。新增或移除已授權金鑰會重新啟動接聽器,這會中斷任何進行中的連線。

bromure-cli remote CLI

CLI 透過應用程式僅限擁有者的控制通訊端與執行中的應用程式溝通,因此應用程式仍是單一事實來源。這是在你透過既有 shell 存取的無頭 Mac 上啟用存取的最快方式。

指令作用
bromure-cli remote(或 remote status)印出啟用/執行狀態、繫結與連接埠、驗證方式、主機金鑰指紋、登入使用者、現成的連線字串,以及編號的已授權金鑰清單。
bromure-cli remote enable [--port N] [--bind IP] [--password|--no-password] [--pubkey|--no-pubkey]啟動伺服器(必要時自動啟動應用程式代理程式)。預設值:連接埠 2222、繫結 0.0.0.0、兩種驗證方式皆開啟。
bromure-cli remote disable停止伺服器並保存關閉狀態。
bromure-cli remote key add <path-or-key-text>從檔案路徑或貼上的金鑰行註冊公開金鑰;印出其指紋。
bromure-cli remote key ls以 1 為起始索引列出已授權金鑰,含指紋與註解。
bromure-cli remote key rm <index|fingerprint>依索引或指紋子字串移除金鑰。

若你同時傳入 --no-password 與 --no-pubkey,remote enable 會拒絕執行;而在基底映像檔缺少或安裝中時它會回報錯誤。當應用程式未執行時,status、disable 與 key ls 會印出沒有正在執行的 bromure-ac 代理程式。

附註: 在基底映像檔缺少或仍在安裝時,伺服器不會啟動 — 此時啟用會傳回一個可據以處理的錯誤,而非無聲的無動作。這在啟動時與你切換開關時皆是如此。請先安裝或完成安裝基底映像檔。

主機金鑰、指紋與信任

在初次啟用時,伺服器會產生一個 ed25519 主機金鑰。其指紋 — 顯示於伺服器主機金鑰列,以及由 bromure-cli remote status 以 256 SHA256:… bromure-ac-remote (ED25519) 形式顯示 — 是連線用戶端用來確認自己連到正確 Mac 的依據。將此指紋交給連線者(或在完整用戶端的首次接觸工作表中自行核對),如此中間人便無法冒充主機。關於完整用戶端如何釘選它,請參閱初次使用即信任。

速率限制

密碼嘗試由權杖桶依來源 IP 節流:五次全速嘗試,接著約每兩秒補充一次,並將施加的延遲上限設為八秒。嘗試會被延遲,永不拒絕,且沒有人會被鎖定;一個吵雜的 IP 無法拖慢另一個。公開金鑰驗證從不節流。

透過純 SSH 登入

任何終端機都能以 ssh -p 2222 <user>@<mac> 存取主機。連線不會進入 shell,而是進入遠端選單 — 一個 curses 風格的 TUI(內部為 bromure-ac __remote-menu),強制加諸於每一次使用者登入之上。永遠無法透過它取得原始 shell。

此選單早於以工作階段為中心的重新設計,並以機器為核心組織:一份工作區清單,附有即時狀態符號(● 執行中、◌ 開機中、⏸ 已暫停、○ 關閉),另有模型(已安裝的模型與裝置端目錄)與 Trace(摘要、主機名稱、洩漏)區段。你可以在這裡:

  • 以單一畫面的表單建立工作區,並透過 Full settings… 進入各窗格的設定表單。
  • 啟動、暫停、終止、重新開機或刪除任何工作區。
  • 編輯設定。 密鑰顯示為 •••• (set);將密鑰留空會保留已儲存的值。
  • 管理工作樹——建立、合併、附加終端機或捨棄。
  • 產生 SSH 金鑰、切換 Fusion 與模型路由,以及瀏覽追蹤摘要。
  • 附掛至任何 tmux 分頁或執行中的 Docker 容器。

附註: 選單的設定表單無法編輯模型看板。其模型表單為唯讀:它列出伺服器的供應商(API 金鑰或訂閱),並說明工作區是否覆寫全域設定。請在 Mac 上的偏好設定,或鏡像的遠端偏好設定中選擇供應商與模型。

以方向鍵導覽,Enter 選取,q 或 Esc 返回;結束(中斷連線)會結束工作階段。選取附掛會將終端機交給客體的 tmux;Ctrl-b d 會脫離回到選單。當你處於附掛狀態時,一個疊加鍵組(預設 Ctrl-])會彈出一個主機端控制器 — 切換分頁、開新分頁、管理工作樹、切換 Fusion 或路由、編輯設定、重新開機、暫停或中斷連線 — 且該按鍵永遠不會傳到客體。附掛至容器時會提示輸入 shell(Enter = sh)。

附註: 選單需要真正的終端機。在沒有 TTY 的情況下連線,會顯示以 ssh -t 重新連線的提示。啟動冷的工作區時,會先等待客體的 tmux 工作階段最多約 20 秒,再進行附加。

疊加鍵組可在主機 Mac(被連線的機器)上透過檔案 ~/Library/Application Support/BromureAC/remote/overlay-key 設定 — 接受的形式有 C-]、^]、0x1d 或 29 — 或透過 BROMURE_OVERLAY_KEY 環境變數設定。

使用完整用戶端鏡像遠端

完整用戶端會把這台 Mac 上的 Bromure Agentic Coding——或 iPhone、iPad、Apple Vision Pro 上的 Bromure Remote——變成遠端實例的即時鏡像。在 Mac 上,你會得到一個標題為 Remote — <name> 的完整視窗,外觀與操作都和本機主視窗相同:工作階段主頁、房間與總機、機器、任務與自動化看板。你所做的一切都在遠端執行,並回傳結果。

連線

開啟 工作區 › 連線到遠端 Bromure…(⇧⌘K)。視窗總結了這個選擇:*「鏡像另一台執行 Bromure 的 Mac——包括其格線、工作區、分頁和自動化。登入後可隨處存取你的伺服器,也可以直接透過區域網路位址加入。」*兩條路徑都會進入同一個鏡像視窗;差別只在於兩台裝置如何找到彼此並授權。

附註: SSH 交握會依連線狀況調整:連線與交握的時間預算會隨實測的來回時間縮放,因此高延遲的連線(旅館 Wi-Fi、行動網路、相隔一個大陸)只是連得比較慢,而不會逾時失敗。

以位址(同一網路)

當你知道 Mac 的位址且不需要 bromure.io 帳戶時,在 LAN 上使用這種方式。

  1. 在遠端 Mac 上,啟用遠端存取(遠端存取視窗或 bromure-cli remote enable)。
  2. 在這台 Mac 上,按一下 +,輸入名稱(例如 rack mini)、位址、連接埠(預設 2222)與遠端使用者,然後按一下連線。已儲存的列會顯示 user@address:port 以及上次連線的時間。
  3. 在首次接觸時,一個工作表會顯示遠端的 SSH 主機金鑰指紋。將它與遠端的遠端存取視窗核對,然後按一下信任並繼續。此釘選會為這個端點記住;除非金鑰變更,否則之後的連線都是無聲的,在金鑰變更的情況下按鈕會變紅並顯示信任新金鑰並繼續 — 這可能是中間人。
  4. 用戶端會先以這台裝置的專用金鑰嘗試公開金鑰驗證。若尚未獲得授權,則退回使用遠端使用者的 macOS 登入密碼(按鈕:登入);密碼登入成功後,會透過通道把這台裝置的金鑰註冊到遠端,之後每次連線都不需要密碼。若要在完全不輸入密碼的情況下預先授權,請點按 顯示這台 Mac 的金鑰,然後在遠端執行 bromure-cli remote key add '<this Mac's key>'。

首次連線後,雙擊已儲存的伺服器即可一鍵重新連線;每一列的情境選單提供 連線、編輯… 與 移除。iPhone 與 iPad 上的 Bromure Remote 在 透過位址加入伺服器 下提供相同流程。

透過 bromure.io 帳戶(從任何地方)

登入 bromure.io 可讓用戶端跨網路連到你的伺服器——從咖啡店的 Wi-Fi 連到家中的 Mac——不需要連接埠轉送、不需要 VPN,也不需要記住任何位址。bromure.io 只負責介紹兩台裝置,並在無法建立直接路徑時轉送位元組;SSH 工作階段本身在兩者之間始終保持端對端加密。

  1. 登入。 在 Mac 上,從 App 名稱選單選擇 登入 bromure.io…,並透過瀏覽器登入(或展開代碼區段,輸入六個字的註冊代碼與 裝置名稱)。在 Bromure Remote 中,從其開始畫面登入。你註冊的每一台裝置都共用同一個帳戶。
  2. 在遠端 Mac 上,啟用遠端存取。只有當某台伺服器的前門開啟且正在向 bromure.io 送出心跳時,它才會出現在目錄中。
  3. 在用戶端上,開啟 連線到遠端 Bromure…。你的伺服器會列在 我的伺服器 · bromure.io 之下,附有即時的上線圓點與最後上線時間。雙擊其中一台(或選取後點按 連線)。在建立點對點路徑——直接、透過路由器連接埠對應,或經由轉送——的期間,狀態會顯示 「Connecting to <name> via bromure.io…」,然後鏡像隨即開啟。

在這條路徑中,沒有要輸入的位址、沒有主機金鑰工作表,也沒有密碼:你自己的裝置透過你的帳戶彼此信任(見下方),而主機金鑰會自動釘選。

在你自己的裝置之間免密碼

一旦你登入,你註冊的每一台裝置都會透過你的帳戶共用其 SSH 身分,因此你的任何裝置都能抵達你的任何伺服器,不需密碼,也不需手動 bromure-cli remote key add:

  • 每台裝置在啟動時都會把自己的 SSH 公開金鑰發佈到 bromure.io。你的每台伺服器(已開啟遠端存取)會在數秒內取得你各裝置的金鑰並安裝到其 authorized_keys,因此剛註冊的裝置幾乎立即就會獲得授權。
  • 伺服器也會發布它所執行的 macOS 登入帳戶,因此用戶端會自動以正確的使用者撥號連線(正是以位址路徑要求你填寫的那個欄位)。
  • 金鑰僅限於你自己的裝置——即使在同一組織內,也絕不屬於其他使用者。
  • 在某台裝置上登出會讓它退役:它的金鑰會從你的伺服器上移除,它也會從目錄中消失,因此重新登入絕不會留下過時的重複項目。閒置 90 天的裝置也會停止被授權,直到它下次回報。此外,你也可以從 bromure.io 的網頁主控台依需求登出你的任何裝置。

附註: 完整用戶端第一次使用時會產生自己專用的 ed25519 金鑰對(註解為 bromure-ac-fatclient)——這就是發佈到你帳戶的金鑰。以位址連線時,主機金鑰的釘選屬於端點(address:port),而非使用者,因此編輯已儲存伺服器的位址或連接埠會捨棄釘選,並再次顯示指紋表單;bromure.io 連線則改為透過帳戶釘選對等端的金鑰。

鏡像視窗

連線成功後,鏡像視窗會自動開啟。它就是遠端 Mac 的工作階段主頁:相同的側邊欄(工作階段、房間、總機、任務、自動化、含任何 Kubernetes 叢集與登錄檔的虛擬機器)、相同的舞台與相同的標題列。以 新增工作階段(⌘N)開始工作階段、與它聊天、回答它的問題、開啟帶有聊天格線的房間,或與遠端的總機對話——這一切都在遠端進行,⌘K 指令面板也能使用。

標題列有與本機視窗相同的控制項:用於工作階段終端機的 終端機膠囊、以機器命名的機器選單(設定…、機器詳細資訊、拷貝 IP 位址、檢查追蹤、在獨立視窗中開啟、重新開機)、Fusion 閃電圖示、顯示或隱藏代理式瀏覽器 (⌃⌘B) 以及 顯示或隱藏「檔案」面板 (⌃⌘E)。鏡像視窗另外加入一個專屬控制項:網路通道開關(請參閱系統範圍網路通道)。終端機會以機器自身的外觀呈現。

有幾項功能在鏡像中的行為較為特殊:

  • 設定… 會開啟與本機相同的設定編輯器,其背後是清空密鑰的讀取與保留密鑰的儲存(請參閱密鑰留在主機上)。其模型窗格會編輯該遠端機器對遠端 Mac 模型設定的覆寫。Generate new SSH key 可正常運作,並會顯示新的公開金鑰。
  • 「檔案」面板(⌃⌘E)會透過通道瀏覽機器的檔案。它取代了先前版本中獨立的檔案瀏覽器視窗。請參閱機器。
  • 重新開機 的運作方式與伺服器自己的視窗相同:在 重新啟動「…」? 之後進行正常重新開機,或在選擇時按住 ⌥ 以強制重新開機(請參閱重新啟動機器);之後指令會送往伺服器。
  • 在獨立視窗中開啟 會開啟額外的即時終端機視窗,該視窗會在機器停止時自動關閉。

如果遠端執行的是沒有工作階段 API 的舊版 Bromure,鏡像會退回舊的以機器為中心的版面。

選單作用於前景的鏡像

當鏡像視窗是主要視窗時,下列選單項目會作用於遠端 Mac,而不是這台 Mac:

項目對被鏡像 Mac 的效果
新增工作階段…(⌘N)開啟鏡像的新工作階段畫面。
工作區 › 新增房間…在遠端建立房間。
下一個房間(⌃⌘R)輪流切換遠端的房間(會略過已封存的房間)。
工作區 › 基礎架構 › 建立 Kubernetes 叢集… / 建立登錄…在鏡像中開啟建立表單,因此叢集或登錄檔會建立在遠端上。
偏好設定…(⌘,)開啟以遠端為對象的偏好設定(如下)。

遠端偏好設定

在鏡像視窗位於前景時按下 ⌘,,偏好設定會以那台 Mac 的預設值開啟,標題為 偏好設定 — <host>。只要有鏡像視窗開啟,偏好設定頂端的 設定對象: 選擇器就能在 此 Mac 與每個已連線的遠端之間切換;每個對象都有自己的編輯器,因此草稿絕不會跨機器混用。載入遠端設定期間,視窗會顯示「正在從 <host> 載入偏好設定…」;若載入失敗,則顯示 無法載入遠端偏好設定 與 重試。

一切都經由遠端往返處理:密鑰送達時為空白,除非你輸入新的值,否則會保留原值。模型窗格會編輯遠端的全域模型設定——API 金鑰會以遮蔽方式顯示——而變更會在你點按 儲存 時儲存;這與本機偏好設定不同,後者的模型看板會隨著編輯即時儲存(請參閱模型與供應商)。這台 Mac 自己的 App 層級設定——自動化窗格,以及資源中的 工作區子網路 與 遠端傳輸 區段——不會為遠端顯示,也不會出現在遠端機器的編輯器中。

從遠端登入供應商

訂閱登入可從用戶端端對端完成。Sign in with 供應商 會在遠端執行擷取,但供應商的登入頁面(或裝置代碼 URL)會在你的瀏覽器中開啟;對於從不顯示 URL 的供應商,用戶端會顯示登入 VM 的終端機,讓你以互動方式完成。從遠端機器設定開始的登入,會在你的螢幕上詢問範圍問題——每個工作區 或 僅此工作區;若沒有人回答,則維持 僅此工作區。從遠端偏好設定開始的登入,一律由遠端上的所有機器共用。登出… 也可以從遠端操作。

從遠端使用分支與檢視

對於擁有自己資料夾的工作階段,新增分支…、檢視變更 與 合併到 分支 都能在鏡像中使用,與在遠端自己的螢幕上完全相同(請參閱分支與檢視)。在 Bromure Remote 中,工作階段的選單提供 新增工作樹…。

詢問被鏡像 Mac 上的工作階段

當這台 Mac 正在鏡像遠端時,這裡的工作階段可以透過 @暱稱詢問遠端上的工作階段:遠端工作階段會出現在撰寫區的 @ 清單中,並以其主機名稱呈現給代理程式;附加在請求中的檔案會經由通道送進對方的收件匣。回答、方向調整與結束也都沿同一路徑回傳。反方向——遠端的代理程式詢問這台 Mac 上的工作階段——無法使用,因為遠端沒有回到用戶端的通道。

鏡像的內容

鏡像會顯示每台機器及其即時執行狀態、工作階段與房間、分頁與分支、格線、自動化、程式設計任務看板、機器詳細資訊與健康指標、Docker 儀表板、Kubernetes 叢集與登錄檔、即時互動式終端機,以及遠端的安全事件——這些事件會與這台 Mac 的事件並列顯示在安全性時間軸中,其機器篩選器提供 所有機器、此 Mac 與每台被鏡像的主機。裝置端模型及其下載都在遠端執行,絕不在用戶端上。編輯會在每個已連線的用戶端上收斂:機器的啟動、停止與重新開機、工作階段與房間操作、分頁操作、格線編輯(整個版面,最後寫入者為準)、自動化編輯、Fusion 開關、Docker 動作、設定儲存與檔案傳輸。

鏡像透過推播通道(GET /state/subscribe)追蹤遠端,該通道位於經 SSH 通道連到遠端控制通訊端的橋接上;推播通道正常時,用戶端只會每 5 秒重新讀取一次完整狀態作為心跳,若通道中斷則改為每 0.75 秒讀取一次。簡短的控制呼叫在每台主機的一條 SSH 連線上多工傳輸;互動式終端機附加則使用各自專用的 SSH 連線,因為多工通道會緩衝終端機需要立即取得的輸出。透過 bromure.io 連線時,同樣的橋接與終端機串流會走點對點路徑,鏡像的行為完全相同。

聊天也會節省連線頻寬。第一次開啟遠端工作階段的聊天時,只會載入對話中最新的約 1.5 MB;向上捲動到 載入更早的對話 時,才會取得較舊的部分。再次開啟的聊天——點回某個工作階段,或再次顯示某個房間——會從已下載的歷史開始,只取得新訊息。

有幾項操作無法從完整用戶端使用:

  • 格線版面編輯需要遠端上開著 GUI 視窗。完全無介面的遠端(App 執行中但沒有主視窗)會鏡像其他所有內容,但無法接受版面變更。
  • 從檔案匯入 SSH 金鑰在遠端設定編輯器中是隱藏的。

iPhone、iPad 與 Apple Vision Pro 上的 Bromure Remote

Bromure Remote 是純用戶端的鏡像,連線方式完全相同(登入並挑選伺服器,或以位址加入伺服器)。它和 Mac 一樣以工作階段為中心:

  • iPhone——一份 工作階段 清單,並顯示需要你處理的工作階段數量;一個新工作階段畫面(「我能幫你做什麼?」);以及每個工作階段各自的畫面:其聊天、用於終端機的 終端機 按鈕,以及包含 恢復、重新命名…、新增工作樹…、機器設定、封存(或 結束並封存)、結束工作階段 與 刪除工作階段 的選單。房間會以每個工作階段一個分頁的方式開啟,可左右滑動切換,並附有房間的總機。
  • iPad——常駐的側邊欄,包含工作階段、房間與機器;房間會像在 Mac 上一樣顯示其聊天格線。

在兩者上,清單的順序都與 Mac 側邊欄相同:先是 新增工作階段,正下方是 編碼任務 與 自動化,然後是工作階段。機器分成 虛擬機器(附格線)與 Native Machines——遠端所連接的 Sidecar Mac,只在有的時候才顯示;原生機器提供 新增終端機。在 iPad 上,新增工作階段 會一直顯示在可摺疊的工作階段區段上方。

當遠端拒絕啟動工作階段時(例如在沒有該代理程式的 Sidecar Mac 上),用戶端會顯示遠端給的理由,而不是毫無反應。

  • Apple Vision Pro——iPad 的版面,再加上空間視窗:可把任何終端機釘選為獨立視窗放在房間中的任何位置、把格線開成專用的舞台視窗,或以 Pin All as Windows 把整個格線變成浮動視窗。

在房間中,底部的單一撰寫區有一個 傳給 選擇器——房間的總機或其中任一工作階段——以及附件選單(照片圖庫、選擇檔案、貼上圖片);附件會在傳送時上傳到目標的機器。在 iPhone 與 iPad 上,當 App 在背景時,需要你輸入的工作階段可以透過推播通知找到你;點一下即可開啟該工作階段。這些裝置上無法使用模型看板;請在 Mac 上變更模型。

待處理的決策提示

有些動作會在遠端引發需要決定的事項——家目錄儲存空間升級、基礎映像檔漂移重設、清除遭入侵的 VM、關閉動作的詢問、供應商登入的範圍問題,或憑證外洩警示(入侵偵測器暫停了一台試圖洩漏憑證的 VM)。這些會以警示形式出現在你的鏡像視窗中,你的回答會經由通道傳回。若提示無人回應,會逾時並採取安全的選項。待處理的提示絕不會阻擋遠端的控制平面:警示顯示期間,鏡像的其他部分仍保持即時。執行中的代理程式可能觸發的同意提示(憑證使用、供應鏈直通、護欄寫入、提示注入),則由另一條客體無法偽造的路徑處理,說明請見遠端同意處理。

密鑰留在主機上

密鑰絕不會跨越連線。當完整用戶端讀取遠端機器的設定或遠端的偏好設定時,每個密鑰欄位送達時都是空白的(模型供應商的 API 金鑰則以遮蔽後的替代值送達)。儲存時,空白或遮蔽的欄位代表「保留已儲存的值」,輸入的值則會取代它。API 金鑰、權杖、訂閱登入與 MCP 環境密鑰都留在遠端 Mac 上。配對完成後,完整用戶端只以 SSH 金鑰驗證——鏡像期間不會出現任何密碼提示。

存取遠端 VM 上的服務

遠端工作區的開發伺服器位於遠端網路上的一個私有位址,例如 http://192.168.64.5:3000。Bromure 為你提供兩層存取它的方式 — 一層是自動且限於瀏覽器範圍,另一層是選擇加入且系統範圍。

瀏覽器窗格(自動、限 PAC 範圍)

鏡像視窗中可收合的瀏覽器窗格(標題列的地球按鈕,或 ⌃⌘B)是一台本機 Chromium VM,其前往遠端工作區子網路的頁面流量會透過 SSH 建立通道。產生的 PAC(代理自動設定)指令碼只會把遠端子網路導向每台主機專屬的 SOCKS 轉送器,其餘一律 DIRECT,而目的地會在遠端解析——因此直接前往遠端開發伺服器的字面位址 http://192.168.64.x:port 就能運作。遠端代理程式自己的瀏覽器控制 MCP 串流會轉送到這個窗格,讓遠端的程式設計代理程式操作你正在看的瀏覽器。

在執行中的遠端機器上選取一個工作階段或機器,然後按 ⌃⌘B。在第一次狀態更新送來遠端的子網路、且 SOCKS 轉送器啟動之前,窗格不會有任何動作(在那之前,記錄中會有一行「tunnel not ready」)。其本機瀏覽器 VM 固定於子網路 192.168.127.0/24(閘道 192.168.127.1),因此絕不會與工作區子網路衝突。持久性瀏覽器設定檔保存在這台 Mac 上,以遠端機器的 ID 為索引。

附註: 瀏覽器窗格要求這台 Mac 為 Apple Silicon 且本機已安裝瀏覽器基底映像檔。SOCKS 轉送器繫結 0.0.0.0(讓瀏覽器 VM 能在 vmnet 閘道存取它),但僅接受來自 loopback 與釘選的 192.168.127.x 瀏覽器子網路的連線 — 它絕不是開放中繼。

SOCKS 轉送與固定連接埠轉送

每一個已連線的遠端主機都會自動取得一個位於臨時連接埠、繫結 0.0.0.0(依對等端過濾為 loopback 與 192.168.127.x 瀏覽器子網路)的本機 SOCKS5 轉送器。每一次 CONNECT 會開啟一個 forward <ip> <port> SSH 通道,遠端會將其橋接 — 經由客體位於 vsock 5010 的常駐 loopback 中繼 — 至該客體自己的 127.0.0.1:<port>。因此從這台 Mac,curl --socks5 127.0.0.1:<port> http://192.168.64.5:3000 會逐位元組地抵達遠端客體。

固定轉送有隱藏的 CLI 管線:bromure-cli __forward <hostID> <localPort> <remoteIP> <remotePort> 用於 ssh -L 風格的轉送,而 bromure-cli __forward-socks <hostID> <localPort> 用於獨立的 SOCKS 代理伺服器。兩者預設都繫結 loopback,並接受 --bind-all。

警告: 遠端會拒絕任何目標不是其自身 vmnet 子網路上客體的轉送。你無法使用轉送來存取遠端 Mac 本身、其閘道或網際網路 — 只能存取工作區 VM。

系統範圍網路通道

當你希望任何本機 App——而不只是瀏覽器窗格——都能以字面位址連到遠端 VM 時,請用鏡像視窗的網路開關(連接圓點圖示,標題列控制項中的第一個)啟用每台主機的通道。其工具提示為 啟用對遠端主機 VM 的直接網路存取(任意本機 App 可存取 192.168.x.x)。

一個一次性的特權輔助程式 — 透過 SMAppService 安裝的 launchd 常駐程式,不需 sudo — 會建立一個 utun 介面並將遠端子網路路由至它,然後將該介面的檔案描述符交回給應用程式。應用程式中的一個使用者空間 TCP/UDP 堆疊會終止每一條流,並使用你的 SSH 身分將其接合至相同的 SSH 轉送通道上。沒有 pf 規則,也沒有核心轉送。

你首次啟用它時,一個標題為允許 Bromure 的網路輔助程式的警示會說明這一次性的 macOS 核准:

  1. 按一下工具列切換。
  2. 在警示中,開啟系統設定 → 一般 → 登入項目並允許 Bromure Agentic Coding(macOS 會要求一次管理員憑證)。
  3. 應用程式會輪詢核准(每 2 秒一次,最多 5 分鐘),並在它到位的那一刻自動連線。等待期間,切換的工具提示顯示正在等待系統設定 › 登入項目中的核准…。

若遠端尚未回報其機器子網路(尚無任何機器啟動),工具提示會顯示 正在等待遠端回報其工作區子網路(請啟動一個工作區)——點按以取消。通道建立後,工具提示會顯示 已開啟對遠端主機 VM 的直接網路存取——點按以關閉;若失敗,則顯示 網路隧道失敗——點按以重試。關閉開關會停止通道,而當最後一台主機停用它時,常駐程式會被取消註冊。此設定會依主機記住。

附註: 此通道需要管理員帳戶進行一次性核准。若沒有,Bromure 會繼續透過內建的 SOCKS 路徑運作 — 只有在需要從其他應用程式存取遠端 VM 時才需要此輔助程式。若 macOS 直接拒絕註冊,一個標題為無法安裝網路輔助程式的警示會加以說明,而切換會在下次點按時重試。對遠端客體的 ping 會由通道在本機回應:它確認的是路由已建立,而非客體存活。

多個遠端(各安裝專屬子網路與機群路由)

你可以同時鏡像多個遠端;每一個都會開啟自己的視窗、SOCKS 轉送器,以及(選擇性的)通道。這過去會踩到的陷阱:每一個安裝歷來都對其工作區 VM 使用相同的 192.168.64.0/24 網路,因此兩個被鏡像的遠端會通告相同的子網路,系統範圍的 VPN 無法區分它們。

各安裝專屬子網路從根本上解決這個問題。現在每台 Mac 都會在 172.16.0.0/12 內挑選一個隨機的 /24——略過 Docker 的 172.17–172.20 範圍,以及主機已經所在的任何 /24——並將它用於其所有工作區 VM,因此兩個獨立的安裝幾乎不會衝突(172.16/12 也是最不可能與企業區域網路或 VPN 衝突的私有範圍)。新的安裝會從這樣的子網路開始;你可以隨時在 偏好設定 › 資源 › 工作區子網路 中檢視、變更或重新隨機產生。客體的位址配置純粹是來自 Bromure 自有交換器的 DHCP,因此這完全是主機端的處理(不需重建映像檔),而遠端會在其狀態中公告所選的子網路,讓完整用戶端與通道自動跟隨。

在極少數兩個遠端仍然共用同一子網路的情況下,第一個會被字面路由,第二個會被賦予一個 100.64.<n>.0/24 CGNAT 空間別名,並以 1:1 保留主機八位元組的重新映射,讓兩者都能同時被存取。

警告: 多主機別名路由已實作並經單元測試,但跨主機縫合具別名意識的 PAC 與 browser-MCP 重新映射的執行時期接線仍在待辦中。單一遠端主機是目前完全支援的組態。 別名一旦接線後的一個已知限制是,具別名遠端內某個發出絕對字面 http://192.168.64.x 連結的開發頁面可能會誤路由;字面(非別名)遠端不受影響。

將開發伺服器公開到網際網路

與上述內容無關,在工作區內執行的單一 HTTP 服務,可以透過每個連接埠一條的 Cloudflare 快速通道公開到公用網際網路。開啟執行中機器的詳細資訊(機器選單 › 機器詳細資訊),在連接埠卡片下找到該服務,然後點按地球圖示(工具提示:公開到網際網路(Cloudflare 快速通道))。Bromure 會為該來源執行一個 cloudflared 程序,並給你一個隨機的 https://<name>.trycloudflare.com URL——不需要 Cloudflare 帳戶。每個服務一條通道與一個 URL;公開或取消公開其中一個,絕不會影響其他服務。

地球的顏色追蹤狀態:灰色 = 關閉,橙色 = 安裝或啟動中,綠色 = 執行中,紅色 = 失敗。連接埠下方的狀態列會顯示進度(正在下載並驗證 cloudflared(~18 MB,一次性)…,然後正在啟動通道…),或顯示可點按的公開主機名稱與一個複製按鈕。

第一次公開任何服務時,會出現一個標題為 透過 Cloudflare Tunnel 將服務公開到網際網路? 的一次性同意對話框,說明下載、驗證、通道程序(會記錄在安全性時間軸中)、Cloudflare 的服務條款,以及任何擁有該隨機 URL 的人都能存取該服務這一事實。再次點按地球圖示即可停止。

cloudflared 執行檔是固定的版本,在執行之前會經過兩次驗證:下載封存檔的 SHA-256 會與內建於 App 中的雜湊值比對,而 Developer ID 程式碼簽章檢查會確認 Cloudflare 的團隊 ID。它以 --no-autoupdate 執行。

警告: 快速通道 URL 對任何擁有它的人都是公開的,而且主機名稱會在通道每次重新啟動時(重新開機、取消公開/重新公開,或當機)輪替。只有 HTTP(S) 來源才會有地球 — SSH 與眾所周知的原始 TCP 或資料庫連接埠(22、1433、3306、3389、5432、5672、5900、6379、9092、11211、27017)以及 UDP 永遠不會有,因為瀏覽器無法透過 Cloudflare 的邊緣存取它們。工作區的所有通道都會在其 VM 暫停或關閉時拆除。下載時的雜湊不符會拒絕安裝,直到該釘選在某個應用程式發行版中更新為止。

OAuth 回呼轉送

在工作區 VM 內部執行的 CLI — gh、gcloud、訂閱登入 — 通常會透過在你的主機 Mac 上開啟瀏覽器並等待重新導向至 http://127.0.0.1:<port>/callback 來完成 OAuth 流程。Bromure 會自動橋接它:主機在 IPv4 與 IPv6 上繫結 loopback 連接埠,並在首次真正的請求時將其經由 vsock 5010 接合至客體自己的 127.0.0.1:<port>。redirect_uri 從不被改寫,因此 PKCE 與重新導向驗證仍然通過。沒有任何需要設定的內容 — 在工作區內啟動登入,重新導向便會送入客體。

轉送器在 300 秒後自行拆除,因此 loopback 連接埠絕不會被無限期佔用。若主機連接埠已被使用,該流程會在無橋接的情況下原生進行,而推測性的瀏覽器預先連線(開啟但從不傳送的通訊端)會被忽略,因此它們無法卡住一次性的回呼伺服器。

安全模型

遠端存取威力強大,因此值得精確說明它的邊界。

  • 預設關閉,單一入口。 在你啟用 SSH 伺服器之前不存在任何遠端路徑。每一條路徑 — 使用者選單、CLI、完整用戶端、連接埠轉送、瀏覽器 MCP — 都經由那一個伺服器,別無其他。
  • 加密與傳輸。 所有流量都是 SSH。完整用戶端的狀態串流與控制呼叫、終端機附加、檔案傳輸、連接埠轉送與瀏覽器 MCP 轉送,全都在 SSH 連線內傳輸。由於 swift-nio-ssh 沒有後量子金鑰交換,新版 OpenSSH 用戶端會顯示「not using a post-quantum key exchange」警告;這是預期中的情況,並不代表遭到降級攻擊。
  • bromure.io 是引介方,而非中間人。 在帳戶路徑中,bromure.io 只引介你的兩台裝置,並在無法建立任何直接點對點路徑時,透過一個 TURN 中繼(在 TLS 上)轉送不透明的位元組。它從不終止 SSH 工作階段:加密通道在你的兩台 Mac 之間端對端執行。SSH 金鑰只在你自己帳戶的裝置之間共用(絕不與其他使用者共用),每一台伺服器自行拉取其擁有者的裝置金鑰,而註冊/登出正是授予與撤銷某台裝置信任的方式。已登出或閒置 90 天的裝置會停止被授權。
  • 誰可以登入。 只有啟動應用程式的那個確切 macOS 使用者。密碼驗證對 OpenDirectory 進行驗證(無遠端登入、無 PAM 變更、無管理員權限),而公開金鑰驗證只接受你已註冊的金鑰。密碼嘗試依來源 IP 限速;金鑰則否。
  • 工作階段能做什麼。 使用者登入只能存取遠端選單 — 永遠不是 shell — 因此它可以建立、設定與驅動工作區,但無法執行任意的主機指令。完整用戶端的四個機器動作同樣狹窄:一個控制通訊端橋接、一個對 vmnet 子網路上客體的轉送,以及一個瀏覽器 MCP 中繼。對主機本身、閘道或網際網路的轉送都會被拒絕。
  • 密鑰絕不離開主機。 遠端設定的讀取會清空密鑰(模型供應商的金鑰會被遮蔽),儲存則會保留密鑰;API 金鑰、權杖、訂閱登入與 MCP 環境密鑰都留在遠端 Mac 上。
  • 初次使用即信任。 完整用戶端在首次接觸時依端點釘選遠端的主機金鑰,並在之後任何變更時大聲警告。
  • 客體無法偽造的同意。 執行中代理程式引發的 MITM 同意提示,會在終端機幫浦的主機側呈現,遭入侵的客體既看不到也無法偽造它們;任何逾時或脫離都解析為拒絕。請參閱遠端同意處理。

疑難排解

症狀可能原因該怎麼做
啟用時傳回錯誤基底映像檔缺少或仍在安裝在基底映像檔就緒之前伺服器無法啟動。完成安裝,然後再次啟用。
ssh 連上但要求以 ssh -t 重新連線未要求 TTY遠端選單需要終端機;加上 -t(或使用 ssh -t -p 2222 <user>@<mac>)。
OpenSSH 印出 "not using a post-quantum key exchange"swift-nio-ssh 沒有 PQ 金鑰交換預期且無害 — 連線仍然加密。
以位址連線一直要求密碼這台 Mac 的金鑰未在遠端註冊讓一次密碼登入自動註冊它,或在遠端執行 bromure-cli remote key add '<this Mac's key>'(顯示此 Mac 的金鑰可複製它)。
bromure.io 連線仍要求密碼金鑰註冊表尚未在該伺服器上授權此裝置這裡免密碼是自動的——確認你在兩台 Mac 上都已登入 bromure.io、伺服器已開啟遠端存取,且兩者都在執行目前的組建(伺服器會發布其登入帳戶並拉取你的金鑰)。啟用遠端存取後請等待幾秒。
我的伺服器 · bromure.io 為空未登入,或伺服器未在通告登入(應用程式名稱選單 → Log in to bromure.io…);在遠端啟用遠端存取,使其送出心跳並出現。灰階的列代表它已停止送出心跳。
「無法透過 bromure.io 建立連線……」兩台 Mac 之間沒有直接或中繼的網路路徑確認兩者都能抵達 bromure.io;中繼需要 turns:5349 可達。再試一次——下次嘗試會重試一條路徑。
「已透過 bromure.io 抵達……,但其 SSH 前門未回應」遠端上的遠端存取被關閉了在遠端 Mac 上重新啟用遠端存取。
「這台 Mac 的 bromure.io 裝置已被撤銷。請重新登入。」此裝置已被登出/撤銷(由你、網頁主控台,或閒置 90 天)重新註冊:應用程式名稱選單 → Log in to bromure.io…。
紅色的信任新金鑰並繼續工作表遠端的主機金鑰自釘選以來已變更頻外驗證;只有在你知道金鑰為何變更(重新安裝、新 Mac)時才繼續 — 否則它可能是中間人。
編輯金鑰後進行中的連線中斷新增或移除已授權金鑰會重新啟動接聽器預期行為;重新連線。
瀏覽器窗格一直空白SOCKS 轉送器或子網路尚未就緒等待鏡像的第一次狀態更新;確認機器正在執行,且這台 Mac 已安裝瀏覽器映像檔。
轉送被拒絕目標不是遠端 vmnet 子網路上的客體轉送只能存取工作區 VM,永遠無法存取主機、閘道或網際網路。
通道切換卡在正在等待核准…特權輔助程式尚未獲核准在系統設定 → 一般 → 登入項目中核准 Bromure Agentic Coding(需要管理員)。若沒有,SOCKS 仍可運作。
格線版面配置編輯在遠端無效遠端是無頭的格線編輯需要遠端上開啟一個 GUI 視窗;其他所有內容仍會鏡像。

檔案、連接埠與環境變數

伺服器端狀態位於 ~/Library/Application Support/BromureAC/remote/ 下:hostkey_ed25519(0600)及其 .pub、authorized_keys(0600),以及選用的 overlay-key 覆寫。完整用戶端的身分與狀態位於 ~/Library/Application Support/BromureAC/remote-client/ 下:id_ed25519(.pub)(註解 bromure-ac-fatclient)、known_hosts(TOFU 釘選)、hosts.json(已儲存的伺服器),以及位於 hosts/<host-UUID>/ 下的每主機鏡像持久性。整個支援目錄會在 CFFIXED_USER_HOME 下重新定位。

連接埠/介面角色
TCP 2222(可設定,≥ 1024)內嵌 SSH 伺服器,預設繫結 0.0.0.0。
對外 TCP 443 + turns:5349僅 bromure.io 帳戶路徑。 抵達你的帳戶(裝置目錄、會合),以及在無法建立任何直接點對點路徑時的 TURN 中繼(在 TLS 上)。對於帳戶路徑,兩者都必須能從每一台裝置抵達;與以位址路徑無關。
客體 vsock 5010每一個 VM 中的常駐 loopback 中繼 — 連接埠轉送與 OAuth 回呼傳遞的路徑。
客體 vsock 5830工作區代理程式的瀏覽器 MCP 串流,中繼至完整用戶端的瀏覽器窗格。
臨時連接埠,繫結 0.0.0.0每主機 SOCKS5 轉送器(依對等端過濾為 loopback 與 192.168.127.x 瀏覽器子網路)。
192.168.127.0/24完整用戶端釘選的本機瀏覽器 VM 子網路。
100.64.<n>.0/24在機群子網路衝突時指派的 CGNAT 別名子網路。

相關的 UserDefaults 鍵(網域 io.bromure.agentic-coding)為 remoteAccess.enabled、remoteAccess.port、remoteAccess.bindAddress、remoteAccess.passwordAuth、remoteAccess.pubkeyAuth、fatclient.tunnel.<host-UUID> 與 cloudflareTunnel.consented。診斷用環境變數包括 BROMURE_OVERLAY_KEY(遠端選單快速鍵)、BROMURE_FATCLIENT_LOG(完整用戶端的詳細記錄)與 BROMURE_FATCLIENT_UTUN(強制啟用系統範圍通道的選用功能——工具列開關才是產品路徑)。完整的 CLI 參考,包括隱藏的 __forward、__forward-socks、__dial 與 __attach-window 底層指令,位於 CLI、API 與 MCP。