Ghép nối thiết bị

Hướng dẫn này chỉ cho bạn cách ghép nối một chiếc điện thoại với Control Center, để bạn có thể đọc tin nhắn và phiếu rồi trả lời từ bất cứ đâu. Cùng quy trình đó cũng ghép nối một trình duyệt hoặc ứng dụng máy tính thứ hai. Xem Điều khiển từ xa và di động để biết liên kết hoạt động ra sao và mô hình bảo mật của nó.

Điều kiện tiên quyết

Một máy khách máy tính để bàn hoặc máy khách web đã kết nối tới máy chủ của bạn và một không gian làm việc đã được thiết lập. Các thao tác ghép nối yêu cầu máy khách đầy đủ, nên một điện thoại đã ghép nối không bao giờ có thể ghép nối — hay thu hồi — một thiết bị khác.
Máy chủ phải truy cập được từ thiết bị bạn đang ghép nối. Trong cùng một mạng thì mọi thứ tự nhiên hoạt động; ở xa hơn thì relay được môi giới sẽ chở lưu lượng. Nếu bảng ghép nối trả lời Không thể truy cập thay vì một mã QR hay thông tin xác thực, hãy công bố một đường dẫn trước — tùy chọn bật tunnel tại Cài đặt → Máy chủ → Kết nối & trạng thái (Chia sẻ máy chủ này), hoặc --public-url của máy chủ (xem Chạy máy chủ không giao diện).
Với điện thoại: không cần cài đặt gì. Mã QR mở ứng dụng web Remote (mặc định là remote.usectrl.dev).

Tự lưu trữ. Remote và bộ môi giới relay đều là mã nguồn mở trong kho mã này: ứng dụng điện thoại (apps/cc_remote, một PWA web Flutter mà bạn có thể triển khai lên Cloudflare Pages qua wrangler.jsonc của nó, lên image nginx docker/cc_remote, hoặc lên bất kỳ host tĩnh nào có HTTPS — service worker và IndexedDB bị ràng buộc bởi ngữ cảnh bảo mật) và relay (apps/cc_signaling_server, một binary Dart phi trạng thái duy nhất, không giữ dữ liệu ứng dụng nào và không bao giờ thấy bí mật ghép nối — nó chỉ chuyển tiếp các khung niêm phong đầu-cuối). Xem README của chúng để biết các bước build và chạy.

Bước 1: Mở bảng ghép nối

Mở Cài đặt → Bạn → Thiết bị của bạn. Mục Thiết bị của bạn liệt kê các máy khách đã ghép nối với tài khoản của bạn trên máy chủ này. (Chủ sở hữu máy chủ thấy mọi thiết bị trên máy chủ; những người khác chỉ thấy thiết bị của chính họ.)

Bước 2: Ghép nối máy khách mới

Nhấp vào Ghép nối máy khách mới ở đầu trang, đặt cho nó một nhãn (ví dụ: “Điện thoại của tôi”), chọn loại — Trình duyệt web, Ứng dụng máy tính hoặc Điện thoại — rồi nhấp vào Ghép nối.

Với điện thoại, một mã QR hiện ra. Hãy quét nó bằng camera của điện thoại, hoặc sao chép liên kết và mở trong bất kỳ trình duyệt nào. Nó trỏ ứng dụng Remote tới máy chủ của bạn và mang theo thông tin xác thực.
Với trình duyệt hoặc máy tính, hãy sao chép liên kết được hiển thị (hoặc id thiết bị và khóa ghép nối) vào máy khách mới. Liên kết một chạm chỉ được cung cấp khi bạn ghép nối từ máy khách web, vì một binary máy tính để bàn không có web origin để dựng liên kết đó.

Mã QR của điện thoại và liên kết mà cc_server pair --client-url in ra trên CLI là những payload khác nhau và không thể thay thế cho nhau: liên kết CLI điền vào biểu mẫu kết nối của máy khách web, còn mã QR này mang bản mô tả kết nối đầy đủ và dấu vân tay danh tính của máy chủ cho PWA Remote.

Về phía điện thoại, việc mở một liên kết ghép nối không ghép nối một cách âm thầm. Remote hiển thị tên quảng bá của máy chủ và yêu cầu bạn xác nhận trước khi lưu bất cứ thứ gì, nên một liên kết giả mạo không thể chiếm quyền ứng dụng để trỏ sang máy chủ của người khác.

Quản lý thiết bị đã ghép nối

Từ Cài đặt → Bạn → Thiết bị của bạn, bạn có thể:

Đổi tên một thiết bị
Thu hồi một thiết bị bạn không còn tin tưởng. Việc thu hồi hủy thông tin xác thực của nó và ngắt phiên đang hoạt động trong vòng vài giây, nên nó hỏng theo hướng đóng khi kết nối lại

Thu hồi là lựa chọn đúng cho một chiếc điện thoại bị mất hoặc đã thay thế. Xét từ phía thiết bị, nó diễn ra tức thì và không thể đảo ngược.

Thông tin xác thực được cấp từ bảng ghép nối này có giới hạn thời gian: chúng hết hạn 30 ngày sau khi được phát hành và cổng kết nối đánh trượt chúng theo hướng đóng sau đó. Một thông tin xác thực được cấp bằng cc_server pair trên dòng lệnh không có ngày hết hạn nào cả — hãy thu hồi nó bằng tay khi chiếc máy mà nó phục vụ đã ngừng sử dụng.

Chuyển không gian làm việc từ điện thoại

Một chiếc điện thoại đã ghép nối có thể chuyển đổi giữa các không gian làm việc độc lập với máy tính để bàn. Điện thoại gửi không gian làm việc kèm theo mỗi lời gọi và máy chủ kiểm tra tư cách thành viên cùng vai trò của bạn trong không gian làm việc đó ở từng lời gọi — nên điện thoại chỉ với tới những không gian làm việc mà bạn là thành viên và việc chuyển đổi ở đó không bao giờ làm thay đổi những gì máy tính để bàn hiển thị.

Phiên trên điện thoại còn bị giới hạn vào một danh sách cho phép nhỏ gồm các công cụ nặng về đọc: nó có thể liệt kê và đọc phiếu, agent, space, tin nhắn và bài viết bảng tin, và nó có thể cập nhật hoặc giao một phiếu, gửi một tin nhắn trong một space và đánh dấu một bài viết đã đọc hoặc đã lưu. Bất cứ thứ gì nằm ngoài tập hợp đó đều bị từ chối trước khi tới bộ điều phối của máy chủ.

Hướng dẫn liên quan

Chạy máy chủ không giao diện: làm cho máy chủ có thể truy cập được ngay từ đầu
Kết nối máy chủ từ xa: trỏ một máy khách đầy đủ tới đó
Dùng space: điều bạn sẽ chủ yếu làm từ điện thoại
Tạo và quản lý phiếu: phân loại công việc khi đang trên đường