VPS & agent

Agent là chương trình X-Buddy trên VPS Windows của bạn. Agent chạy Chrome cho các nick, thực hiện các việc và báo kết quả về chỉ qua HTTPS gửi ra ngoài — không cần mở cổng, nên VPS có thể nằm sau NAT.

#Yêu cầu

• Windows với PowerShell 5.1 trở lên, chạy với quyền quản trị viên, trong phiên desktop đã đăng nhập bình thường (agent hiển thị các cửa sổ Chrome thật nên không thể chạy dưới dạng dịch vụ nền Windows).
• Ít nhất 4 GB RAM. Dự trù khoảng 1,5 GB RAM trống cho mỗi cửa sổ Chrome. Mặc định agent mở 3 cửa sổ cùng lúc, tối đa là 8.
• Ổ đĩa: khuyến nghị còn trống 10 GB; trình cài đặt sẽ dừng nếu còn dưới 2 GB.
• Trình cài đặt cần Node.js 20 trở lên: nếu VPS chưa có Node.js hoặc đang dùng bản cũ hơn, trình cài đặt sẽ cài Node.js 20 LTS; Google Chrome được cài nếu còn thiếu.

Trang VPS & Agent hiển thị số cửa sổ Chrome đang mở so với hạn mức của từng máy, mức dùng RAM và ổ đĩa, cùng các kiểm tra: Bộ nhớ ảo, Màn hình, Quét virus bỏ qua hồ sơ Chrome và Chính sách Chrome. Cảnh báo ở đây là lời khuyên, không khẳng định VPS đã sẵn sàng hay bị lỗi. Khi thiếu bộ nhớ hoặc CPU quá tải, agent sẽ chờ trước khi mở thêm Chrome.

#Cài đặt và ghép nối

1. Trong X-Buddy, mở VPS & Agent → Thêm VPS.

2. Nhập Tên gợi nhớ của VPS rồi chọn Tạo mã ghép nối. Mã có hiệu lực 10 phút; hộp thoại hiển thị thời gian đếm ngược.

3. Sao chép lệnh cài đặt. Lệnh có dạng:

   [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; irm '<X-Buddy address>/api/public/agent/install?code=<PAIRING_CODE>&lang=en' | iex
   

4. Trên VPS, mở PowerShell với quyền quản trị viên, dán lệnh và nhấn Enter.

5. Khi hộp thoại hiện Đã ghép nối, VPS đã báo về máy chủ. Đã ghép nối nghĩa là máy đã kết nối — không có nghĩa là đã thêm hay đăng nhập nick.

Trình cài đặt thực hiện:

• cài vào C:\XAuto (chương trình nằm trong C:\XAuto\app);
• tạo tác vụ theo lịch X Auto Agent để khởi chạy agent khi Windows đăng nhập, cùng với X Auto Maintenance;
• cung cấp tuỳ chọn tự đăng nhập Windows để agent chạy lại sau khi khởi động lại máy mà bạn không cần mở Remote Desktop;
• tạo hai lối tắt trên desktop: X Auto Agent và Thoát Remote an toàn.

Tuỳ chọn cài đặt -Lang vi hoặc -Lang en chỉ đặt ngôn ngữ của chính trình cài đặt và tên lối tắt. Bạn cũng có thể ghép nối thủ công: trong cửa sổ agent, chọn Nhập mã ghép nối, nhập 6 ký tự rồi chọn Ghép nối.

#Cửa sổ agent

Trên VPS, cửa sổ agent hiển thị kết nối đến X-Buddy, máy và workspace, lần báo về gần nhất, các kiểm tra máy, số cửa sổ Chrome đang mở, dung lượng ổ đĩa trống, từng nick cùng phiên đăng nhập và trạng thái an toàn, các việc hiện tại, log trực tiếp và tiến trình cập nhật.

• Ngôn ngữ — Theo workspace, Tiếng Việt hoặc English. "Theo workspace" dùng ngôn ngữ thông báo của workspace được đặt trong X-Buddy; lựa chọn ở đây được giữ riêng trên VPS này.
• ❚❚ Tạm dừng nhận việc / ▶ Tiếp tục nhận việc — ngừng cho agent nhận việc mới. Thao tác này không buộc dừng việc đang chạy.
• Mở thư mục log — mở các tệp log của agent.

#Thoát Remote Desktop an toàn

Khi bạn đóng phiên Windows Remote Desktop, Windows có thể làm đóng băng màn hình mà các cửa sổ Chrome đang hiển thị trên đó. Luôn thoát bằng Thoát Remote an toàn (trong cửa sổ agent hoặc trên desktop): thao tác này chuyển phiên trở lại console của VPS để các nick tiếp tục chạy.

Hướng dẫn này nói về Windows Remote Desktop. Nó khác với Xem từ xa của X-Buddy, tính năng hiển thị Chrome của một nick ngay trong ứng dụng web.

Màn hình quá nhỏ cũng làm công việc dừng lại: nếu màn hình VPS nhỏ hơn 1024×720 (thường do cửa sổ Remote Desktop nhỏ), các việc sẽ chờ với thông báo Màn hình VPS quá nhỏ cho X. Phóng to hoặc đóng Remote Desktop để tiếp tục.

#Cập nhật

Agent tự cập nhật. Mỗi bản cập nhật đều được ký; agent kiểm tra chữ ký và mã kiểm tra của tệp trước khi cài, và chỉ cài khi không có việc đang chạy và không có Xem từ xa đang mở. Agent không bao giờ ngắt công việc để cập nhật.

Nếu VPS chạy phiên bản cũ hơn yêu cầu của X-Buddy, máy vẫn báo về và tự cập nhật nhưng không nhận việc. Các việc của máy hiện VPS chưa cập nhật cho đến khi phiên bản đáp ứng yêu cầu.

#Gỡ cài đặt

Chạy uninstall.ps1 từ C:\XAuto\app\scripts trong PowerShell với quyền quản trị viên.

• Không có tuỳ chọn: gỡ agent và các tác vụ theo lịch nhưng giữ lại hồ sơ Chrome và cài đặt trong C:\XAuto, để khi cài lại bạn có thể tiếp tục từ chỗ cũ.
• Với -Purge: xoá mọi thứ trong C:\XAuto, gồm cả hồ sơ Chrome đã đăng nhập của các nick. Các nick đó sẽ cần đăng nhập lại.

#Liên quan

• Thêm và đăng nhập nick
• Xử lý sự cố — VPS ngoại tuyến, agent cũ, lỗi proxy.