# VPS & agent

> Yêu cầu, cách cài đặt và ghép nối agent X-Buddy trên VPS Windows, cửa sổ agent, cập nhật và gỡ cài đặt.

Source: https://x.builera.app/docs/vi/vps-and-agent
Last checked: 2026-10-24

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 {#requirements}

- **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 {#install-and-pair}

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:

   ```powershell
   [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**.

> [!NOTE]
> "X Auto Agent" và `C:\XAuto` là tên kỹ thuật của agent trên Windows. Các tên này được giữ nguyên để cập nhật tự động tiếp tục hoạt động.

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 {#the-agent-window}

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 {#leave-remote-desktop-safely}

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 {#updates}

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 {#uninstall}

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 {#related}

- [Thêm và đăng nhập nick](/docs/vi/x-accounts)
- [Xử lý sự cố](/docs/vi/troubleshooting) — VPS ngoại tuyến, agent cũ, lỗi proxy.