---
title: Node VPN và proxy IPv6
description: Chuẩn bị máy chủ Linux làm node VPN (cmp-agent) và node proxy IPv6: hệ điều hành, địa chỉ IP và prefix IPv6, cổng, sysctl, cài đặt và heartbeat.
url: https://nexcmp.com/vi/docs/infrastructure/vpn-proxy-nodes/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# Node VPN và proxy IPv6 {#vpn-and-ipv6-proxy-nodes}

> **Vị trí trong admin:** Infrastructure › VPN & Proxy nodes › Agents & external nodes (`/agents`), VPN IP pools (`/vpn/pool`), IPv6 Proxy nodes (`/vpn/proxy6/nodes`). Bản thân các dịch vụ nằm tại Services › VPN và Services › IPv6 Proxy. Cả hai module đều được bật trong System › Admin › License & updates.

## Chức năng {#what-it-does}

NexCMP bán quyền truy cập VPN và proxy đi ra từ **địa chỉ IP bạn sở hữu**, trên các máy chủ do bạn vận hành. Hiện có hai loại node:

- **Node VPN.** Một chương trình Go nhỏ, `cmp-agent`, chạy trên máy chủ Linux của bạn. Nó tự phát hiện các địa chỉ IPv4 public trên máy chủ, mở listener SOCKS5, HTTP và UDP trên từng địa chỉ được bán, rồi định tuyến lưu lượng đi ra từ **chính IP đó** mà khách hàng đã kết nối tới (same-IP egress). Nó báo cáo về panel định kỳ sau mỗi vài giây.
- **IPv6 proxy node.** Dịch vụ proxy cung cấp cho khách hàng các địa chỉ từ prefix IPv6 bạn định tuyến đến máy chủ. Panel sẽ cài đặt dịch vụ này cho bạn qua SSH.

Sử dụng chúng để bán lại các địa chỉ IP sạch tại những quốc gia nơi bạn có máy chủ.

## Yêu cầu {#requirements}

### VPN node {#vpn-node}

| Hạng mục | Yêu cầu |
|---|---|
| Hệ điều hành | Bản phân phối Linux có systemd và kernel 4.15 trở lên (hỗ trợ IPv6 free-bind). Binary agent đi kèm chỉ dành cho **x86_64** (amd64). |
| Quyền hạn | root, để cài đặt. Dịch vụ chỉ giữ lại `CAP_NET_ADMIN`, `CAP_NET_RAW` và `CAP_DAC_READ_SEARCH`. |
| Công cụ | `curl` hoặc `wget`, và `sha256sum` (trình cài đặt từ chối tiếp tục nếu không kiểm tra tệp). |
| Địa chỉ public | Các địa chỉ IPv4 public được gán trên một interface của máy chủ (mỗi địa chỉ một `/32`), **hoặc** một prefix được định tuyến đến máy chủ mà bạn thêm vào dưới dạng subnet phụ (IPv4 /16 đến /32, IPv6 /48 đến /128). Các dải private, CGNAT và tài liệu hướng dẫn sẽ bị bỏ qua. |
| Mạng, inbound | Khách hàng kết nối tới từng IP public đã bán trên **cổng 65001-65535** (TCP cho SOCKS5 và HTTP, UDP cho UDP associate). Mỗi endpoint sử dụng một bộ ba cổng liên tiếp. |
| Mạng, outbound | HTTPS (443) đến domain của panel của bạn. Agent cũng tra cứu quốc gia của chính nó trên `ip-api.com` (HTTP) và `ipinfo.io` (HTTPS), với giới hạn 3.5 giây. |
| Mail | Các kết nối outbound tới port 25 luôn bị chặn; không có cài đặt nào để mở port này. |
| Docker, VPN và các interface ảo | Các interface có tên `docker*`, `veth*`, `br-*`, `cni*`, `flannel*`, `virbr*`, `cali*`, `tun*`, `tap*`, `wg*` và `tailscale*` không đóng góp địa chỉ. |
| Phụ thuộc vào | Module **VPN**, một zone (được tạo tự động từ quốc gia của máy chủ) và panel NexCMP có thể truy cập được qua HTTPS. |

### IPv6 proxy node {#ipv6-proxy-node}

| Hạng mục | Yêu cầu |
|---|---|
| Hệ điều hành | Linux có systemd trên **x86_64**. Các lệnh `systemctl`, `nft`, `ip`, `ss`, `sysctl` và `useradd` phải tồn tại; nếu không, quá trình cài đặt sẽ dừng lại và nêu tên lệnh còn thiếu. |
| Quyền truy cập để cài đặt | Một địa chỉ IPv4 public (từ chối các địa chỉ private, loopback và CGNAT), cổng SSH, tài khoản có quyền root hoặc quyền `sudo` và **mật khẩu** của tài khoản đó. Mật khẩu chỉ được dùng để cài đặt và không được lưu trữ. |
| Các cổng còn trống | **80, 443 và mọi cổng trên 60000** phải còn trống. Trình cài đặt không bao giờ dừng hoặc thay đổi các dịch vụ đang chạy; nó sẽ báo cáo các cổng đang bận và dừng lại. |
| IPv6 | Một prefix public trong khoảng **/32 và /64** bên trong `2000::/3` mà máy chủ có thể sử dụng làm nguồn cho lưu lượng outbound, được bàn giao theo kiểu **định tuyến** đến máy chủ hoặc **on-link** với NDP proxy (xem bên dưới). |
| Mạng | Khách hàng kết nối tới IPv4 của node qua port 80 (HTTP proxy), port 443 (SOCKS5) và các port 60001-65535 (mỗi IP tĩnh một port). Node không có chứng chỉ nên không có HTTPS proxy. Lưu lượng ra chỉ đi qua IPv6 và chỉ tới các đích có địa chỉ IPv6. Node lấy cấu hình từ panel qua HTTPS. |
| Phần mềm node trên máy chủ panel | Node daemon và script mạng của nó được tích hợp sẵn trong gói phát hành NexCMP. Panel sao chép chúng từ thư mục cài đặt của mình (`/opt/nexcmp/releases/<version>/bin`, hoặc `/opt/nexcmp/bin` trên bản build tùy biến) sang từng node trong quá trình cài đặt. Máy chủ panel cũng cần `sshpass` và một SSH client; trình cài đặt sẽ bổ sung `sshpass`, còn trên máy chủ được cài đặt trước phiên bản 1.4.2, bạn thêm nó bằng `sudo apt-get install -y sshpass`. |
| Phụ thuộc vào | Module **IPv6 Proxy**, và URL panel mà các node gọi ngược về (**IPv6 Proxy › Settings › Panel URL for nodes**, mặc định là `https://<your license domain>`). |


## Chuẩn bị hạ tầng {#prepare-the-infrastructure}

### VPN node {#vpn-node-1}

1. **Khởi tạo máy chủ** với một bản phân phối Linux được hỗ trợ và các địa chỉ IPv4 public bạn muốn bán, được cấu hình trên network interface hoặc được định tuyến đến máy chủ.
2. **Nếu bạn bán một routed block**, hãy dự kiến nhập nó dưới dạng **Extra subnet** khi thêm node. Agent sẽ cài đặt một route `local <block> dev lo` để host chấp nhận lưu lượng cho mọi địa chỉ trong block, sau đó báo cáo các địa chỉ tìm thấy. Agent cũng đọc bảng định tuyến thực tế của host và không bao giờ bán hoặc chiếm giữ địa chỉ **gateway**: nếu block chứa next-hop của một trong các route trên host (chẳng hạn như địa chỉ router của một block on-link), agent sẽ chỉ cài đặt các route `local` cho các phần của block xung quanh địa chỉ đó, báo cáo gateway về panel, và panel sẽ loại trừ địa chỉ đó khỏi pool cũng như mọi lượt cấp phát. Nó sẽ xóa các route đã cài đặt khi extra subnet thay đổi hoặc khi agent dừng.
3. **Mở firewall.** Cho phép TCP và UDP inbound **65001-65535** trên các địa chỉ public, và HTTPS outbound đến panel.
4. **Tùy chọn: bộ đếm byte theo từng IP.** Conntrack accounting (`net.netfilter.nf_conntrack_acct = 1`) cho phép vai trò giám sát đếm số byte theo từng IP. Panel có thể bật tính năng này bằng cách gửi lệnh `acct` tới agent, thao tác này cũng sẽ ghi `/etc/sysctl.d/99-cmp-agent.conf`. Bản thân vai trò VPN không cần đến tính năng này.
5. **Kiểm tra panel từ node:**

   ```bash
   curl -fsS -o /dev/null -w '%{http_code}\n' https://cloud.example.com/install.sh
   ```

### IPv6 proxy node {#ipv6-proxy-node-1}

Tiền tố IPv6 đến được node theo một trong hai cách. Trình cài đặt sẽ kiểm tra cả hai bằng các kết nối outbound thực tế và giữ lại cách thức hoạt động.

| Loại | Ý nghĩa | Cấu hình cần thực hiện |
|---|---|---|
| **Routed** | Upstream của bạn định tuyến một tiền tố (ví dụ: /48 hoặc /56) **tới địa chỉ riêng của node**. Các gói tin outbound có thể sử dụng bất kỳ địa chỉ nào trong tiền tố làm nguồn và phản hồi sẽ quay trở lại node. | Yêu cầu nhà cung cấp của bạn cung cấp một tiền tố định tuyến có next hop là node. Không cần làm gì thêm trên node: dịch vụ proxy sử dụng transparent socket, một bảng policy-routing cố định và `nft`. |
| **On-link** | Dải /64 nằm trên cùng mạng LAN với node. Phản hồi chỉ hoạt động nếu node phản hồi neighbour discovery cho từng địa chỉ đang được sử dụng (**NDP proxy**). | Dịch vụ sẽ thiết lập `net.ipv6.conf.<if>.accept_ra=2`, `forwarding=1` và `proxy_ndp=1` chỉ riêng trên giao diện đó, ghi nhớ các giá trị cũ, khôi phục lại khi dừng và chặn chuyển tiếp các địa chỉ của pool để node không trở thành router cho pool. |

Cách thức kiểm tra hoạt động: node sẽ thử kết nối TCP đến một địa chỉ IPv6 public (cổng 443) từ một địa chỉ ngẫu nhiên thuộc tiền tố tiềm năng, trong vòng 6 giây. Các ứng viên là các địa chỉ global trên các giao diện có tiền tố từ /64 trở xuống, cùng các tuyến đường loại `local`, `unreachable` hoặc `blackhole` từ /16 đến /64. Tiền tố ngắn hơn /64 sẽ được chấp nhận là **routed** nếu một dải /64 ngẫu nhiên bên trong nó hoạt động.

::: warning Không sử dụng cùng một tiền tố hai lần
Một tiền tố không được trùng lặp với tiền tố của node khác, và không được rộng hơn tiền tố đã thuộc về IPv6 pool riêng của panel. Một dải /64 **nằm trong** pool của panel được cho phép. Các trường hợp trùng lặp sẽ được báo cáo là "assign range … (node …)" trong kết quả cài đặt và tiền tố đó sẽ bị bỏ qua.
:::

Các hạn chế mà node tự áp dụng: khách hàng không thể gửi thư (cổng 25, 465, 587, 2525) từ các địa chỉ trong pool, và lưu lượng IPv4 của chính daemon bị giới hạn ở các phản hồi cùng lưu lượng tới panel và DNS.

## Kết nối trong NexCMP {#connect-in-nexcmp}

### VPN node {#vpn-node-2}

1. Tại **System › Admin › License & updates**, hãy bật **VPN**. Xem [Modules](https://nexcmp.com/vi/docs/infrastructure/modules/).

      ![Thẻ Module với các công tắc VPN và IPv6 Proxy](https://nexcmp.com/vi/docs/images/infrastructure/vpn-proxy-nodes-01-modules.webp)

2. Mở **Infrastructure › VPN & Proxy nodes › Agents & external nodes**. Bạn có hai cách để thêm node.

   **a. Cài đặt qua SSH.** Nhấp vào **+ Add server (SSH)** và điền:

   | Trường | Giá trị ví dụ |
   |---|---|
   | Địa chỉ IPv4 của máy chủ | `192.0.2.50` |
   | Cổng SSH | `22` |
   | Người dùng SSH | `root` |
   | Mật khẩu SSH | `XXXX` |
   | Tên hiển thị | `node-ny-1` (để trống: đặt tên theo IP) |
   | Vai trò máy chủ | External VPN / Proxy Node |
   | Chỉ định Zone | Tự động theo GeoIP (tạo / chỉ định Zone), hoặc một zone hiện có |
   | Subnet bổ sung (tùy chọn) | để trống để tự động quét giao diện, hoặc một khối định tuyến như `203.0.113.0/24` |
   | Bật để bán sau khi cài đặt | bật để đánh dấu mọi địa chỉ được phát hiện là có thể bán |

   Nhấp vào **Connect & install**. Panel sẽ kết nối qua SSH, chạy trình cài đặt một dòng lệnh trên node với một ticket dùng một lần, và hiển thị tên node, vị trí GeoIP cùng các dải mạng được phát hiện.

      ![Hộp thoại Add Node via SSH với ví dụ về địa chỉ máy chủ và vai trò](https://nexcmp.com/vi/docs/images/infrastructure/vpn-proxy-nodes-02-add-server-ssh.webp)

   **b. Cài đặt thủ công.** Nhấp vào **Generate manual install token**. Lệnh sẽ chỉ hiển thị **một lần**; hãy sao chép và chạy lệnh đó trên node:

   ```bash
   curl -fsSL https://cloud.example.com/install.sh | sudo sh -s -- --token XXXX --name node-ny-1
   ```

   Việc cài đặt bằng token chỉ đăng ký máy để giám sát: để đảm bảo an toàn, panel không cho phép máy nắm giữ token dùng chung tự cấp vai trò VPN cho chính nó (việc thêm `--roles vpn` vào lệnh không có tác dụng). Sau khi máy xuất hiện trong danh sách, hãy mở máy đó và tự thêm vai trò **VPN**. Cài đặt qua SSH (tùy chọn a) sẽ gán vai trò VPN cho node ngay từ đầu. Token mới sẽ hủy bỏ token cũ; các host đã đăng ký trước đó vẫn tiếp tục hoạt động vì chúng sử dụng key riêng.

      ![Hộp thoại lệnh cài đặt hiển thị lệnh chứa token dùng một lần](https://nexcmp.com/vi/docs/images/infrastructure/vpn-proxy-nodes-03-install-command.webp)

   Quy trình bộ cài đặt thực hiện: tải xuống `cmp-agent-linux-amd64` từ panel của bạn, **xác minh SHA-256**, cài đặt vào `/usr/local/bin/cmp-agent`, đăng ký với token, ghi `/etc/cmp-agent/agent.json` và khởi chạy systemd service `cmp-agent`. Để gỡ bỏ: `curl -fsSL https://cloud.example.com/install.sh | sudo sh -s -- --uninstall`.

3. Sau lần heartbeat đầu tiên, node sẽ xuất hiện trong danh sách. Quốc gia của node được phát hiện qua GeoIP (node tự tra cứu trước, sau đó đối chiếu với cơ sở dữ liệu của panel); một **zone** cho quốc gia đó sẽ được tạo và đặt ở chế độ công khai nếu chưa tồn tại, và các địa chỉ tìm thấy trên host sẽ trở thành các dải pool.
4. Mở **Infrastructure › VPN & Proxy nodes › VPN IP pools** để xem các dải IP, zone và node tương ứng, đồng thời thay đổi zone, node hoặc nút gạt **Sellable** của từng dải. **Enable range** cho phép các đơn hàng mới sử dụng IP còn trống; **Disable range** chỉ dừng cấp phát mới, các IP đang thuê vẫn tiếp tục hoạt động.

      ![VPN IP pools với các dải IP được báo cáo bởi node](https://nexcmp.com/vi/docs/images/infrastructure/vpn-proxy-nodes-04-vpn-pool.webp)

5. Mở **Services › VPN**, thiết lập bảng giá và bật tính năng bán. Công tắc **Sell VPN** trên **Subscriptions** chính là công tắc của module VPN trong License & updates.
6. **Tùy chọn: đổi tên dịch vụ.** Trong **Settings › Branding**, **VPN service display name** dùng để thay đổi cách hiển thị tên dịch vụ VPN trong menu khách hàng, trang đặt hàng, trang chi tiết và danh sách triển khai (ví dụ `IPv4 Proxy`, `Datacenter Proxy` hoặc `Static Residential Proxy`; tối đa 40 ký tự, để trống sẽ giữ `VPN`). Cài đặt này chỉ thay đổi nhãn hiển thị: các route, dữ liệu và API không thay đổi.

### IPv6 proxy node {#ipv6-proxy-node-2}

1. Trên **System › Admin › License & updates**, bật **IPv6 Proxy**.
2. Mở **Infrastructure › VPN & Proxy nodes › IPv6 Proxy nodes** và nhấp vào **Add node (SSH)**. Nhập địa chỉ IPv4 của node, cổng SSH, user, password, tên tùy chọn và **Reason** (thông tin này được ghi vào nhật ký kiểm toán), sau đó nhấp vào **Install**.

      ![Hộp thoại thêm IPv6 node với địa chỉ và lý do mẫu](https://nexcmp.com/vi/docs/images/infrastructure/vpn-proxy-nodes-05-proxy6-add-node.webp)

3. Sau đó, panel sẽ lần lượt: kiểm tra máy chủ và các cổng, sao chép daemon, network script, service unit và tệp môi trường riêng của node (node token và khóa ký mật khẩu), chạy **probe** để tìm các prefix khả dụng, ghi nhận prefix vào pool, khởi động service và chờ tối đa 90 giây cho báo cáo đầu tiên. **Install log** sẽ hiển thị từng bước.
4. Node mới sẽ tạo zone tương ứng ở trạng thái **tắt** (dựa trên GeoIP từ IPv4 của node). Hãy bật zone trong **Infrastructure › Datacenter › Zone** để khách hàng có thể chọn.
5. Thiết lập **Mbps cap** tổng cho mỗi node (từ 10 đến 100000 cho mỗi chiều). Trong **Services › IPv6 Proxy**, hãy thiết lập bảng giá và bật tính năng bán hàng.
6. Kiểm tra **IPv6 Proxy › Settings › Panel URL for nodes**. Các node sẽ gọi địa chỉ này (`https://host`, không có đường dẫn) để lấy cấu hình và gửi báo cáo. Để trống có nghĩa là `https://<your license domain>`. Đây phải là host có địa chỉ trỏ thẳng tới panel, để IPv4 riêng của node kết nối tới mà không bị thay đổi.

::: tip Lịch xoay vòng
Khách hàng có thể đặt khoảng thời gian xoay vòng tự động từ 30 đến 600 giây. Trong NexCMP, panel sẽ chạy lịch trình đó (cùng với việc dọn dẹp log kết nối hàng giờ); các node sẽ nhận địa chỉ mới trong khoảng 5 giây.
:::

### Cách thức báo cáo của node {#how-a-node-reports}

| | VPN node (`cmp-agent`) | IPv6 proxy node |
|---|---|---|
| Đăng ký (Enrollment) | Ticket hoặc token dùng một lần qua HTTPS, sau đó dùng khóa riêng | Cài đặt một lần qua SSH, sau đó dùng node token |
| Heartbeat | Mỗi **5 giây** (10 giây đối với agent chỉ giám sát); panel có thể thiết lập từ 3 đến 300 giây. Sau khi gặp lỗi, thời gian chờ tăng dần theo từng bước 5 giây lên đến tối đa 60 giây | Node gửi báo cáo định kỳ khoảng mỗi 60 giây và kéo cấu hình về |
| Hiển thị là online | Có heartbeat trong vòng **60 giây** gần nhất | **alive** trong vòng **120 giây** gần nhất, nếu không sẽ là **missed heartbeat** |
| Thay đổi cấu hình | Được áp dụng ở lần heartbeat tiếp theo | Được áp dụng trong khoảng 5 giây |
| Cập nhật | Panel có thể gửi lệnh `upgrade` kèm phiên bản mới, URL và SHA-256 | Cài đặt lại từ hàng của node |

### Hạn mức dung lượng trên VPN node {#data-allowance-on-a-vpn-node}

Từ phiên bản NexCMP **1.5.1**, agent của VPN node sẽ gửi lưu lượng đã chuyển tải theo từng heartbeat, và panel sẽ cộng dồn vào mức sử dụng của gói dịch vụ trong chu kỳ hiện tại. Con số này được hiển thị giống nhau cho khách hàng (các tab Overview và Bandwidth) cũng như cho bạn (VPN › Subscriptions, cột Used, và dòng của node).

- **Ngắt kết nối.** Khi một gói dịch vụ đã dùng hết số GB trong chu kỳ, panel sẽ ngừng gửi các endpoint của gói đó tới agent, do đó các kết nối mới sẽ bị từ chối và các kết nối đang mở sẽ bị đóng. Việc ngắt diễn ra trong vòng một heartbeat, nên gói dịch vụ có thể vượt hạn mức một chút. Các gói có gói cước Unlimited sẽ không bao giờ bị ngắt.
- **Mở lại dịch vụ.** Gói dịch vụ sẽ được phục vụ trở lại trong vòng một heartbeat sau khi khách hàng mua thêm băng thông hoặc khi chu kỳ tiếp theo bắt đầu.
- **Not measured.** Node có agent chưa gửi dữ liệu sử dụng (ví dụ: agent phiên bản cũ) sẽ hiển thị là **Not measured**, và các gói của node đó không bao giờ bị ngắt vì lý do dung lượng GB.
- **Cập nhật agent.** Sử dụng agent **1.5.1** trên các node. Các agent cũ hơn vẫn được tính lưu lượng, nhưng có thể làm mất số byte từ heartbeat bị lỗi, endpoint bị dừng hoặc khi khởi động lại, và chúng không đóng các kết nối đang mở khi gói dịch vụ bị ngắt. Cập nhật từ hàng của node (Reinstall) hoặc bằng lệnh `upgrade`.
- Lưu lượng được tính theo payload truyền qua proxy, do đó sẽ thấp hơn một chút (khoảng 1 %) so với số byte thực tế trên đường truyền.

### Các add-on VPN đã ngừng hỗ trợ {#retired-vpn-add-ons}

High IP Reputation, High Concurrency và High Priority Network không còn được cung cấp cho các đơn hàng mới. Các gói đăng ký hiện có vẫn giữ lại các add-on đã chọn, nhưng số tiền gia hạn sẽ được trừ đi khoản phí của các gói đã ngừng hỗ trợ. Không hoàn tiền cho các kỳ đã thanh toán. Việc điều chỉnh sử dụng giá niêm yết hiện tại của add-on; nếu bạn đã thay đổi mức giá đó hoặc xóa add-on, hãy kiểm tra lại số tiền gia hạn của gói đăng ký trước kỳ gia hạn tiếp theo.

## Kiểm tra {#verify}

1. Hàng của node hiển thị trạng thái online. Với VPN node, **Agents & external nodes** hiển thị zone, quốc gia, vai trò và các dải IP được phát hiện.
2. **VPN IP pools** liệt kê các dải IP còn trống; trang chi tiết của zone hiển thị hạ tầng VPN.
3. Đặt mua một gói VPN hoặc proxy thử nghiệm. Khách hàng sẽ nhận được endpoint `ip:port`, tên người dùng và mật khẩu; hãy kết nối qua đó và kiểm tra xem IP public hiển thị có phải là IP của node hay không (ví dụ `curl --proxy socks5h://USER:XXXX@IP:PORT https://ifconfig.me`).
4. Trên một node IPv6, chạy trên host:

   ```bash
   systemctl is-active <node service>
   nft list tables | grep proxy6
   ss -ltn | grep -E ':(80|443|6[0-9]{4})\b'
   ```

## Giới hạn và lưu ý {#limits-and-notes}

- Các host Windows có thể chạy agent giám sát nhưng không thể chạy vai trò VPN.
- Hạn mức dung lượng (GB mỗi chu kỳ) của gói VPN: từ NexCMP 1.5.1, panel sẽ cộng dồn lưu lượng do VPN node agent báo cáo và ngắt proxy của gói khi dùng hết số GB trong chu kỳ (xem "Data allowance on a VPN node" bên dưới). Các gói IPv6 Proxy không có hạn mức GB; chúng giới hạn tốc độ theo Mbps cho từng gói.
- Địa chỉ IPv4 của gói VPN không tự động xoay. Khách hàng báo cáo IP bị đưa vào blacklist; bạn hoặc reseller duyệt cấp IP thay thế từ cùng zone. Chỉ IPv6 Proxy mới xoay.
- Tối đa 64 dải IP được báo cáo trong mỗi heartbeat.
- Một bộ endpoint VPN sử dụng ba cổng cho mỗi IP bán ra. Với các cổng 65001-65535, mỗi IP phục vụ một số lượng endpoint giới hạn (178 bộ cổng); panel sẽ bỏ qua các bộ cổng đã được sử dụng trước đó.
- Chỉ được phép xóa node IPv6 proxy khi không còn gói dịch vụ nào giữ IP trên đó. Thao tác này sẽ xóa các dải IP và token của node; phần mềm trên host sẽ không bị gỡ cài đặt.
- Bạn hoàn toàn có thể bán lại dải IP đang chạy các VM của chính mình: VPN chỉ sử dụng các cổng 65001-65535, vì vậy nó có thể chia sẻ IP với các dịch vụ khác.

## Xử lý sự cố {#troubleshooting}

| Hiện tượng | Nguyên nhân | Cách khắc phục |
|---|---|---|
| "đăng ký thất bại (token không hợp lệ hoặc không thể kết nối máy chủ)" | Token sai hoặc đã qua sử dụng, hoặc không thể kết nối tới panel | Tạo token mới hoặc thử lại quá trình cài đặt qua SSH. |
| "chữ ký tệp không khớp - STOP" | Agent đã tải xuống khác với mã SHA-256 được công bố | Kiểm tra thư mục `/dl/` của panel và đảm bảo không có gì ghi đè bản tải xuống trong quá trình truyền. |
| "trình cài đặt này chỉ dành cho Linux" / "kiến trúc … hiện chưa được hỗ trợ" | Windows hoặc kiến trúc khác ngoài x86_64 (bản phát hành chỉ đi kèm agent cho x86_64) | Sử dụng host Linux x86_64. |
| Node không bao giờ xuất hiện | Node không thể kết nối tới panel qua HTTPS | Kiểm tra `curl https://<domain>/install.sh` từ node; kiểm tra DNS và tường lửa. |
| Node hiển thị sai quốc gia | Tra cứu quốc gia thất bại nên cơ sở dữ liệu địa chỉ của panel đã được sử dụng | Cho phép truy cập outbound tới `ip-api.com` và `ipinfo.io`, hoặc chọn zone rõ ràng trong biểu mẫu SSH. |
| Không phát hiện thấy dải IP nào | Không có IPv4 public trên interface non-virtual | Thêm một địa chỉ public, hoặc nhập dải định tuyến dưới dạng **Extra subnet**. |
| VPN hoạt động, lưu lượng ra từ một IP khác | IP bán ra chưa được gán hoặc định tuyến tới host | Đảm bảo IP nằm trên một interface hoặc được bao hàm bởi `local … dev lo`. |
| "máy chủ panel không có sshpass" | Máy chủ panel không thể đăng nhập vào các node bằng mật khẩu | Chạy `sudo apt-get install -y sshpass openssh-client` trên máy chủ panel, sau đó cài đặt lại node. |
| "not found in the installed package" khi cài đặt node IPv6 | Panel dùng phiên bản cũ hơn 1.4.2, hoặc bản build tùy chỉnh không có các file của node | Cập nhật NexCMP lên 1.4.2 hoặc mới hơn; với bản build tùy chỉnh, hãy dùng `build.sh`, lệnh này hiện đã đóng gói cả `brandy-proxy6d` và `brandy-proxy6-net`. |
| "SSH: …" khi bắt đầu cài đặt IPv6, hoặc "SSH to internal/loopback addresses is not allowed" | Sai cổng, người dùng hoặc mật khẩu, SSH bị chặn, hoặc địa chỉ là private | Sử dụng IPv4 public của node và kiểm tra truy cập thủ công bằng `ssh -p PORT USER@IP`. |
| "kiến trúc … không được hỗ trợ (chỉ x86_64)" | Node không phải là x86_64 | Sử dụng host x86_64. |
| "node thiếu lệnh: …" | `nft`, `ip`, `ss`, `sysctl`, `systemctl` hoặc `useradd` chưa được cài đặt | Cài đặt các gói trên, sau đó chạy lại quá trình cài đặt. |
| "cổng đang được dịch vụ khác sử dụng trên node: … — 80, 443, 60001-65535 phải còn trống" | Cổng 80, 443 hoặc cổng trên 60000 đang bận | Di chuyển dịch vụ khác sang cổng khác; trình cài đặt sẽ không tự dừng dịch vụ đó. |
| "không tìm thấy tiền tố IPv6 có kết nối Internet từ node (kiểm tra egress thực tế thất bại)" | Không có prefix được định tuyến, không thể NDP proxy, hoặc không có IPv6 outbound | Kiểm tra xem prefix đã được định tuyến tới node chưa, interface có kết nối IPv6 không và không có gì chặn lưu lượng outbound. |
| "tất cả các dải được phát hiện đã thuộc về một node khác" | Prefix đã được sử dụng bởi một node khác | Xóa prefix khỏi node kia hoặc chọn một prefix khác. |
| Quá trình cài đặt kết thúc với "no initial report received from node" | Service đã khởi động nhưng không kết nối được tới panel trong vòng 90 giây | Kiểm tra URL của panel được cấp cho các node và đường truyền HTTPS từ node tới đó; xem **Install log**. |
| Hàng của node hiển thị **missed heartbeat** | Không có báo cáo trong 120 giây | Kiểm tra service trên node, đồng hồ hệ thống và đường truyền tới panel. |
| Khách hàng không thấy vị trí IPv6 nào | Zone đang tắt | Bật zone trong mục **Zone**. |