# 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/zh-cn/docs/): what is in these docs

## 入门指南

- [NexCMP简介](https://nexcmp.com/zh-cn/docs/getting-started/what-is-nexcmp.md): NexCMP是一套自托管的客户门户、计费系统和管理控制台，用于销售运行在您自有CloudStack或Proxmox VE上的虚拟机与云服务。
- [NexCMP服务器要求](https://nexcmp.com/zh-cn/docs/getting-started/requirements.md): 运行NexCMP本身的服务器在硬件、操作系统、网络及DNS方面的要求。
- [许可证与购买](https://nexcmp.com/zh-cn/docs/getting-started/license-and-purchase.md): NexCMP许可证机制详解——获取许可证密钥、绑定域名、分销商域名、更新权限以及许可证过期后的影响。
- [安装NexCMP](https://nexcmp.com/zh-cn/docs/getting-started/installation.md): 使用单行安装命令在Ubuntu上安装NexCMP：参数详解、安装步骤、TLS与nginx配置，以及如何进入设置向导。
- [DNS与Cloudflare](https://nexcmp.com/zh-cn/docs/getting-started/dns-and-cloudflare.md): 将您的域名解析至NexCMP服务器（可选通过Cloudflare），并使用正确的SSL模式获取有效证书。
- [安装向导](https://nexcmp.com/zh-cn/docs/getting-started/setup-wizard.md): 通过 /setup 体验首次运行向导——设置安装码、许可证、稍后配置 CloudStack 或 Connect、管理员和品牌。
- [首次登录与后续步骤](https://nexcmp.com/zh-cn/docs/getting-started/first-login.md): 首次登录管理控制台，并完成建议的配置检查清单。
- [更新NexCMP](https://nexcmp.com/zh-cn/docs/getting-started/updating.md): 通过管理控制台或命令行更新NexCMP、发布版本的验证方式，以及您有权获取的内容。
- [发布说明](https://nexcmp.com/zh-cn/docs/getting-started/release-notes.md): NexCMP 1.3至1.6.1的变更及升级检查事项：AI管理、VPN计量、客户服务和Bare Metal。
- [备份与恢复](https://nexcmp.com/zh-cn/docs/getting-started/backup-and-restore.md): 使用nexcmp backup对NexCMP数据和配置进行一致性备份，并可在同一服务器或新服务器上进行恢复。
- [卸载NexCMP](https://nexcmp.com/zh-cn/docs/getting-started/uninstall.md): 删除NexCMP服务和程序（可选择是否保留数据），并说明基础设施上会保留哪些内容。
- [nexcmp命令参考](https://nexcmp.com/zh-cn/docs/getting-started/cli-reference.md): nexcmp服务器命令行工具的所有子命令详解——status、update、backup、uninstall、open-port、close-port和fix-owner。

## 基础设施

- [基础设施要求](https://nexcmp.com/zh-cn/docs/infrastructure/requirements.md): 一览表：各 NexCMP 模块所需的最低基础设施要求，以及说明如何准备和连接的相关页面。
- [架构](https://nexcmp.com/zh-cn/docs/infrastructure/architecture.md): NexCMP的组成架构：域名、nginx、panel与worker服务，以及它们连接的每个系统，包含各路径使用的端口和数据。
- [模块](https://nexcmp.com/zh-cn/docs/infrastructure/modules.md): NexCMP所有模块的默认状态、新增功能、所需基础设施及启用位置，包括启动时读取的附加模块。
- [区域](https://nexcmp.com/zh-cn/docs/infrastructure/zones.md): NexCMP区域运作机制：客户下单时选择的位置、区域如何关联CloudStack、Proxmox VE、VPN与S3，以及何时具备销售条件。
- [CloudStack](https://nexcmp.com/zh-cn/docs/infrastructure/cloudstack.md): 将Apache CloudStack连接至NexCMP：使用cmk创建专属域、账户与API密钥，然后在设置向导或管理控制台中填入。
- [Proxmox VE](https://nexcmp.com/zh-cn/docs/infrastructure/proxmox.md): 将Proxmox VE集群添加为虚拟机源：最小权限API token、存储、cloud-image模板、IP池、TLS固定以及按方案配置源。
- [操作系统模板与ISO](https://nexcmp.com/zh-cn/docs/infrastructure/templates.md): 准备供客户部署的操作系统镜像：构建并注册CloudStack模板，制作Proxmox VE cloud-image模板。
- [独立服务器（裸金属）](https://nexcmp.com/zh-cn/docs/infrastructure/dedicated.md): 销售通过iDRAC和Redfish管理的Dell服务器：网络与ISO服务器先决条件、导入服务器、安全开关、模板与方案。
- [VPN与IPv6代理节点](https://nexcmp.com/zh-cn/docs/infrastructure/vpn-proxy-nodes.md): 将Linux主机配置为VPN节点（cmp-agent）和IPv6代理节点：涵盖操作系统、IP地址与IPv6前缀、端口、sysctl配置、安装以及心跳机制。
- [AI Models](https://nexcmp.com/zh-cn/docs/infrastructure/ai-models.md): 通过您自己的网关销售AI模型访问权限：添加兼容OpenAI或Anthropic的提供商、同步模型、设定价格，让客户使用自己的密钥和钱包调用单一端点。
- [Object Storage (S3, Ceph RGW)](https://nexcmp.com/zh-cn/docs/infrastructure/s3.md): 基于Ceph集群开展按量计费S3存储业务：RGW要求、管理用户与权限，以及如何在NexCMP中将后端关联至区域。
- [Kubernetes与私有云](https://nexcmp.com/zh-cn/docs/infrastructure/kubernetes-and-private-cloud.md): 在CloudStack上销售Kubernetes集群（CKS）与独享带宽私有云（VPC）：所需服务方案及对接位置。

## 目录与定价

- [方案与定价](https://nexcmp.com/zh-cn/docs/catalog/plans.md): 创建虚拟机方案并定价：规格、按小时与按月价格、计费周期、自定义方案、克隆，以及价格变动对运行中虚拟机的影响。
- [带宽配额与流量包](https://nexcmp.com/zh-cn/docs/catalog/bandwidth.md): 介绍NexCMP如何根据CloudStack统计数据按服务计量流量、默认配额、80%与100%预警、超额处理策略及流量包。
- [货币与汇率](https://nexcmp.com/zh-cn/docs/catalog/currency-and-exchange-rates.md): NexCMP如何以美元结算资金、根据语言显示其他货币，以及管理员如何发布USD/VND汇率和显示汇率。

## 计费与支付

- [支付渠道](https://nexcmp.com/zh-cn/docs/billing/payment-channels.md): 介绍客户如何在NexCMP中为钱包充值——可用渠道、各渠道启用方法、手续费、限额及监控方式。
- [Stripe](https://nexcmp.com/zh-cn/docs/billing/stripe.md): 将Stripe接入NexCMP以支持银行卡、Apple Pay、Google Pay、Link及Alipay——涵盖API密钥、Webhook、域名注册与测试支付。
- [PayPal](https://nexcmp.com/zh-cn/docs/billing/paypal.md): 将 PayPal 连接至 NexCMP 以实现钱包充值——支持 REST 应用凭据、Webhook、沙箱测试和保存的 PayPal 账户。
- [USDT (Binance)](https://nexcmp.com/zh-cn/docs/billing/usdt.md): 通过监视Binance充值地址接受USDT钱包充值——支持只读API密钥、网络选择、地址验证和未匹配充值。
- [银行转账（越南）](https://nexcmp.com/zh-cn/docs/billing/bank-transfer-vn.md): 通过 SePay 接受越南盾（VND）银行转账——接收账户、附言前缀、Webhook、限额以及如何分配未匹配的转账。
- [最低充值](https://nexcmp.com/zh-cn/docs/billing/minimum-top-up.md): 设置每次支付的最小和最大钱包充值金额，并了解决定客户能否下单的其他余额门槛。
- [保存的支付方式](https://nexcmp.com/zh-cn/docs/billing/saved-payment-methods.md): 了解客户如何保存银行卡、Stripe钱包或PayPal账户以实现自动充值，如何移除它们，以及NexCMP存储了哪些数据。
- [自动充值](https://nexcmp.com/zh-cn/docs/billing/auto-top-up.md): 通过保存的卡片或PayPal账户自动保持客户钱包有余额——支持用量计费和固定模式、全局限制以及失败处理。
- [发票与总账](https://nexcmp.com/zh-cn/docs/billing/invoices-and-ledger.md): 记录 NexCMP 中资金流向的地方——钱包总账、发票、充值付款、退款与出金、代金券以及收入报告。
- [促销代码](https://nexcmp.com/zh-cn/docs/billing/promotions.md): 发放充值码：钱包彩金、专用服务额度以及带最高限额和最低订单要求的折扣百分比——创建、分发并进行追踪。
- [配额](https://nexcmp.com/zh-cn/docs/billing/quotas.md): 在客户向钱包充值之前限制新客户的创建权限——虚拟机资源层级、虚拟机数量及单服务配额，并支持按客户进行覆盖。

## 客户与分销商

- [管理客户](https://nexcmp.com/zh-cn/docs/customers/managing-customers.md): 查找并支持客户：客户列表、按 IP 划分的国家/地区、推荐来源、账户操作、删除请求和服务转移。
- [以客户身份登录](https://nexcmp.com/zh-cn/docs/customers/login-as.md): 以特定客户身份打开客户门户一小时以重现问题——包括条件、安全措施、阻止与记录的内容。
- [分销商（白标）](https://nexcmp.com/zh-cn/docs/customers/resellers.md): 允许合作伙伴使用他们自己的品牌和域名销售您的云服务——创建分销商、设置域名与 DNS、批发定价、默认值以及许可席位。
- [Branding](https://nexcmp.com/zh-cn/docs/customers/branding.md): 为客户门户、管理控制台和电子邮件配置您自己的名称、徽标、颜色和货币——上传规则及每个设置的显示位置。
- [法律页面](https://nexcmp.com/zh-cn/docs/customers/legal.md): 编写在 /terms 和 /privacy 显示的服务条款与隐私政策——默认采用中立文本、英语和越南语版本以及安全的 Markdown 规则。

## 客户门户

- [客户门户概览](https://nexcmp.com/zh-cn/docs/portal/overview.md): 客户门户导览：仪表盘、菜单、钱包、虚拟机、账户设置、语言和货币。
- [注册、钱包与充值](https://nexcmp.com/zh-cn/docs/portal/sign-up-and-wallet.md): 了解客户如何注册、验证电子邮箱、向钱包充值、兑换代码以及查看账单历史。
- [订购服务](https://nexcmp.com/zh-cn/docs/portal/ordering.md): 订购页面逐步说明：服务、位置、套餐、计费周期、操作系统、主机名和数量，然后在钱包中支付。
- [虚拟机](https://nexcmp.com/zh-cn/docs/portal/virtual-machines.md): 从门户管理虚拟机：概览、电源操作、重置密码、重装系统、监控、网络、配置和活动。
- [控制台](https://nexcmp.com/zh-cn/docs/portal/console.md): 在浏览器中打开虚拟机控制台（VNC），并可选配网页SSH终端；了解各项功能对基础设施的要求。
- [Snapshots 和 Backups](https://nexcmp.com/zh-cn/docs/portal/snapshots.md): 在门户中创建、恢复和删除虚拟机快照，设置计划任务，并了解各来源支持的功能。
- [客户支持](https://nexcmp.com/zh-cn/docs/portal/support.md): 客户如何获取帮助：带有AI回答的聊天气泡、Telegram与Zalo快捷方式以及工单。

## AI

- [AI 提供商](https://nexcmp.com/zh-cn/docs/ai/ai-providers.md): 为 AI Chat 和 AI Agent 连接兼容 OpenAI 的 AI 端点——开启 AI 模块，输入端点和密钥，进行测试并设置限制。
- [AI Chat](https://nexcmp.com/zh-cn/docs/ai/ai-chat.md): 面向已登录客户的自动支持聊天：了解其功能、通过Telegram、Zalo及Telegram快捷按钮转接至您的员工，以及您可控的各项限制。
- [AI Agent](https://nexcmp.com/zh-cn/docs/ai/ai-agent.md): 允许客户通过自然语言描述任务来管理其Linux虚拟机——Agent如何通过SSH连接、它可独立运行哪些操作，以及您必须准备好的环境。

## 开发者

- [REST API](https://nexcmp.com/zh-cn/docs/developers/api.md): 调用 NexCMP 安装实例的客户 API：身份验证、交互式参考、OpenAPI 和 Postman 下载、错误、速率限制、幂等性以及 curl 示例。
- [API密钥与作用域](https://nexcmp.com/zh-cn/docs/developers/api-keys.md): 客户如何创建API密钥（vk_前缀）、选择作用域、按IP和过期时间进行限制，以及管理员如何审查和吊销这些密钥。
- [cmp 命令行工具](https://nexcmp.com/zh-cn/docs/developers/cmp-cli.md): 安装并使用面板自带的 cmp CLI：通过一次性代码进行浏览器登录、根据API生成的命令、输出与退出码、CI使用以及签名更新。
- [MCP 服务器](https://nexcmp.com/zh-cn/docs/developers/mcp.md): 通过 /mcp 处的内置 MCP 端点将 AI 助手（Claude、Cursor、VS Code 等）连接到您的安装版 API —— 包含身份验证、客户端配置、工具和安全规则。

## 通过AI进行配置

- [通过AI进行配置](https://nexcmp.com/zh-cn/docs/configure-with-ai/overview.md): 让AI助手设置并运行您的NexCMP：使用管理端的AI Chat、通过MCP连接您自己的AI客户端，或是使用YAML文件。了解其功能及相关的安全规则。
- [后台中的AI Chat](https://nexcmp.com/zh-cn/docs/configure-with-ai/ai-chat-in-admin.md): 通过在后台中进行对话来配置NexCMP：选择AI source，审查每次更改的确认卡片，安全地传递密钥并保持每日消费上限。
- [AI账户与订阅](https://nexcmp.com/zh-cn/docs/configure-with-ai/ai-accounts-and-subscriptions.md): 连接用于AI Chat的AI来源（API密钥、OpenRouter或Google登录、面板提供商），并通过官方CLI使用您自己的Claude、ChatGPT或Gemini订阅。
- [Admin API keys](https://nexcmp.com/zh-cn/docs/configure-with-ai/admin-api-keys.md): 为 AI 代理和脚本创建并撤销 ak_ 管理员密钥：八个权限范围、过期时间、IP 范围、速率限制、密钥永不能执行的操作以及每个错误代码。
- [连接AI客户端 (MCP)](https://nexcmp.com/zh-cn/docs/configure-with-ai/mcp-admin.md): 将Claude Code、Codex CLI、Gemini CLI、Cursor、Claude Desktop、claude.ai、ChatGPT或OpenAI SDK连接到面板的管理员MCP端点，并使用完整的工具列表。
- [claude.ai和ChatGPT连接器](https://nexcmp.com/zh-cn/docs/configure-with-ai/oauth-connectors.md): 使用OAuth 2.1将claude.ai和ChatGPT等Web AI应用连接到您的面板：以管理员身份登录、选择权限范围和有效期，并在需要时随时撤销连接。
- [代码化配置](https://nexcmp.com/zh-cn/docs/configure-with-ai/config-as-code.md): 将面板配置导出为 YAML 文件，预览更改并使用 nexcmp config 或“导入/导出”页面应用它们；密钥不会保存在文件中，且可通过 JSON Schema 进行校验。
- [示例提示词](https://nexcmp.com/zh-cn/docs/configure-with-ai/example-prompts.md): 适用于 AI Chat 或您自己的 AI 客户端的可复制提示词：首次设置、添加 Proxmox、带利润率的方案表、SMTP、Stripe、Telegram、客户余额以及导出您的配置。
- [安装进度检查清单](https://nexcmp.com/zh-cn/docs/configure-with-ai/setup-checklist.md): 管理后台Overview上的Setup progress卡片展示了打造可用商店所需的十个步骤，并可通过Do it for me让AI助手为你完成下一步。

## 系统管理

- [SMTP 和电子邮件模板](https://nexcmp.com/zh-cn/docs/administration/smtp-and-emails.md): 配置发信电子邮件 (SMTP)、发送测试消息、编辑各语言的电子邮件模板并查看投递日志。
- [Telegram和管理员警报](https://nexcmp.com/zh-cn/docs/administration/telegram-notifications.md): 将操作警报、客户注册和充值事件发送到Telegram群组、Webhook或电子邮箱，并设置向客户展示的客服快捷方式。
- [审计日志与活动](https://nexcmp.com/zh-cn/docs/administration/audit-log.md): 了解谁做了什么：统一的活动时间线、管理员操作、客户登录、VM 事件及发送的电子邮件，以及如何按事件代码进行搜索。
- [Security](https://nexcmp.com/zh-cn/docs/administration/security.md): 通过双重身份验证和 IP 允许列表保护管理控制台，管理管理员角色，并配置客户登录：通行密钥、Google 和 GitHub、验证码以及阻止的电子邮件域名。
- [常规设置](https://nexcmp.com/zh-cn/docs/administration/general-settings.md): 品牌名称与URL、打印在发票上的卖家详情、发票号前缀、默认语言以及客户维护模式。
- [报告Bug](https://nexcmp.com/zh-cn/docs/administration/report-a-bug.md): 从管理控制台直接向NexCMP团队提交Bug工单：表单说明、具体发送与绝不发送的数据、配额限制以及常见错误解决方法。

## 故障排查与常见问题

- [安装错误](https://nexcmp.com/zh-cn/docs/troubleshooting/installation-errors.md): NexCMP 安装程序可能打印的每个错误消息、其原因及修复方法 — 包含系统要求、许可证激活、下载验证、服务以及 nginx/TLS。
- [更新错误](https://nexcmp.com/zh-cn/docs/troubleshooting/update-errors.md): 为什么 NexCMP 更新会失败——授权、下载验证、签名、重启——以及如何恢复或回滚。
- [FAQ](https://nexcmp.com/zh-cn/docs/troubleshooting/faq.md): 关于 NexCMP 安装、授权、连接基础设施和运行的常见问题。
- [支持](https://nexcmp.com/zh-cn/docs/troubleshooting/support.md): 获取NexCMP帮助的方法：需要收集什么、邮件中应包含什么内容以及发送至何处。

## Optional

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