Antigravity 能用 SSH 連遠端 Linux 了!App 設定步驟、主機需求與常見錯誤

0
32 人次
廣告

Antigravity 能用 SSH 連遠端 Linux 了!App 設定步驟、主機需求與常見錯誤

用 AI 代理寫程式,常遇到一個麻煩是專案和執行環境其實放在另一台機器上,例如租來的 VPS、家裡的 Linux 主機或公司的開發機。以前要嘛把程式碼搬回自己電腦,要嘛在遠端裝 CLI 版從終端機操作。Google Antigravity 在 2026 年 11 月 17 日推出的 App 2.33.0 版,加入了「Connect over SSH」功能,App 可以直接透過 SSH 連到遠端 Linux 主機,讓專案、代理、Git worktree 和終端機都在主機上執行。

官方文件寫明,關掉視窗或讓筆電進入睡眠,主機上的代理會繼續工作,下次連回去再接上就好。不過這個功能對遠端主機有不少限制,最重要的一點是遠端只支援 64 位元 Linux,macOS 和 Windows 都不能當遠端主機。阿正老師這篇把需求、連線步驟和常見錯誤整理清楚,也提醒一下安全上要注意的地方。



一、Antigravity 的 SSH 連線是什麼?

Antigravity 是 Google 推出的 AI 代理開發平台,有桌面 App、CLI 和各家編輯器的延伸模組。這次的 SSH 功能只在 Antigravity App 上提供。連線時,App 會透過電腦上的 OpenSSH 自動在遠端主機安裝一個伺服器程式,之後專案、AI 代理、Git worktree、終端機和各種自訂設定都直接在主機上執行,本機的 App 只負責顯示和操作。

如果你平常習慣在終端機工作,官方也說明可以改在主機上安裝 Antigravity CLI,自己用 ssh 登入後使用。想了解 Windows 上的 CLI 操作,可參考站上的 Antigravity CLI 完全教學。

Antigravity 官方文件〈Connect over SSH〉頁面開頭的功能說明
圖片來源:antigravity.google,擷取於 2026-11-20
官方網站 https://antigravity.google/
本站下載站版本 2.33.0(發布日期:2026-11-20)
SSH 功能所需版本 Antigravity App 2.33.0 以上(2026 年 11 月 17 日推出)
支援系統 本機 App:macOS、Windows、Linux;遠端主機:64 位元 Linux(x86_64 或 arm64)
費用 未訂閱 Google AI Pro 或 Ultra 的個人帳號有每週更新的基本額度。Pro 和 Ultra 的額度較高。SSH 說明頁未標示方案限制
SSH 支援的登入帳號 個人 Google 帳號、Google Workspace、Pay As You Go、Gemini Enterprise
軟體下載 [本站下載點]。若本站版號低於 SSH 功能需求,請到官方網站取得新版

二、SSH、Remote Control、Remote Agents 差在哪

Antigravity 現在有三種「遠端」用法,名稱很像,用途不同。官方文件整理的差異如下。

方式 代理在哪裡執行 從哪裡操作 主機端要準備什麼
Connect over SSH 你的遠端 Linux 主機 Antigravity App 不用另外安裝,App 透過 OpenSSH 自動設定
Remote Control 你自己的桌機或伺服器 網頁瀏覽器 安裝並登入 App 或 CLI
Remote Agents(Pro/Ultra) Google 代管的環境 App、CLI 或網頁瀏覽器 不用,附上程式庫或檔案即可

簡單分辨的方式是看「程式碼和代理放在哪」。專案在自己的 Linux 主機上,想用 App 介面操作,就用 SSH;人在外面想用手機或別台電腦的瀏覽器遙控家裡正在跑的 Antigravity,用 Remote Control;不想自己準備機器,交給 Google 的環境跑,才是 Remote Agents。家裡的電腦是 Mac mini 或 Windows 的讀者,因為不能當 SSH 遠端主機,想遠端操作時要改用 Remote Control。


三、使用前檢查:本機與遠端主機需求

連線前,先依官方文件逐項確認本機與遠端主機的需求。

三、使用前檢查:本機與遠端主機需求-Antigravity 能用 SSH 連遠端 Linux 了!App 設定步驟、主機需求與常見錯誤

本機電腦 Antigravity App 2.33.0 以上(macOS、Windows 或 Linux),並安裝 OpenSSH(PATH 裡找得到 ssh 或 ssh.exe,或用環境變數 ANTIGRAVITY_SSH_BIN 指定)
遠端作業系統 64 位元 Linux(x86_64 或 arm64),glibc 2.26 以上,例如 Ubuntu 18.04、Debian 10、RHEL 8 以後。macOS、Windows 與使用 musl 的 Linux(例如 Alpine)不支援
SSH 連接埠轉送 主機(以及經過的跳板主機)的 sshd_config 要允許 AllowTcpForwarding yes(或 local)
儲存空間與網路 主機能連外 HTTPS;家目錄可寫入、可執行,伺服器裝在 ~/.antigravity-hub-server/,代理資料放在 ~/.gemini/
⚠️ 請只連線到你自己擁有、或已取得管理者授權的主機。公司或學校的伺服器,先確認內部規定是否允許安裝第三方伺服器程式與讓 AI 代理執行指令。

四、連線步驟:從 App 連到 SSH 主機

確認需求後,在 Antigravity App 裡依下面四步連線。官方提供三種開啟 SSH 對話框的方式,挑一種習慣的就好。

四、連線步驟:從 App 連到 SSH 主機-Antigravity 能用 SSH 連遠端 Linux 了!App 設定步驟、主機需求與常見錯誤

Step 1|開啟 SSH 對話框 三種方式任選其一。側邊欄(Software Engineering 版面)點 Projects 旁的 Create New Project,選 SSH Host…;或按 Cmd+Shift+P(macOS)/Ctrl+Shift+P(Windows、Linux)開命令面板,執行 Connect to SSH Host…;也可以用參數 --ssh-host=<主機> 啟動 App。

Step 2|選擇或輸入主機 清單會列出最近連過的主機(Recent)和 ~/.ssh/config 裡設定的主機(SSH Config)。也可以直接輸入主機別名、[使用者@]主機[:埠號] 或 ssh://[使用者@]主機[:埠號]。要用另一份設定檔,點 Choose File…。

Step 3|連線並驗證 按 Connect。Antigravity 會自動使用你的 OpenSSH 金鑰、ssh-agent 和 ProxyJump 設定。在 macOS 和 Linux 上,主機金鑰確認、金鑰密語、密碼、兩步驟驗證碼和安全金鑰觸碰都會在 App 裡提示;Windows 如果沒有跳出這些提示,官方建議先把金鑰載入 ssh-agent,並在終端機手動執行一次 ssh 主機,讓 known_hosts 記錄主機。

Step 4|登入 Antigravity 帳號 標題列顯示「(SSH: 主機)」的新視窗開啟後,依提示登入。登入流程在本機瀏覽器完成,憑證會存到遠端主機上。

常用的主機建議先寫進 ~/.ssh/config,之後在清單裡直接點選即可。官方文件的範例格式如下(以下 IP 為文件用的範例位址,請換成自己的主機資料)。

Host devbox
  HostName 203.0.113.10
  User alice
  Port 22
  IdentityFile ~/.ssh/id_ed25519
  ProxyJump jump.example.com

寫了具體名稱的 Host(不含 *、?、! 萬用字元)才會出現在 SSH Config 清單裡;像 Host * 這種萬用規則連線時仍會套用。另外,Antigravity 會在連線指令上強制關閉 ForwardAgent、ForwardX11、ControlMaster 等設定,所以 config 裡這幾項不會生效。


五、SSH 視窗裡能做什麼、哪些功能不一樣

每台主機會開在獨立視窗,標題列和側邊欄底部都會標示「SSH: 主機」。在這個視窗裡,建立專案時瀏覽的是遠端的檔案系統;代理的工具、終端機、沙盒與權限設定也都在主機上執行。Skills、規則、hooks、MCP 伺服器與外掛,則從主機上的 ~/.gemini/ 和專案資料夾載入。

五、SSH 視窗裡能做什麼、哪些功能不一樣-Antigravity 能用 SSH 連遠端 Linux 了!App 設定步驟、主機需求與常見錯誤

跟本機視窗相比,下面幾個功能不一樣。

  • 內建瀏覽器 側邊的瀏覽器面板不會出現,網址會用本機的預設瀏覽器開啟。/browser 指令連的是遠端主機上開啟遠端偵錯的 Chrome。
  • 語音與媒體 語音模式和聽寫會詢問是否允許主機使用麥克風,鏡頭與螢幕存取維持停用。
  • 本機檔案動作 「在 IDE 中開啟」「在 Finder(或檔案總管)中顯示」等本機操作會隱藏。

斷線或關閉視窗後,主機上的代理會不會停,官方整理如下表。

動作 視窗與 SSH 通道 主機上的伺服器與代理
關閉視窗 關閉並中斷 SSH 繼續執行,隨時可以連回去
筆電睡眠或網路中斷 自動重試,或手動按 Reconnect 繼續執行,恢復連線後接回
重新啟動或更新 App 重新開啟 SSH 視窗並連線;如果要更新忙碌中的遠端伺服器,App 會先詢問 Restart 或 Later 除非為了更新而重啟,否則繼續執行
執行 Stop SSH Server… 關閉並中斷 SSH 停止主機上的代理與伺服器

想回到本機工作又不想斷線,點側邊欄的「SSH: 主機」選 This Computer,或從命令面板執行 Switch to This Computer。


六、常見錯誤碼與解法

連線失敗時,點通知上的 Show Details 可以看到錯誤碼。主機端的伺服器紀錄放在 ~/.antigravity-hub-server/data/ 底下的 ls-*.log。官方列出的常見錯誤整理如下。

錯誤碼 原因 處理方式
AUTH_FAILED SSH 驗證失敗 先在終端機測試 ssh 主機,檢查 IdentityFile 或用 ssh-add -l 確認金鑰
HOSTKEY_REJECTED known_hosts 缺少或與主機金鑰不符 先向管理者核對主機金鑰指紋。確認是預期的金鑰變更後,再用 ssh-keygen -R 主機移除舊紀錄並重新驗證
FORWARDING_PROHIBITED 主機關閉了連接埠轉送 請目標主機與跳板主機的管理者確認 sshd_config 是否允許 AllowTcpForwarding yes 或 local
UNSUPPORTED_HOST 主機不是 64 位元 Linux、glibc 太舊或使用 musl 換成符合需求的 Linux 主機
CONNECTION_FAILED/CONNECTION_CLOSED 找不到 ssh 程式、主機連不到或通道中斷 檢查 ssh -V、ssh 主機,再按 Reconnect
INSTALL_FAILED 遠端伺服器安裝失敗 用 df -h ~ 檢查空間、確認家目錄不是 noexec,並讓 ~/.bashrc 在非互動模式下不輸出文字
SSH_CONFIG_INVALID 設定檔有錯、權限不安全或編碼不對 修正提示的那一行;自訂設定檔在 macOS、Linux 上用 chmod 600

官方文件另外列了 INVALID_DESTINATION(主機格式錯誤)、SHARED_HOME_UNSUPPORTED(另一台共用同一個網路家目錄的主機已在執行遠端伺服器)、LS_START_FAILED 等錯誤碼,遇到時可以到官方〈Connect over SSH〉頁面的 Troubleshooting 段落查詢。


七、安全提醒與移除方式

透過 SSH 連線後,AI 代理執行的指令會直接作用在遠端主機上,而且關掉視窗後代理還會繼續跑。阿正老師建議注意以下幾點。

  • 先用測試機或不含正式資料的主機熟悉操作,不要一開始就連正式環境的伺服器。
  • 確認 Antigravity 的權限與終端機沙盒設定,需要時讓代理在執行指令前先徵求同意。
  • 用完確定不再需要代理運作時,執行 Stop SSH Server… 停止主機上的伺服器與代理,不要只關視窗。
  • 登入憑證會存在遠端主機上,多人共用的主機要特別留意帳號權限。

如果之後不想用了,官方說明的移除方式是先執行 Stop SSH Server…,再刪除主機上的 ~/.antigravity-hub-server 資料夾;要連同儲存的對話和設定一起刪掉,再刪除 ~/.gemini。


⚠️ ~/.gemini 也可能存放同一台主機上 Antigravity CLI 的設定與資料,刪除前先確認裡面沒有還要用的內容。


八、阿正老師的總結

專案放在自己的 Linux 主機或 VPS,想用 App 介面讓 AI 代理工作

→ Connect over SSH。App 更新到 2.33.0 以上,連線前確認遠端主機和 SSH 設定符合需求。

家裡是 Mac 或 Windows 電腦,人在外面想遙控

→ Remote Control。這兩種系統不能當 SSH 遠端主機,改用瀏覽器遙控。

習慣在終端機裡工作

→ 在主機上裝 Antigravity CLI,自己 ssh 登入使用即可。

想多了解 Antigravity 目前的模型與分工方式,可以接著看站上的 Gemini Orchestrator 教學;同時用 Antigravity、Claude Code、Codex 的讀者,也可以參考 T3 Code 介紹。


小結:先確認主機是 64 位元 Linux,再談遠端開發

Antigravity 的 SSH 連線讓程式碼和代理留在主機上,本機只負責操作,關閉 App 的 SSH 視窗或讓本機進入睡眠時,遠端主機上正在執行的代理會繼續工作。連線前請參考第三節,確認遠端系統和連接埠轉送設定。也別忘了,代理在主機上執行的每個指令都是真的,權限設定要先想清楚。

你會把 Antigravity 連到哪一台主機上用呢?歡迎在下面留言跟阿正老師分享!

留下回覆

請輸入你的評論!
請在這裡輸入你的名字