手機與瀏覽器連線

連線步驟

• 在桌機開啟 Peer Sessions 並啟用主機。
• 啟用瀏覽器連線，使用同網路手機掃描 QR code，或開啟桌機顯示的網址。
• 按「配對」，核對兩端驗證碼相同，再於兩端核准。
• 選擇本機工作區與終端。已配對的 LAN 瀏覽器可輸入，不需每個終端另行核准。

QR code 在本機產生，只包含網址，不含配對密鑰。桌機須維持執行且網路可達；Wi-Fi 用戶端隔離可能阻擋連線。

工作區與畫面

LAN 瀏覽器可看見所有本機工作區與既有終端。「可供遠端掛載的工作區」只控制其他 Termdock 裝置的掛載，不影響瀏覽器清單。HOME 與檔案系統根目錄工作區只開放終端，不開放檔案。

首次連線時，若桌機有作用中的本機終端，就開啟該終端。之後重新整理或重連，優先返回瀏覽器上次使用且仍存在的終端，否則使用桌機目前位置。手機切換不會改變桌機畫面。

瀏覽器共用桌機的工作區與終端介面。窄畫面一次顯示一個終端，可用上一個／下一個按鈕與選單切換，其他終端仍在桌機執行。旋轉手機或開啟鍵盤不會自動調整桌機 PTY 尺寸。

輸入與檔案限制

可用觸控輸入列編輯文字後送出。Enter／Send 提交，Shift+Enter 保留換行；Esc 與 Ctrl+C 不會送出未完成草稿。若無法確定是否送達，請先確認桌機結果再重試。離線時不排入輸入佇列。

檔案瀏覽與文字檔檢視為唯讀，限工作區根目錄內。瀏覽器不開放編輯、儲存、重新命名、刪除檔案、Git 操作、修改桌機設定、建立／刪除終端，或再轉接 peer／SSH 工作區。

已配對的 LAN 瀏覽器可同時輸入。這與其他 Termdock 裝置建立之終端的單一輸入端接手規則不同。

記住裝置與撤銷

瀏覽器會為這個網址儲存裝置金鑰，重連時不需再次配對。在 Peer Sessions 可撤銷單一瀏覽器或移除全部瀏覽器；撤銷後立即斷線，須重新配對。手機遺失時請立即撤銷。

可在桌機的瀏覽器連線控制項選擇網路位址與固定埠，讓重新啟動後網址保持一致。指定埠被占用時會回報錯誤，不會悄悄換埠。網址的 IP 或埠改變時須重新配對。主機啟用時，可選擇在 app 啟動時自動開啟瀏覽器連線。

網路安全與外出連線

內建 LAN 入口使用 HTTP，只適合信任的網路。配對無法保護首次載入網頁免於主動網路攻擊。基本連線不需設定網域或憑證。

外出連線須自行設定 Tailscale、ZeroTier 或類似網路，再在桌機選擇該網路提供的位址。Termdock 不會替你部署公網 relay。完整 PWA 安裝需要可信 HTTPS；加入主畫面不代表可離線操作終端。