# NexCMP Docs

> Documentation for NexCMP 1.6.1: a self-hosted cloud management and billing platform for CloudStack and Proxmox VE (customer portal, billing, resellers, AI chat/agent, API). Every page below is also available as raw Markdown by adding .md to the URL; the whole documentation is in llms-full.txt.

- [Overview](https://nexcmp.com/vi/docs/): what is in these docs

## Bắt đầu

- [NexCMP là gì](https://nexcmp.com/vi/docs/getting-started/what-is-nexcmp.md): NexCMP là cổng khách hàng, hệ thống billing và quản trị tự host để bán máy ảo và dịch vụ cloud chạy trên CloudStack hoặc Proxmox VE của bạn.
- [Yêu cầu đối với máy chủ NexCMP](https://nexcmp.com/vi/docs/getting-started/requirements.md): Yêu cầu về phần cứng, hệ điều hành, mạng và DNS cho máy chủ chạy chính NexCMP.
- [License và mua hàng](https://nexcmp.com/vi/docs/getting-started/license-and-purchase.md): Cách thức hoạt động của license NexCMP — nhận license key, gán tên miền, tên miền reseller, quyền cập nhật và điều gì xảy ra khi license hết hạn.
- [Cài đặt NexCMP](https://nexcmp.com/vi/docs/getting-started/installation.md): Cài đặt NexCMP trên Ubuntu bằng trình cài đặt một dòng lệnh — tham số, cơ chế hoạt động, TLS và nginx, cùng cách truy cập setup wizard.
- [DNS và Cloudflare](https://nexcmp.com/vi/docs/getting-started/dns-and-cloudflare.md): Trỏ tên miền về máy chủ NexCMP, tùy chọn qua Cloudflare, và nhận chứng chỉ hợp lệ với chế độ SSL phù hợp.
- [Trình hướng dẫn thiết lập](https://nexcmp.com/vi/docs/getting-started/setup-wizard.md): Hướng dẫn thiết lập lần đầu tại /setup — setup code, license, CloudStack hoặc Connect later, quản trị viên và thương hiệu.
- [Đăng nhập lần đầu và các bước tiếp theo](https://nexcmp.com/vi/docs/getting-started/first-login.md): Đăng nhập vào admin console lần đầu và hoàn thành danh sách kiểm tra cấu hình được khuyến nghị.
- [Cập nhật NexCMP](https://nexcmp.com/vi/docs/getting-started/updating.md): Cập nhật NexCMP từ admin console hoặc dòng lệnh, cách xác thực bản phát hành và các quyền lợi cập nhật bạn được nhận.
- [Release notes](https://nexcmp.com/vi/docs/getting-started/release-notes.md): Thay đổi từ NexCMP 1.3 đến 1.6.1 và điều cần kiểm tra khi nâng cấp: quản trị AI, đo lưu lượng VPN, dịch vụ khách hàng và Bare Metal.
- [Sao lưu và khôi phục](https://nexcmp.com/vi/docs/getting-started/backup-and-restore.md): Tạo bản sao lưu nhất quán dữ liệu và cấu hình NexCMP bằng nexcmp backup, rồi khôi phục trên cùng máy chủ hoặc máy chủ mới.
- [Gỡ cài đặt NexCMP](https://nexcmp.com/vi/docs/getting-started/uninstall.md): Gỡ bỏ dịch vụ và chương trình NexCMP, có hoặc không xóa dữ liệu, và những gì còn lại trên hạ tầng của bạn.
- [Tham chiếu lệnh nexcmp](https://nexcmp.com/vi/docs/getting-started/cli-reference.md): Toàn bộ lệnh con của công cụ dòng lệnh máy chủ nexcmp — status, update, backup, uninstall, open-port, close-port và fix-owner.

## Hạ tầng

- [Yêu cầu hạ tầng](https://nexcmp.com/vi/docs/infrastructure/requirements.md): Bảng tổng hợp: yêu cầu hạ tầng tối thiểu cho từng module NexCMP và trang hướng dẫn cách chuẩn bị cũng như kết nối.
- [Kiến trúc](https://nexcmp.com/vi/docs/infrastructure/architecture.md): Cấu trúc tổng thể của NexCMP: tên miền, nginx, panel, worker và các hệ thống kết nối, kèm các cổng và luồng dữ liệu tương ứng.
- [Module](https://nexcmp.com/vi/docs/infrastructure/modules.md): Tất cả module NexCMP: trạng thái mặc định, tính năng bổ sung, hạ tầng cần có và nơi bật; gồm cả các module mở rộng đọc khi khởi động.
- [Zone](https://nexcmp.com/vi/docs/infrastructure/zones.md): Cách zone trong NexCMP hoạt động: vị trí khách hàng chọn khi đặt hàng, cách kết nối với CloudStack, Proxmox VE, VPN, S3 và thời điểm sẵn sàng mở bán.
- [CloudStack](https://nexcmp.com/vi/docs/infrastructure/cloudstack.md): Kết nối Apache CloudStack với NexCMP: tạo domain, account và API key riêng bằng cmk, sau đó nhập vào setup wizard hoặc admin console.
- [Proxmox VE](https://nexcmp.com/vi/docs/infrastructure/proxmox.md): Thêm cụm Proxmox VE làm nguồn VM: API token tối thiểu quyền, storage, cloud-image template, IP pool, TLS pinning và nguồn theo gói.
- [Template hệ điều hành và ISO](https://nexcmp.com/vi/docs/infrastructure/templates.md): Chuẩn bị image hệ điều hành để khách hàng triển khai: build và đăng ký template CloudStack, tạo template cloud-image cho Proxmox VE.
- [Máy chủ dedicated (bare metal)](https://nexcmp.com/vi/docs/infrastructure/dedicated.md): Bán máy chủ Dell quản lý qua iDRAC và Redfish: điều kiện mạng, ISO server, import máy chủ, switch an toàn, template và gói dịch vụ.
- [Node VPN và proxy IPv6](https://nexcmp.com/vi/docs/infrastructure/vpn-proxy-nodes.md): 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.
- [AI Models](https://nexcmp.com/vi/docs/infrastructure/ai-models.md): Bán truy cập AI model qua gateway riêng: thêm provider OpenAI/Anthropic, đồng bộ model, đặt giá và cho khách gọi một endpoint bằng API key và ví của họ.
- [Object Storage (S3, Ceph RGW)](https://nexcmp.com/vi/docs/infrastructure/s3.md): Bán dung lượng S3 pay-as-you-go trên cụm Ceph: yêu cầu RGW, admin user và caps, cùng cách gắn backend vào zone trong NexCMP.
- [Kubernetes và Private Cloud](https://nexcmp.com/vi/docs/infrastructure/kubernetes-and-private-cloud.md): Bán cụm Kubernetes (CKS) và Private Cloud băng thông riêng (VPC) trên CloudStack: các offering cần có và vị trí cấu hình kết nối.

## Danh mục & bảng giá

- [Gói cước và định giá](https://nexcmp.com/vi/docs/catalog/plans.md): Tạo và định giá gói VM: cấu hình, giá theo giờ và tháng, chu kỳ thanh toán, gói tùy chỉnh, nhân bản, cùng tác động khi đổi giá lên VM đang chạy.
- [Quota băng thông và add-on](https://nexcmp.com/vi/docs/catalog/bandwidth.md): Cách NexCMP đo lưu lượng mỗi dịch vụ từ thống kê CloudStack, quota mặc định, cảnh báo 80% và 100%, xử lý vượt hạn mức và add-on.
- [Tiền tệ và tỷ giá hối đoái](https://nexcmp.com/vi/docs/catalog/currency-and-exchange-rates.md): Cách NexCMP quản lý tiền bằng USD, hiển thị các loại tiền tệ theo ngôn ngữ và cách quản trị viên phát hành tỷ giá USD/VND cùng tỷ giá hiển thị.

## Billing & thanh toán

- [Kênh thanh toán](https://nexcmp.com/vi/docs/billing/payment-channels.md): Cách khách hàng nạp tiền vào ví trong NexCMP — các kênh khả dụng, cách bật từng kênh, phí, hạn mức và cách theo dõi chúng.
- [Stripe](https://nexcmp.com/vi/docs/billing/stripe.md): Kết nối Stripe với NexCMP để thanh toán qua thẻ, Apple Pay, Google Pay, Link và Alipay — API key, webhook, đăng ký domain và thanh toán thử nghiệm.
- [PayPal](https://nexcmp.com/vi/docs/billing/paypal.md): Kết nối PayPal với NexCMP để nạp tiền ví — thông tin REST app, webhook, thử nghiệm sandbox và các tài khoản PayPal đã lưu.
- [USDT (Binance)](https://nexcmp.com/vi/docs/billing/usdt.md): Chấp nhận nạp ví USDT bằng cách theo dõi địa chỉ nạp Binance — API key chỉ đọc, chọn mạng, xác minh địa chỉ và tiền nạp chưa khớp.
- [Chuyển khoản ngân hàng (Việt Nam)](https://nexcmp.com/vi/docs/billing/bank-transfer-vn.md): Nhận chuyển khoản ngân hàng Việt Nam (VND) qua SePay — tài khoản nhận, tiền tố memo, webhook, hạn mức và cách gán chuyển khoản không khớp.
- [Mức nạp tiền tối thiểu](https://nexcmp.com/vi/docs/billing/minimum-top-up.md): Thiết lập mức nạp ví tối thiểu và tối đa cho mỗi giao dịch, đồng thời tìm hiểu các ngưỡng số dư quyết định việc khách hàng có thể đặt hàng hay không.
- [Phương thức thanh toán đã lưu](https://nexcmp.com/vi/docs/billing/saved-payment-methods.md): Cách khách hàng lưu thẻ, ví Stripe hoặc PayPal để tự động nạp tiền, cách xóa và dữ liệu NexCMP lưu trữ.
- [Tự động nạp tiền](https://nexcmp.com/vi/docs/billing/auto-top-up.md): Tự động nạp tiền vào ví khách hàng từ thẻ đã lưu hoặc PayPal — hỗ trợ theo mức dùng và cố định, hạn mức chung cùng xử lý lỗi.
- [Hóa đơn và sổ cái](https://nexcmp.com/vi/docs/billing/invoices-and-ledger.md): Nơi ghi nhận dòng tiền trong NexCMP — sổ cái ví, hóa đơn, nạp tiền, hoàn tiền và chi trả, voucher và báo cáo doanh thu.
- [Khuyến mãi](https://nexcmp.com/vi/docs/billing/promotions.md): Phát hành mã nạp tiền: thưởng ví, credit cho dịch vụ và giảm giá % kèm mức tối đa và đơn hàng tối thiểu — tạo, phân phối và theo dõi.
- [Quotas](https://nexcmp.com/vi/docs/billing/quotas.md): Giới hạn tài nguyên khách mới được tạo trước khi nạp ví: gói tài nguyên VM, số lượng VM và quota từng dịch vụ, có thể ghi đè riêng cho từng khách.

## Khách hàng & reseller

- [Quản lý khách hàng](https://nexcmp.com/vi/docs/customers/managing-customers.md): Tìm kiếm và hỗ trợ khách hàng: danh sách khách hàng, quốc gia theo IP, nguồn giới thiệu, thao tác tài khoản, yêu cầu xóa và chuyển dịch vụ.
- [Đăng nhập với tư cách khách hàng](https://nexcmp.com/vi/docs/customers/login-as.md): Mở customer portal với tư cách một khách hàng trong 1 giờ để tái hiện sự cố — điều kiện, biện pháp bảo vệ cùng những gì bị chặn và ghi log.
- [Reseller (white-label)](https://nexcmp.com/vi/docs/customers/resellers.md): Cho phép đối tác bán cloud của bạn dưới thương hiệu riêng — tạo reseller, cấu hình tên miền, DNS, giá sỉ, giá trị mặc định và slot license.
- [Tùy biến thương hiệu](https://nexcmp.com/vi/docs/customers/branding.md): Gắn tên, logo, màu sắc và tiền tệ riêng lên portal khách hàng, admin console và email — quy chuẩn upload cùng vị trí hiển thị của từng cài đặt.
- [Các trang pháp lý](https://nexcmp.com/vi/docs/customers/legal.md): Soạn Điều khoản dịch vụ và Chính sách bảo mật tại /terms và /privacy — văn bản mẫu trung lập, bản tiếng Anh/tiếng Việt và quy tắc markdown an toàn.

## Customer portal

- [Tổng quan portal khách hàng](https://nexcmp.com/vi/docs/portal/overview.md): Khám phá portal khách hàng: dashboard, menu, ví tiền, máy ảo, cài đặt tài khoản, ngôn ngữ và tiền tệ.
- [Đăng ký, ví và nạp tiền](https://nexcmp.com/vi/docs/portal/sign-up-and-wallet.md): Cách khách hàng đăng ký, xác minh email, nạp tiền vào ví, đổi mã voucher và xem lịch sử thanh toán.
- [Đặt mua dịch vụ](https://nexcmp.com/vi/docs/portal/ordering.md): Từng bước trên trang đặt hàng: dịch vụ, vị trí, gói cấu hình, chu kỳ thanh toán, hệ điều hành, hostname và số lượng, sau đó thanh toán từ ví.
- [Máy ảo](https://nexcmp.com/vi/docs/portal/virtual-machines.md): Quản lý máy ảo từ portal: tổng quan, thao tác nguồn, đặt lại mật khẩu, cài lại hệ điều hành, giám sát, mạng, cấu hình và nhật ký hoạt động.
- [Console](https://nexcmp.com/vi/docs/portal/console.md): Mở console VM trên trình duyệt (VNC) và tùy chọn terminal web SSH; yêu cầu hạ tầng cho từng loại.
- [Snapshots và Backups](https://nexcmp.com/vi/docs/portal/snapshots.md): Tạo, khôi phục và xóa VM snapshots từ portal, lên lịch chụp và xem các tính năng từng nguồn hỗ trợ.
- [Hỗ trợ khách hàng](https://nexcmp.com/vi/docs/portal/support.md): Cách khách hàng nhận hỗ trợ: bong bóng chat với câu trả lời từ AI, lối tắt Telegram và Zalo cùng ticket.

## AI

- [Nhà cung cấp AI](https://nexcmp.com/vi/docs/ai/ai-providers.md): Kết nối endpoint AI tương thích OpenAI cho AI Chat và AI Agent — bật module AI, nhập endpoint và key, kiểm tra kết nối và đặt giới hạn.
- [AI Chat](https://nexcmp.com/vi/docs/ai/ai-chat.md): Chat hỗ trợ tự động cho khách hàng đã đăng nhập: tính năng, chuyển tiếp nhân sự qua Telegram, Zalo, nút tắt và các giới hạn bạn kiểm soát.
- [AI Agent](https://nexcmp.com/vi/docs/ai/ai-agent.md): Cho phép khách hàng quản trị VM Linux bằng ngôn ngữ tự nhiên — cách Agent kết nối qua SSH, các lệnh tự chạy và yêu cầu chuẩn bị hệ thống.

## Nhà phát triển

- [REST API](https://nexcmp.com/vi/docs/developers/api.md): Gọi customer API trên NexCMP: xác thực, tài liệu tương tác, tải OpenAPI/Postman, lỗi, rate limit, idempotency và ví dụ curl.
- [API key và scope](https://nexcmp.com/vi/docs/developers/api-keys.md): Cách khách hàng tạo API key (tiền tố vk_), chọn scope, giới hạn theo IP và ngày hết hạn, cùng cách quản trị viên xem lại và thu hồi chúng.
- [Công cụ dòng lệnh cmp](https://nexcmp.com/vi/docs/developers/cmp-cli.md): Cài đặt và sử dụng cmp CLI từ panel của bạn: đăng nhập bằng mã một lần, lệnh sinh từ API, kết quả và mã thoát, dùng cho CI cùng cập nhật có chữ ký.
- [MCP server](https://nexcmp.com/vi/docs/developers/mcp.md): Kết nối trợ lý AI (Claude, Cursor, VS Code...) với API hệ thống qua endpoint MCP tại /mcp — xác thực, cấu hình client, tools và quy tắc an toàn.

## Cấu hình bằng AI

- [Cấu hình bằng AI](https://nexcmp.com/vi/docs/configure-with-ai/overview.md): Để trợ lý AI thiết lập và vận hành NexCMP: AI Chat trong admin, client AI qua MCP hoặc file YAML. Khả năng và các quy tắc bảo mật.
- [AI Chat trong trang quản trị](https://nexcmp.com/vi/docs/configure-with-ai/ai-chat-in-admin.md): Cấu hình NexCMP qua chat trong admin: chọn nguồn AI, duyệt thẻ xác nhận cho từng thay đổi, truyền secret an toàn và đặt giới hạn chi tiêu ngày.
- [Tài khoản và gói đăng ký AI](https://nexcmp.com/vi/docs/configure-with-ai/ai-accounts-and-subscriptions.md): Kết nối nguồn AI cho AI Chat (API key, OpenRouter hoặc Google sign-in, panel provider) và dùng gói Claude, ChatGPT, Gemini riêng qua CLI chính thức.
- [Admin API key](https://nexcmp.com/vi/docs/configure-with-ai/admin-api-keys.md): Tạo và thu hồi ak_ admin key cho AI Agent và script: tám scope, thời hạn, dải IP, rate limit, những gì key không thể làm và toàn bộ mã lỗi.
- [Kết nối client AI (MCP)](https://nexcmp.com/vi/docs/configure-with-ai/mcp-admin.md): Kết nối Claude Code, Codex CLI, Gemini CLI, Cursor, Claude Desktop, claude.ai, ChatGPT hay OpenAI SDK với admin MCP endpoint của panel, kèm đầy đủ công cụ.
- [Connector claude.ai và ChatGPT](https://nexcmp.com/vi/docs/configure-with-ai/oauth-connectors.md): Kết nối ứng dụng AI web như claude.ai và ChatGPT với panel qua OAuth 2.1: đăng nhập admin, chọn scope và thời hạn, thu hồi kết nối bất cứ khi nào.
- [Cấu hình dưới dạng mã](https://nexcmp.com/vi/docs/configure-with-ai/config-as-code.md): Xuất cấu hình panel ra file YAML, xem trước và áp dụng qua nexcmp config hoặc trang Import/Export; secret nằm ngoài file và được JSON Schema kiểm tra.
- [Prompt mẫu](https://nexcmp.com/vi/docs/configure-with-ai/example-prompts.md): Prompt dùng ngay cho AI Chat hoặc AI client: thiết lập ban đầu, thêm Proxmox, bảng plan theo margin, SMTP, Stripe, Telegram, credit và export cấu hình.
- [Danh sách kiểm tra tiến độ thiết lập](https://nexcmp.com/vi/docs/configure-with-ai/setup-checklist.md): Thẻ Setup progress ở Overview hiển thị mười bước thiết lập và cho phép trợ lý AI thực hiện bước tiếp theo giúp bạn với Do it for me.

## Quản trị

- [SMTP và template email](https://nexcmp.com/vi/docs/administration/smtp-and-emails.md): Cấu hình gửi email (SMTP), gửi thư thử nghiệm, chỉnh sửa template email theo từng ngôn ngữ và xem nhật ký gửi thư.
- [Telegram và cảnh báo quản trị](https://nexcmp.com/vi/docs/administration/telegram-notifications.md): Gửi cảnh báo vận hành, sự kiện nạp tiền và đăng ký qua Telegram, webhook hoặc email, đồng thời thiết lập shortcut hỗ trợ hiển thị cho khách.
- [Nhật ký kiểm toán và hoạt động](https://nexcmp.com/vi/docs/administration/audit-log.md): Theo dõi ai đã làm gì: dòng thời gian hoạt động tập trung, tác vụ admin, đăng nhập của khách, sự kiện VM, email đã gửi và cách tìm theo mã sự kiện.
- [Security](https://nexcmp.com/vi/docs/administration/security.md): Bảo vệ console admin với 2FA và allowlist IP, quản lý vai trò admin, cấu hình đăng nhập khách: passkey, Google, GitHub, captcha và chặn miền email.
- [Cài đặt chung](https://nexcmp.com/vi/docs/administration/general-settings.md): Tên thương hiệu và URL, thông tin người bán in trên hóa đơn, tiền tố số hóa đơn, ngôn ngữ mặc định và chế độ bảo trì khách hàng.
- [Báo cáo lỗi](https://nexcmp.com/vi/docs/administration/report-a-bug.md): Gửi báo cáo lỗi từ admin console tới đội ngũ NexCMP qua ticket: biểu mẫu, dữ liệu gửi đi, dữ liệu không bao giờ gửi, giới hạn và cách khắc phục lỗi.

## Khắc phục sự cố & FAQ

- [Lỗi cài đặt](https://nexcmp.com/vi/docs/troubleshooting/installation-errors.md): Mọi thông báo lỗi từ trình cài đặt NexCMP, nguyên nhân và cách xử lý — yêu cầu hệ thống, kích hoạt license, xác minh tải về, dịch vụ và nginx/TLS.
- [Lỗi cập nhật](https://nexcmp.com/vi/docs/troubleshooting/update-errors.md): Lý do cập nhật NexCMP thất bại — quyền hạn, xác minh tải về, chữ ký, khởi động lại — và cách khôi phục hoặc rollback.
- [FAQ](https://nexcmp.com/vi/docs/troubleshooting/faq.md): Các câu hỏi thường gặp về cài đặt, cấp phép license, kết nối hạ tầng và vận hành NexCMP.
- [Hỗ trợ](https://nexcmp.com/vi/docs/troubleshooting/support.md): Cách nhận hỗ trợ về NexCMP: thông tin cần thu thập, nội dung cần gửi và nơi liên hệ.

## Optional

- [Full documentation in one file](https://nexcmp.com/vi/docs/llms-full.txt)
- [Sitemap](https://nexcmp.com/vi/docs/sitemap.xml)
- [Product site](https://nexcmp.com)