配對裝置
本指南說明如何將手機與 Control Center 配對,讓你隨時隨地閱讀訊息與工單並回覆。同一 個流程也可用來配對第二個瀏覽器或桌面應用程式。連線的運作方式及其保安模型,請參閱 遙控與流動裝置。
先決條件
標題為「先決條件」的章節- 一部已連接到你伺服器的桌面或網頁用戶端,以及一個已設定好的工作區。配對操作需要完整用戶端,因此已配對的手機永遠無法配對——或撤銷——另一部裝置。
- 從你正在配對的裝置可以觸達伺服器。在同一網絡上,這自然可行;距離較遠時,則由中介轉發的中繼承載流量。如果面板顯示無法連線而不是二維碼或憑證,請先公開一條路徑——設定 → 伺服器 → 連接與狀態下的通道選項(分享此伺服器),或伺服器的
--public-url(參見執行無介面伺服器)。 - 手機方面:無需安裝任何東西。二維碼會開啟 Remote 網頁應用程式(預設為 remote.usectrl.dev)。
自託管。 Remote 與中繼中介都是本儲存庫的開源項目:手機應用程式
(apps/cc_remote,一個 Flutter 網頁 PWA,你可以經其 wrangler.jsonc 部署到
Cloudflare Pages、部署到 docker/cc_remote nginx 映像,或部署到任何支援 HTTPS 的
靜態主機——服務工作程式與 IndexedDB 都受安全上下文限制),以及中繼
(apps/cc_signaling_server,單一無狀態的 Dart 二進位檔,不保存任何應用程式資料,
也從不會看到配對密鑰——它只轉發端到端密封的訊框)。建置與執行步驟請參閱它們的
README。
步驟 1:開啟配對面板
標題為「步驟 1:開啟配對面板」的章節開啟 設定 → 你 → 你的裝置。你的裝置區段會列出在此伺服器上與你的帳戶配對的 用戶端。(伺服器擁有者會看到伺服器上的每一部裝置;其他人只會看到自己的裝置。)
步驟 2:配對新用戶端
標題為「步驟 2:配對新用戶端」的章節在頁首按一下 配對新用戶端,給它一個標籤(例如「我的手機」),選擇類型—— 網頁瀏覽器、桌面應用程式或手機——然後按一下 配對。
- 若是手機,會出現二維碼。用手機的相機掃描它,或複製連結並在任何瀏覽器中開啟。它會讓 Remote 應用程式指向你的伺服器,並帶有憑證。
- 若是瀏覽器或桌面應用程式,請改為把顯示的連結(或裝置 id 與配對密鑰)複製到新的用戶端。一鍵連結只在你從網頁用戶端配對時提供,因為桌面二進位檔沒有可據以建立連結的 Web 來源。
手機二維碼與 cc_server pair --client-url 在 CLI 上印出的連結是不同的負載,且不可
互換:CLI 連結會填入網頁用戶端的連接表單,而此二維碼則為 Remote PWA 帶上伺服器
完整的連線描述符與身分指紋。
在手機一方,開啟配對連結並不會靜默地完成配對。Remote 會顯示伺服器所宣告的名稱,並 在儲存任何內容之前請你確認,因此偽造的連結無法把應用程式騎劫到別人的伺服器上。
管理已配對的裝置
標題為「管理已配對的裝置」的章節在 設定 → 你 → 你的裝置中,你可以:
- 重新命名裝置
- 撤銷你不再信任的裝置。撤銷會銷毀其憑證,並在數秒內中斷其現行工作階段,因此在重新連線時會失敗即關閉
對於遺失或已更換的手機,撤銷是正確做法。從裝置的角度來看,它是即時且不可逆的。
由此面板簽發的憑證有時限:簽發後 30 天到期,此後連線關卡會判定它們失敗即關閉。在
命令列以 cc_server pair 簽發的憑證則完全不會到期——當它所屬的機器退役時,請
手動撤銷它。
從手機切換工作區
標題為「從手機切換工作區」的章節已配對的手機可以獨立於桌面切換工作區。手機每次呼叫都會帶上工作區,而伺服器每次都 會檢查你在該工作區的成員身分與角色——因此手機只能觸達你是成員的工作區,而在手機上 切換永遠不會改變桌面顯示的內容。
手機工作階段還額外受限於一小份以讀取為主的工具允許清單:它可以列出及讀取工單、 代理、空間、訊息與資訊動態文章,也可以更新或指派工單、在空間中傳送訊息,以及把 文章標為已讀或已儲存。這份清單以外的任何操作,都會在觸達伺服器的調度器之前被拒絕。