配對裝置

本指南說明如何將手機與 Control Center 配對，讓你隨時隨地讀取訊息與工單並回覆。同一套流程也能配對第二個瀏覽器或桌面應用程式。這條連線的運作方式及其安全模型，請參閱遠端控制與行動裝置。

先決條件

一個已連線至你伺服器的桌面版或網頁用戶端，以及一個已設定好的工作區。配對操作需要完整用戶端，因此已配對的手機永遠無法配對——或撤銷——另一台裝置。
要配對的裝置能觸達伺服器。在同一個網路上這可直接運作；距離較遠時，則由仲介式中繼承載流量。如果面板顯示 無法連線，而不是 QR 或憑證，請先發布一條路徑——設定 → 伺服器 → 連線與狀態中的通道選用開關（分享此伺服器），或伺服器的 --public-url（參閱執行無介面伺服器）。
手機方面：無需安裝任何東西。QR 會開啟 Remote 網頁應用程式（預設為 remote.usectrl.dev）。

自行託管。 Remote 與中繼仲介都是本儲存庫中的開放原始碼：手機應用程式（apps/cc_remote，一個 Flutter 網頁 PWA，你可以透過它的 wrangler.jsonc 部署到 Cloudflare Pages、部署到 docker/cc_remote nginx 映像，或部署到任何搭配 HTTPS 的靜態主機——Service Worker 與 IndexedDB 受安全情境限制）以及中繼（apps/cc_signaling_server，單一無狀態的 Dart 執行檔，不保存任何應用程式資料，也從未接觸配對密鑰——它只轉送端到端密封的訊框）。建置與執行步驟請參閱各自的 README。

步驟 1：開啟配對面板

開啟 設定 → 你 → 你的裝置。你的裝置區段會列出在這台伺服器上與你的帳號配對的用戶端。（伺服器擁有者會看到伺服器上的每一台裝置；其他人只會看到自己的。）

步驟 2：配對新用戶端

按一下頁面標頭的 配對新用戶端，給它一個標籤（例如「我的手機」），選擇類型 ——網頁瀏覽器、桌面應用程式或手機——然後按一下配對。

若是手機，會出現一組 QR 碼。用手機的相機掃描它，或複製連結並用任何瀏覽器開啟。它會把 Remote 應用程式指向你的伺服器，並帶著認證資訊。
若是瀏覽器或桌面版，請改為把顯示的連結（或裝置 ID 與配對金鑰）複製到新的用戶端。一鍵連結只在你從網頁用戶端配對時提供，因為桌面版執行檔沒有可用來建構它的網頁來源。

手機 QR 與 cc_server pair --client-url 在 CLI 上列印的連結是不同的負載，且不可互換：CLI 連結會填好網頁用戶端的連線表單，而這裡的 QR 則為 Remote PWA 帶著伺服器完整的連線描述元與身分指紋。

在手機端，開啟配對連結並不會默默完成配對。Remote 會顯示伺服器對外公告的名稱，並在儲存任何東西之前請你確認，因此偽造的連結無法把應用程式劫持到別人的伺服器上。

管理已配對的裝置

在 設定 → 你 → 你的裝置中，你可以：

重新命名裝置
撤銷你不再信任的裝置。撤銷會銷毀它的認證資訊，並在幾秒內中斷其使用中的工作階段，因此它重新連線時會失效即關閉

對於遺失或汰換的手機，撤銷是正確的做法。從裝置的角度來看，這是立即且不可逆的。

從這個面板簽發的認證資訊有時限：簽發後 30 天過期，此後連線關卡會判定它們失效即關閉。在命令列上以 cc_server pair 簽發的認證資訊則完全不會過期—— 當它對應的機器退役時，請手動撤銷。

從手機切換工作區

已配對的手機可以獨立於桌面版切換工作區。手機在每次呼叫時都會送出工作區，而伺服器每次都會檢查你在該工作區中的成員資格與角色——因此手機只會觸達你是成員的工作區，在那裡切換也永遠不會改變桌面版顯示的內容。

手機工作階段另外還被限制在一小份偏向讀取的允許清單上：它可以列出並讀取工單、代理、空間、訊息與新聞動態文章，也可以更新或指派工單、在空間中傳送訊息，以及把文章標示為已讀或已儲存。超出這組範圍的任何操作，都會在觸達伺服器的派送器之前遭到拒絕。