HandyCafe Docs
it-admin

Bắt đầu: Quản trị viên IT

Hướng dẫn này bao gồm phần thiết lập kỹ thuật của HandyCafe. Sau khi hoàn thành, bạn sẽ có máy chủ và máy khách được cài đặt, mạng được cấu hình, menu ứng dụng được xây dựng và quản lý từ xa được kiểm tra.

Thời gian hoàn thành: 5 phút (cộng thêm thời gian triển khai máy khách)

Bước 1: Cài đặt Máy chủ và Máy khách

Cài đặt máy chủ:

  1. Xác minh PC máy chủ đáp ứng yêu cầu hệ thống.
  2. Tải và cài đặt HandyCafe Server trên PC quản lý.
  3. Khởi chạy máy chủ và hoàn thành Trình hướng dẫn Thiết lập ban đầu để tạo tài khoản quản trị.
  4. Ghi lại địa chỉ IP cục bộ của PC máy chủ. Máy khách sẽ cần thông tin này để kết nối.

Cài đặt máy khách (lặp lại cho mỗi PC):

  1. Tải HandyCafe Client trên mỗi PC phục vụ khách hàng.
  2. Cài đặt và khởi chạy máy khách.
  3. Máy khách tìm kiếm máy chủ trên mạng nội bộ bằng mDNS.
  4. Nếu máy chủ không được tìm thấy tự động, nhập địa chỉ IP máy chủ thủ công trong cài đặt máy khách.
  5. Khi đã kết nối, máy khách xuất hiện trên Bảng Quản trị của máy chủ.

Mẹo: Sử dụng tính năng đặt tên tự động của máy chủ (Cài đặt > Máy khách) để tự động đặt tên máy khách với tiền tố như "PC #1", "PC #2", v.v. Bạn có thể tùy chỉnh tên hiển thị sau.

Xem Cài đặt Máy chủ và Cài đặt Máy khách để biết các bước chi tiết.

Bước 2: Cấu hình Cài đặt Mạng

Đi đến Cài đặt > Mạng trên máy chủ.

HandyCafe sử dụng bốn cổng cho giao tiếp:

Cổng Mặc định Mục đích
Cổng TCP 5001 Giao tiếp lệnh và phản hồi
Cổng File 5002 Truyền file giữa máy chủ và máy khách
Cổng Quản lý Từ xa 5003 Điều khiển phát màn hình từ xa
Cổng UDP 5004 Dữ liệu phát màn hình

Cấu hình:

  1. Đặt các cổng (mặc định phù hợp cho hầu hết thiết lập).
  2. Đặt Khóa Kết nối. Đây là bí mật chia sẻ dùng cho xác thực HMAC-SHA256. Tất cả máy khách phải dùng cùng khóa.
  3. Nhấp Lưu.

Quy tắc tường lửa:

Đảm bảo các cổng này mở trên cả máy chủ và PC khách:

  • TCP: 5001, 5002, 5003 (đến trên máy chủ, đi trên máy khách)
  • UDP: 5004 (hai chiều cho phát màn hình)

Quan trọng: Tất cả PC phải cùng mạng nội bộ (subnet). HandyCafe sử dụng mDNS để phát hiện máy khách, yêu cầu kết nối LAN.

Xem Cài đặt Mạng để biết tất cả tùy chọn mạng.

Bước 3: Thiết lập Menu Máy khách

Menu máy khách là trình khởi chạy ứng dụng mà khách hàng thấy trên desktop. Đi đến Cài đặt > Máy khách > Tab Nội dung.

  1. Tạo danh mục. Nhóm ứng dụng theo loại (ví dụ: Game, Trình duyệt, Mạng xã hội, Công cụ).
  2. Thêm ứng dụng vào mỗi danh mục:
    • Đặt tên và mô tả ứng dụng.
    • Chọn loại ứng dụng: Game, Trình duyệt, Liên kết, File hoặc Ứng dụng.
    • Đặt đường dẫn thực thi hoặc URI khởi chạy.
    • Tải lên biểu tượng và tùy chọn ảnh poster cho thẻ ứng dụng.
  3. Sắp xếp lại danh mục và ứng dụng bằng tay cầm kéo.
  4. Bật/tắt hiển thị để hiện hoặc ẩn mục.
  5. Nhấp Lưu.

Thay đổi được đẩy đến tất cả máy khách đã kết nối tự động theo thời gian thực qua TCP.

Mẹo: Sử dụng tích hợp IGDB để tự động tìm kiếm metadata và biểu tượng game.

Xem Menu Máy khách để biết tài liệu đầy đủ về trình xây dựng menu.

Bước 4: Cấu hình Màn hình Chờ và Giao diện

Màn hình Chờ (Cài đặt > Máy khách > Tab Màn hình chờ):

Màn hình chờ là những gì khách hàng thấy khi không có phiên hoạt động (màn hình khóa).

  1. Bật trình chiếu màn hình chờ.
  2. Thêm hình ảnh hoặc video (PNG, JPG, WebP, GIF, MP4, WebM).
  3. Đặt thời lượng cho mỗi mục và hiệu ứng chuyển cảnh (mờ dần, trượt, phóng to).
  4. Tùy chọn bật lớp phủ đồng hồ và hiển thị tên quán với màu tùy chỉnh.
  5. Nhấp Lưu.

Giao diện (Cài đặt > Máy khách > Tab Giao diện):

Cấu hình giao diện desktop mà khách hàng dùng trong phiên.

  1. Chọn chủ đề: Neon Arena, Crimson Pulse hoặc Emerald Depth.
  2. Chọn mẫu bố cục: Split Classic, Hero Wide Top, Catalog Wide Bottom hoặc Compact Focus.
  3. Cấu hình hình nền: màu đặc, gradient, hình ảnh hoặc video với cài đặt lớp phủ và làm mờ.
  4. Điều chỉnh mật độ thẻ (Lớn, Trung bình, Nhỏ gọn) và hiệu ứng hover.
  5. Nhấp Lưu.

Xem Màn hình Chờ Máy khách và Giao diện Máy khách để biết tất cả tùy chọn.

Bước 5: Kiểm tra Màn hình Từ xa và Chụp Màn hình

Xác minh quản lý từ xa hoạt động:

Chụp màn hình:

  1. Trên Bảng Quản trị, chọn bất kỳ thẻ máy khách đang dùng.
  2. Nhấp Chụp Màn hình trên thẻ.
  3. Ảnh chụp màn hình máy khách xuất hiện trong trình xem.
  4. Bạn có thể tải xuống hoặc làm mới ảnh chụp.

Màn hình từ xa:

  1. Chọn thẻ máy khách đang dùng và nhấp Màn hình Từ xa.
  2. Cửa sổ mở với phát video H.264 trực tiếp.
  3. Bạn có thể điều khiển chuột và bàn phím trên PC từ xa.
  4. Đồng bộ clipboard hoạt động giữa máy chủ và máy khách.

Lưu ý: Màn hình từ xa sử dụng phát UDP. Nếu video bị lag, kiểm tra băng thông mạng và đảm bảo cổng UDP 5004 không bị chặn. Bạn cũng có thể điều chỉnh bitrate trong cài đặt phát (350-25.000 kbps).

Xem Màn hình Từ xa và Chụp Màn hình để biết tất cả tính năng từ xa.

Tổng quan Kiến trúc Mạng

PC Máy chủ (Quản lý)
    |
    |--- TCP (5001) --- Lệnh/Phản hồi (bincode + HMAC-SHA256)
    |--- TCP (5002) --- Truyền File
    |--- TCP (5003) --- Điều khiển Quản lý Từ xa
    |--- UDP (5004) --- Phát Màn hình (H.264)
    |--- mDNS ------- Phát hiện Máy khách (tự động)
    |
    +-- PC Khách 1
    +-- PC Khách 2
    +-- PC Khách 3
    +-- ...

Bước Tiếp theo