遠端開發與管理

本指南涵蓋四項內容：將您的 VelaTerm 開放給網路上的其他裝置使用、透過 SSH 或配對連結連線到其他機器、透過 VelaTerm 帳號與您自己的裝置共用對話，以及與遠端機器互相傳輸檔案。

1. 入口

遠端功能位於標題列右側：

• 地球圖示是「遠端存取（瀏覽器）」。它可讓同一網路中的手機、平板或其他電腦透過網頁瀏覽器使用這台電腦上的 VelaTerm。伺服器執行期間，此圖示會以強調色醒目顯示，其工具提示也會加上「執行中 · 連接埠 N」。
• 箭頭圖示是「連線到遠端服務」。它可讓這台機器透過 SSH、配對連結或您的 VelaTerm 帳號，成為另一台機器的用戶端。
• 人像圖示是「帳號」入口，標示為「實驗性功能」。它可讓這台電腦登入 VelaTerm 帳號，並透過網際網路與您其他已登入的裝置共用對話。

旁邊的「分享」按鈕會開啟「分享 VelaTerm」，用於向他人推薦 VelaTerm；它不會共用任何會話。

2. 將這台機器開放給其他裝置（遠端存取）

2.1 啟動伺服器

點選地球按鈕。選擇「連接埠」（預設為 8799，並會記住您上次使用的連接埠）、配對連結所用的「IP」位址（「自動（第一個區域網路位址）」或特定網路介面；VPN 介面會標示為「VPN」）以及存取密碼（「設定存取密碼」），然後點選「啟動服務」。

每個連線的裝置都必須輸入存取密碼。伺服器執行期間，面板會提示：「重新開啟應用程式時遠端存取會自動恢復，『停止伺服器』可關閉此功能。」如果之後啟動應用程式時自動啟動失敗，面板會顯示「自動啟動失敗：」及其原因。

「多端介面鏡像」核取方塊預設為勾選。勾選時，分頁、分割與目前的會話會在所有連線的裝置上保持一致，而每台裝置的鍵盤焦點則各自獨立。如果希望每台裝置自行安排分頁，請取消勾選。

2.2 連線裝置

伺服器執行後，面板會顯示狀態、「憑證指紋（SHA-256）」、配對連結與 QR 碼：

如要連線裝置，請用該裝置的相機掃描 QR 碼，或將配對連結傳送到該裝置（例如透過 AirDrop 或傳訊息給自己），然後在瀏覽器中開啟連結並輸入存取密碼。配對連結與密碼缺一不可；在沒有配對連結的情況下直接開啟位址，會顯示「此服務要求使用配對連結存取。」瀏覽器與這台機器之間的傳輸採用端對端加密。

有兩點與安全性有關：

• 配對連結帶有存取憑證，請只分享給您自己的裝置。如果您認為連結已外洩，請點選「重新產生連結（踢掉全部裝置）」：舊連結會立即失效，所有已連線的裝置都會中斷連線，直到開啟新的連結為止。
• 首次造訪時，瀏覽器會警告憑證不受信任；使用自我簽署憑證時，這是正常現象。請將瀏覽器顯示的指紋與面板中的指紋比對。兩者一致，即表示您連線的是自己的機器。

如果機器有多個網路介面（有線、Wi-Fi、VPN），面板會顯示優先使用的位址，並在「其它 N 個連結」下列出其他位址。請選擇與要連線之裝置位於同一網路的位址。

VelaTerm 重新啟動後，配對連結仍然有效。只有「重新產生連結（踢掉全部裝置）」會取代這些連結。

2.3 瀏覽器用戶端的功能

已連線裝置上的登入頁面與主介面：

瀏覽器用戶端與桌面版操作的是相同的即時會話：相同的專案樹、相同的終端機與對話輸出，雙方都可以輸入。開啟「多端介面鏡像」時，主機的標題列會顯示「被 N 端鏡像」；點選後可查看「已連線的用戶端」及其名稱、位址與連線時間。用戶端名稱由用戶端自行回報，因此請將其視為標籤，而非身分證明。

同一個終端機在多台裝置上開啟時，其大小會以其中一台裝置為準。其他裝置會顯示縮放後的副本，並在終端機右上角顯示「⤢ 鏡像… · 點擊適配本視窗」徽章；點選徽章即可依目前視窗調整終端機大小。

瀏覽器用戶端沒有瀏覽器分頁，也沒有原生圖片貼上選項。它們可以在「檔案」分頁中上傳與下載檔案（§5）。

2.4 已配對裝置

在執行中的面板上點選「已配對裝置」，即可查看所有曾經連線的裝置及其「最後連線」時間：

如要封鎖某台裝置，請點選「禁止存取」，再點選「確認禁止」。該裝置會立即中斷連線，且在開啟新的配對連結之前都無法重新連線；其他裝置不受影響。如要一次中斷所有裝置的連線，請使用「重新產生連結（踢掉全部裝置）」。

2.5 停止伺服器

點選面板底部的「停止服務」。瀏覽器用戶端會中斷連線，執行中的會話則會繼續執行，因為它們屬於桌面版。停止伺服器也會關閉自動啟動；下次啟動伺服器時，請重新輸入存取密碼。

3. 連線到其他機器

點選標題列中的連線按鈕。面板有三個分頁：「SSH」、「URL」與「Remote」。

3.1 SSH：遠端機器只需要 SSH

此方式適用於沒有安裝任何 VelaTerm 元件的遠端機器。遠端機器可以執行 Linux（x86_64 或 ARM64）、macOS（Apple silicon 或 Intel）或 Windows（x86_64）；Windows 機器可以使用 Microsoft 的 OpenSSH 伺服器，或 Cygwin、MSYS2 的 SSH 伺服器。連線時會自動完成整個設定流程：VelaTerm 會偵測遠端系統、將對應的 VelaTerm 伺服器複製過去、啟動伺服器並讓它獨立持續執行、將本機連接埠轉送到該伺服器，然後開啟會自動登入的遠端視窗。

輸入 user@host[:port]，然後點選「連線」。以下幾點值得注意：

主機金鑰驗證。 第一次連線到某台主機時，會顯示其「SSH 主機指紋」，並附上提示「首次連線這台主機，請核對指紋一致後再繼續。」請核對後點選「指紋無誤，連線」；金鑰會儲存到 known_hosts，之後不會再詢問。如果已知主機的金鑰變更，會顯示紅色警告：「⚠ 這台主機的金鑰變了：可能是伺服器重裝，也可能是中間人攻擊。確認無誤再繼續。」請先查明原因再確認。

驗證。 系統會直接使用您現有的 SSH 設定（ssh-agent、~/.ssh/config 與金鑰）。只有在金鑰驗證失敗時，才會出現「SSH 密碼」提示。「記住密碼」會將密碼儲存在系統鑰匙圈中，而不會存入資料庫，並在下次連線時使用。

鏡像遠端桌面版。 此選項預設關閉，並依主機分別記憶。如果遠端機器也在執行 VelaTerm 桌面版，而您想看到與它完全相同的畫面，請開啟此選項：相同的分頁、分割與目前的會話，任一方的變更都會同時顯示在兩邊。如果遠端機器上的桌面版未執行，VelaTerm 會直接開啟其資料庫；若沒有資料庫，則使用獨立的資料庫。未開啟此選項時，遠端伺服器會使用自己的資料目錄（~/.velaterm/data，在 Windows 上為 %USERPROFILE%\.velaterm\data），與該機器上安裝的任何桌面版分開。

點選連線按鈕時按住 Option（在 Windows 與 Linux 上為 Alt），會在鏡像關閉時多顯示一個選項：「共用遠端桌面版的資料庫」。它可讓遠端伺服器開啟遠端桌面版的資料庫，而不連接到正在執行的應用程式。建議讓兩者使用相同的 VelaTerm 版本。

最近的主機。 連線過的主機會列在「最近連線」下方（「檢視全部 (N)」會顯示完整清單）。點選項目只會填入表單；請確認內容後，再點選「連線」。鑰匙圖示表示已儲存密碼，×（「忘記此主機」）會移除該主機及其已儲存的密碼。

進度。 第一次連線時會複製伺服器（數十 MB），按鈕會依序顯示「準備伺服器…」、「傳輸伺服器…」與「啟動伺服器…」及百分比。之後的連線會重複使用遠端機器上已有的伺服器，速度會快很多。

3.2 URL：另一台機器已啟用遠端存取

當另一台機器的 VelaTerm 已啟用遠端存取（§2），且您擁有其配對連結時，請使用此方式。與在網頁瀏覽器中開啟連結相比，您會得到專用的視窗，並可使用儲存在系統鑰匙圈中的密碼自動登入，指紋檢查也由應用程式處理。

貼上配對連結，輸入在另一台機器上設定的「登入密碼」，然後點選「連線」。第一次連線時會顯示另一台機器的 TLS 憑證指紋；請將其與該機器面板中顯示的「憑證指紋（SHA-256）」比對。之後若指紋未變更，連線會直接完成；指紋變更時則會顯示紅色警告。最近使用的配對連結會列在表單下方，與 SSH 主機相同。

3.3 Remote：登入同一帳號的您的裝置

「Remote」分頁會列出已登入您 VelaTerm 帳號（§4）的裝置。每台裝置都會顯示「線上」或「離線」及其共用的內容，例如「整個工作區」、某個專案或對話，或「此裝置尚未共用內容。」。裝置在線上且正在共用時，「查看共用內容 →」會在新視窗中開啟其共用的內容。如果您尚未登入，此分頁會顯示「登入 VelaTerm」連結。

4. 透過 VelaTerm 帳號共用（實驗性功能）

帳號共用可讓您透過網際網路，在其他裝置上繼續某台電腦上執行中的 AI 對話，而無須開放連接埠，也不必位於同一網路。共用的內容會經由 velaterm.com 以端對端加密傳輸。此功能目前為實驗性功能。

4.1 登入

點選標題列中的帳號按鈕。「帳號」對話方塊會顯示「登入 VelaTerm」；點選後即可在網頁瀏覽器中繼續。VelaTerm 等待期間會顯示「請在瀏覽器中完成登入，然後返回 VelaTerm。」您可以展開「登入要求詳細資料」，將請求內容與網站上顯示的內容比對。

登入後，對話方塊會顯示您的名稱與「帳號 ID：」、可開啟您在 velaterm.com 上帳號頁面的「帳號」按鈕，以及「登出」。登出會中斷這台電腦的連線，並停止其共用的所有內容。

4.2 共用內容

在「開始共用」下方選擇「共用範圍」：「整個工作區」、「專案」或「對話」。如果選擇「專案」或「對話」，請從清單中選取，然後點選「開始共用」。每個共用項目都會顯示在「共用中」下方，並附有狀態（「共用中」或「共用內容尚未就緒」）與「停止共用」按鈕。您可以同時共用多個項目。重新啟動後，共用設定仍會保留；只有在這台電腦執行 VelaTerm 且處於連線狀態時，共用內容才可存取。

只會共用 AI 對話。一般終端機與瀏覽器頁面一律不會共用，檢視共用內容的裝置也無法開啟終端機、檔案、設定或新分頁。

4.3 從其他裝置開啟共用內容

在登入同一帳號的另一台裝置上，開啟連線按鈕的「Remote」分頁（§3.3），然後點選「查看共用內容 →」。您可以閱讀共用的對話，也可以傳送訊息、中斷智慧體並回應其權限請求，但僅限於共用端電腦以會話檢視顯示的會話；對於其他會話，視窗會說明主機必須先將該會話切換到會話檢視。

請注意，AI 智慧體是以共用端電腦上使用者的權限執行操作：它可以在該電腦上執行指令與變更檔案。任何能夠繼續共用對話的人都可以指揮該智慧體，因此請只與您能掌控的裝置共用，並在不再需要存取時使用「停止共用」。

5. 傳輸檔案

在瀏覽器用戶端以及 URL 與 SSH 遠端視窗中，右側面板的「檔案」分頁可以在您的裝置與執行會話的機器之間傳輸檔案。本機桌面版不需要此功能，因此不會顯示這些操作。

• 上傳： 在資料夾或其中的檔案上按右鍵，然後選擇「上傳檔案…」；點選「檔案」標頭中的上傳按鈕（「把檔案上傳到這個目錄」）；或將檔案拖曳到檔案樹上。資料夾無法上傳。
• 下載： 在檔案上按右鍵，然後選擇「下載」。在網頁瀏覽器中，檔案會透過瀏覽器本身的下載管理員下載。在 URL 或 SSH 遠端視窗中，會出現儲存對話方塊，詢問檔案的儲存位置（預設為「下載」資料夾）。

上傳作業，以及遠端視窗中的下載作業，會顯示在「傳輸」清單中，並附有大小、速度與剩餘時間。點選取消按鈕可停止單一項目，「清空」可移除已完成的項目。如果上傳期間連線中斷，該項目會顯示「正在重新連線…」，VelaTerm 會持續重試約一分鐘。中斷的上傳不會在目的地留下不完整的檔案，再次上傳同一個檔案時，會從中斷處繼續。

6. 在手機上使用 VelaTerm

在手機的瀏覽器中開啟配對連結（§2.2），例如掃描遠端存取面板中的 QR 碼。在手機上，VelaTerm 會切換為專為小型觸控螢幕設計的版面。版面會在頁面載入時決定：螢幕短邊小於 768 像素的觸控裝置會使用此版面。在網址後加上 ?view=mobile 或 ?view=desktop 可自行選擇版面（平板可以使用 ?view=mobile），也可以在「更多操作」（•••）選單中選擇「切換到桌面版」；您的選擇會被記住。

行動版版面分為兩層：

• 會話清單： 專案樹，附有搜尋框（「搜尋會話 / 群組…」）與狀態篩選（「工作中」、「等待處理」、「已查看」）。會話需在桌面版或電腦瀏覽器中建立，建立後會自動顯示在這裡。
• 會話頁面： 點選會話即可開啟，使用「‹ 返回」可回到清單。以會話檢視執行的會話會顯示完整對話。以終端機檢視執行的 Claude Code、Codex、OpenCode、Pi 與 OMP 會話，會顯示其對話，以及可將文字輸入終端機的訊息輸入框。其他會話會顯示終端機與按鍵列：Esc、Tab、Ctrl（會開啟一列 Ctrl 組合鍵，例如 ^C、^D、^R 與 ^W）、方向鍵、^C、鍵盤按鈕，以及用於傳送圖片的相機按鈕。滑動可捲動，點選可顯示鍵盤，長按可選取單字並「複製」。

行動版版面不顯示瀏覽器分頁、文件分頁或分割窗格，沒有鍵盤快捷鍵，並會維持自己的檢視，而不跟隨「多端介面鏡像」。Kiro 會話會以唯讀檢視提供其歷史記錄。

VelaTerm iOS 版已於 App Store 上架，Android 版已於 Google Play 上架。

7. 中斷連線、關閉視窗與保留的內容

7.1 三層狀態

「中斷連線後是否一切都還在」取決於所在的層級：

只有第三層需要留意：只要遠端伺服器處理程序仍在執行，您執行中的會話就會持續執行。

7.2 關閉遠端視窗

SSH： 遠端伺服器是由這次連線啟動的，因此關閉視窗時會開啟「Disconnect remote」對話方塊，提供三個選項。「Stop server」會關閉遠端機器上的伺服器，並結束其執行中的會話。「Keep running」只會中斷此視窗的連線；下次連線到該機器時，會重複使用該伺服器，所有會話都完整保留。「Cancel」會讓視窗保持開啟。如果希望智慧體在您離開時繼續工作，請選擇「Keep running」。

連接到遠端桌面版的 SSH： 當「鏡像遠端桌面版」將視窗連接到執行中的桌面版時，關閉視窗只會中斷連線；桌面版會繼續執行。

URL： 您是以訪客身分連線到一個原本就在執行的 VelaTerm。關閉視窗只代表您離開；另一端會繼續執行，您回來時一切都還在。

7.3 連線中斷

網路中斷時，遠端視窗頂端會出現紅色橫條，顯示「連線已中斷，正在嘗試重新連線…」，VelaTerm 會自動重試。執行中的會話不受影響；在 SSH 模式下，遠端伺服器的執行與 SSH 連線無關。

在 SSH 視窗中，VelaTerm 也會自行重建 SSH 通道（「SSH 連線已中斷，正在重建通道…」）。如果重建失敗並停止嘗試，橫條會顯示「SSH 連線已中斷，點擊『立即重新連線』再試一次」；請點選「立即重新連線」。如果遠端伺服器本身已經停止，從視窗重新連線也無法解決：請回到主視窗重新連線。連線時會檢查遠端伺服器是否仍在執行，如果仍在執行，就會重複使用（連同所有會話），只有在伺服器未執行時才會啟動新的伺服器。

遠端機器進入睡眠、登出或重新開機時，SSH 模式的伺服器及其執行中的會話都會結束。專案樹儲存在磁碟上，不受影響。

7.4 快速參考

8. 安全性概覽

• 密碼（SSH 密碼與遠端登入密碼）只會在您選擇「記住密碼」時儲存，且只存放在系統鑰匙圈中，絕不會存入資料庫。遠端存取密碼只以雜湊值儲存，讓伺服器可以自動重新啟動。
• 區域網路的瀏覽器存取使用搭配自我簽署憑證的 TLS。配對連結帶有端對端加密憑證，伺服器會拒絕沒有配對連結的連線。
• SSH 主機金鑰與遠端 TLS 憑證採用首次使用時信任的方式：已知且未變更的目標會直接連線，新目標需要確認一次，指紋變更時則會顯示紅色警告。請先查明原因再確認。
• 您可以隨時封鎖個別裝置（§2.4），也可以隨時重新產生配對連結。
• 帳號共用僅限於 AI 對話，但這些對話中的智慧體會以您在共用端電腦上的權限執行操作（§4.3）。

如果標題列顯示「⚠ vX ≠ vY」徽章，表示介面與其連線的 VelaTerm 服務回報的版本不同，部分功能可能無法搭配運作。請更新 VelaTerm，讓兩者執行相同的版本。

9. 常見問題

視窗已連線，但側邊欄一直是空的，或紅色橫條一直沒有消失。 遠端伺服器可能已經停止。請回到主視窗重新連線（§7.3）。

伺服器無法在連接埠 8799 上啟動。 其他程式正在使用該連接埠。請在面板中選擇其他連接埠，然後重新啟動。

瀏覽器顯示憑證不受信任。 使用自我簽署憑證時，這是正常現象。請核對指紋後繼續（§2.2）。

希望遠端機器上的智慧體在我離開時繼續工作。 在 SSH 模式下，關閉視窗時請選擇「Keep running」。會話會在遠端機器上繼續執行，您之後可以重新連線，從中斷處接續。

手機上的終端機顯示得非常小。 這是依照另一台裝置大小縮放的副本。請點選終端機右上角徽章中的「適配本視窗」，將其調整為適合手機的大小。

我的電腦沒有出現「查看共用內容」。 只有當該電腦處於線上、登入同一帳號且正在共用內容時，才會顯示此按鈕。請在該電腦上開啟 VelaTerm，並在其「帳號」對話方塊中查看「共用中」。