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

## 시작하기

- [NexCMP란 무엇인가요](https://nexcmp.com/ko/docs/getting-started/what-is-nexcmp.md): NexCMP는 자체 CloudStack 또는 Proxmox VE에서 실행되는 가상 머신과 클라우드 서비스를 판매할 수 있는 셀프 호스팅 고객 포털, 빌링 시스템 및 관리자 콘솔입니다.
- [NexCMP 서버 요구 사항](https://nexcmp.com/ko/docs/getting-started/requirements.md): NexCMP를 실행하는 서버의 하드웨어, 운영 체제, 네트워크 및 DNS 요구 사항입니다.
- [라이선스 및 구매](https://nexcmp.com/ko/docs/getting-started/license-and-purchase.md): NexCMP 라이선스 작동 방식 — 라이선스 키 발급, 도메인 바인딩, 리셀러 도메인, 업데이트 자격, 라이선스 만료 시 동작에 대한 안내입니다.
- [NexCMP 설치](https://nexcmp.com/ko/docs/getting-started/installation.md): 한 줄 설치 프로그램으로 Ubuntu에 NexCMP를 설치하세요. 매개변수, 설치 프로그램의 동작, TLS 및 nginx, 그리고 설정 마법사에 접속하는 방법을 안내합니다.
- [DNS 및 Cloudflare](https://nexcmp.com/ko/docs/getting-started/dns-and-cloudflare.md): NexCMP 서버를 도메인에 지정하고(선택적으로 Cloudflare 경유) 올바른 SSL 모드로 유효한 인증서를 받으십시오.
- [설정 마법사](https://nexcmp.com/ko/docs/getting-started/setup-wizard.md): /setup에서 설정 코드, 라이선스, CloudStack 또는 Connect later, 관리자 및 브랜드를 단계별로 구성하는 초기 마법사를 진행합니다.
- [첫 로그인 및 다음 단계](https://nexcmp.com/ko/docs/getting-started/first-login.md): 관리자 콘솔에 처음으로 로그인하고 권장 구성 체크리스트를 완료하세요.
- [NexCMP 업데이트](https://nexcmp.com/ko/docs/getting-started/updating.md): 관리자 콘솔 또는 명령 줄에서 NexCMP를 업데이트하는 방법, 릴리스 검증 방식, 제공받을 수 있는 권한에 대해 설명합니다.
- [릴리스 노트](https://nexcmp.com/ko/docs/getting-started/release-notes.md): NexCMP 1.3에서 1.6.1까지의 변경 사항 및 업그레이드 시 확인 사항: AI 관리, VPN 측정, 고객 서비스 및 Bare Metal.
- [백업 및 복구](https://nexcmp.com/ko/docs/getting-started/backup-and-restore.md): nexcmp backup으로 NexCMP 데이터와 설정의 일관된 백업을 수행하고, 동일한 서버나 새 서버에 복구하세요.
- [NexCMP 제거](https://nexcmp.com/ko/docs/getting-started/uninstall.md): NexCMP 서비스와 프로그램을 데이터 삭제 여부와 관계없이 제거하며, 인프라에 남는 항목을 안내합니다.
- [nexcmp 명령어 참조](https://nexcmp.com/ko/docs/getting-started/cli-reference.md): status, update, backup, uninstall, open-port, close-port, fix-owner 등 nexcmp 서버 커맨드 라인 도구의 모든 하위 명령어.

## 인프라

- [인프라 요구사항](https://nexcmp.com/ko/docs/infrastructure/requirements.md): 단일 표: 모든 NexCMP 모듈에 필요한 최소 인프라와 준비 및 연결 방법을 설명하는 페이지입니다.
- [아키텍처](https://nexcmp.com/ko/docs/infrastructure/architecture.md): NexCMP의 구성 요소(도메인, nginx, 패널 및 워커 서비스, 그리고 이들이 연결되는 모든 시스템)와 각 경로가 사용하는 포트 및 데이터에 대한 설명입니다.
- [모듈](https://nexcmp.com/ko/docs/infrastructure/modules.md): 기본 상태, 추가 기능, 필요한 인프라 및 활성화 위치를 포함하여 시작 시 읽어들이는 애드온 모듈을 포함한 모든 NexCMP 모듈입니다.
- [Zones](https://nexcmp.com/ko/docs/infrastructure/zones.md): NexCMP 존의 작동 방식: 고객이 주문할 때 선택하는 위치, 존이 CloudStack, Proxmox VE, VPN, S3에 연결되는 방식, 판매 준비가 완료되는 시점에 대해 설명합니다.
- [CloudStack](https://nexcmp.com/ko/docs/infrastructure/cloudstack.md): Apache CloudStack과 NexCMP를 연결하세요: cmk로 전용 도메인, 계정 및 API 키를 생성한 후 설치 마법사나 관리자 콘솔에 입력합니다.
- [Proxmox VE](https://nexcmp.com/ko/docs/infrastructure/proxmox.md): 최소 권한 API 토큰, 스토리지, 클라우드 이미지 템플릿, IP 풀, TLS 고정 및 플랜별 소스를 사용하여 Proxmox VE 클러스터를 VM 소스로 추가합니다.
- [OS 템플릿 및 ISO](https://nexcmp.com/ko/docs/infrastructure/templates.md): 고객이 배포할 OS 이미지를 준비합니다. CloudStack 템플릿을 빌드 및 등록하고 Proxmox VE 클라우드 이미지 템플릿을 만듭니다.
- [전용 서버 (베어메탈)](https://nexcmp.com/ko/docs/infrastructure/dedicated.md): iDRAC 및 Redfish로 관리되는 Dell 서버 판매: 네트워크 및 ISO 서버 필수 조건, 서버 가져오기, 안전 스위치, 템플릿 및 플랜.
- [VPN 및 IPv6 프록시 노드](https://nexcmp.com/ko/docs/infrastructure/vpn-proxy-nodes.md): Linux 호스트를 VPN 노드(cmp-agent) 및 IPv6 프록시 노드로 준비하는 방법: 운영 체제, IP 주소 및 IPv6 프리픽스, 포트, sysctl, 설치 및 하트비트.
- [AI 모델](https://nexcmp.com/ko/docs/infrastructure/ai-models.md): 자체 게이트웨이로 AI 모델 판매: OpenAI/Anthropic 호환 공급자 추가, 모델 동기화, 가격 설정 후 고객이 자체 키와 지갑으로 단일 엔드포인트를 호출합니다.
- [Object Storage (S3, Ceph RGW)](https://nexcmp.com/ko/docs/infrastructure/s3.md): Ceph 클러스터에서 사용량 기반 S3 스토리지 판매: RGW 요구 사항, 관리자 사용자 및 권한, NexCMP에서 백엔드를 영역에 연결하는 방법.
- [Kubernetes and Private Cloud](https://nexcmp.com/ko/docs/infrastructure/kubernetes-and-private-cloud.md): CloudStack에서 Kubernetes 클러스터(CKS) 및 전용 대역폭 Private Cloud(VPC) 판매: 필수 오퍼링 및 연결 위치.

## 카탈로그 및 가격

- [요금제 및 가격 책정](https://nexcmp.com/ko/docs/catalog/plans.md): VM 요금제 생성 및 가격 설정: 사양, 시간당 및 월간 가격, 결제 주기, 커스텀 요금제, 복제, 그리고 가격 변경이 실행 중인 VM에 미치는 영향에 대해 알아봅니다.
- [대역폭 할당량 및 애드온](https://nexcmp.com/ko/docs/catalog/bandwidth.md): NexCMP가 CloudStack 통계를 기반으로 서비스별 트래픽을 측정하는 방법, 기본 할당량, 80% 및 100% 경고, 초과 사용 조치 및 애드온에 대해 설명합니다.
- [통화 및 환율](https://nexcmp.com/ko/docs/catalog/currency-and-exchange-rates.md): NexCMP가 미국 달러(USD)로 자금을 유지하고 언어별로 다른 통화를 표시하는 방식과 관리자가 USD/VND 환율 및 표시 환율을 게시하는 방법을 설명합니다.

## 빌링 및 결제

- [결제 채널](https://nexcmp.com/ko/docs/billing/payment-channels.md): NexCMP에서 고객이 지갑을 충전하는 방법 — 사용 가능한 채널, 각 채널 활성화 방법, 수수료, 한도 및 모니터링 방법을 안내합니다.
- [Stripe](https://nexcmp.com/ko/docs/billing/stripe.md): Stripe를 NexCMP에 연동하여 카드 결제, Apple Pay, Google Pay, Link 및 Alipay를 지원하세요 (API 키, 웹훅, 도메인 등록 및 테스트 결제).
- [PayPal](https://nexcmp.com/ko/docs/billing/paypal.md): PayPal을 NexCMP에 연동하여 잔액 충전을 지원하세요. REST 앱 자격 증명, 웹훅, 샌드박스 테스트 및 저장된 PayPal 계정을 관리할 수 있습니다.
- [USDT (Binance)](https://nexcmp.com/ko/docs/billing/usdt.md): 읽기 전용 API 키, 네트워크 선택, 주소 확인 및 미매칭 입금을 통해 바이낸스 입금 주소를 모니터링하여 USDT 지갑 충전을 수락합니다.
- [은행 송금 (베트남)](https://nexcmp.com/ko/docs/billing/bank-transfer-vn.md): Sepay를 통해 베트남 동(VND) 은행 송금 수락 — 수취 계좌, 메모 접두사, 웹훅, 한도 및 일치하지 않는 송금 내역을 할당하는 방법.
- [최소 충전](https://nexcmp.com/ko/docs/billing/minimum-top-up.md): 결제당 최소 및 최대 크레딧 충전 금액을 설정하고, 고객의 주문 가능 여부를 결정하는 기타 잔액 하한선에 대해 알아보세요.
- [Saved payment methods](https://nexcmp.com/ko/docs/billing/saved-payment-methods.md): 고객이 자동 충전을 위해 카드, Stripe 지갑 또는 PayPal 계정을 저장 및 삭제하는 방법과 NexCMP가 저장하는 정보에 대해 설명합니다.
- [자동 충전](https://nexcmp.com/ko/docs/billing/auto-top-up.md): 저장된 카드나 PayPal 계정을 통해 고객 지갑을 자동으로 충전합니다. 사용량 기반 및 고정 모드, 글로벌 한도 및 실패 처리를 지원합니다.
- [인보이스 및 원장](https://nexcmp.com/ko/docs/billing/invoices-and-ledger.md): NexCMP에서 자금이 기록되는 위치 — 지갑 원장, 인보이스, 충전 결제, 환불 및 지급, 바우처, 매출 보고서.
- [프로모션](https://nexcmp.com/ko/docs/billing/promotions.md): 충전 코드 발행: 지갑 보너스, 서비스 전용 크레딧, 상한선 및 최소 주문 금액이 있는 정률 할인 — 생성, 배포 및 추적.
- [할당량](https://nexcmp.com/ko/docs/billing/quotas.md): 고객이 지갑을 충전하기 전까지 신규 고객이 생성할 수 있는 리소스를 제한하세요. VM 리소스 계층, VM 수, 서비스별 할당량 및 고객별 재정의를 지원합니다.

## 고객 및 리셀러

- [고객 관리](https://nexcmp.com/ko/docs/customers/managing-customers.md): 고객 찾기 및 지원: 고객 목록, IP별 국가, 유입 경로, 계정 작업, 삭제 요청 및 서비스 이전.
- [고객으로 로그인](https://nexcmp.com/ko/docs/customers/login-as.md): 문제를 재현하기 위해 특정 고객의 권한으로 1시간 동안 고객 포털을 엽니다 — 조건, 보호 조치, 차단 및 기록되는 항목.
- [리셀러 (화이트라벨)](https://nexcmp.com/ko/docs/customers/resellers.md): 파트너가 자체 브랜드와 도메인으로 클라우드를 판매할 수 있도록 지원합니다. 리셀러 생성, 도메인 및 DNS 설정, 도매가, 기본값, 라이선스 슬롯을 관리하세요.
- [브랜딩](https://nexcmp.com/ko/docs/customers/branding.md): 고객 포털, 관리자 콘솔, 이메일에 자체 이름, 로고, 색상, 통화를 적용하세요. 업로드 규칙과 각 설정의 표시 위치를 안내합니다.
- [법적 문서 페이지](https://nexcmp.com/ko/docs/customers/legal.md): /terms 및 /privacy 페이지에 표시되는 이용약관과 개인정보 처리방침을 작성합니다. 기본 중립 텍스트, 영어 및 베트남어 버전, 안전한 마크다운 규칙을 제공합니다.

## 고객 포털

- [고객 포털 개요](https://nexcmp.com/ko/docs/portal/overview.md): 고객 포털 둘러보기: 대시보드, 메뉴, 지갑, 가상 머신, 계정 설정, 언어 및 통화.
- [가입, 지갑 및 충전](https://nexcmp.com/ko/docs/portal/sign-up-and-wallet.md): 고객이 등록하고, 이메일을 인증하고, 지갑에 크레딧을 추가하고, 코드를 교환하고, 청구 내역을 확인하는 방법입니다.
- [서비스 주문](https://nexcmp.com/ko/docs/portal/ordering.md): 주문 페이지의 단계별 안내: 서비스, 리전, 플랜, 결제 주기, 운영체제, 호스트명 및 수량 선택 후 지갑에서 결제합니다.
- [가상 머신](https://nexcmp.com/ko/docs/portal/virtual-machines.md): 포털에서 가상 머신 관리: 개요, 전원 제어, 비밀번호 초기화, 재설치, 모니터링, 네트워크, 설정 및 활동 내역.
- [콘솔](https://nexcmp.com/ko/docs/portal/console.md): 브라우저에서 VM 콘솔(VNC)과 선택적으로 웹 SSH 터미널을 엽니다. 각 기능이 인프라에서 요구하는 사항을 확인하세요.
- [Snapshots 및 backups](https://nexcmp.com/ko/docs/portal/snapshots.md): 포털에서 VM 스냅샷을 생성, 복구 및 삭제하고 일정을 예약하는 방법 및 각 소스가 지원하는 기능 안내.
- [고객 지원](https://nexcmp.com/ko/docs/portal/support.md): 고객이 지원을 받는 방법: AI 답변이 포함된 채팅 말풍선, 텔레그램 및 잘로(Zalo) 단축키, 티켓.

## AI

- [AI 공급자](https://nexcmp.com/ko/docs/ai/ai-providers.md): AI Chat 및 AI Agent를 위해 OpenAI 호환 AI 엔드포인트 연결 — AI 모듈 켜기, 엔드포인트 및 키 입력, 테스트 및 제한 설정.
- [AI Chat](https://nexcmp.com/ko/docs/ai/ai-chat.md): 로그인한 고객을 위한 자동 지원 채팅: 기능, 텔레그램, Zalo 및 텔레그램 바로 가기 버튼을 통한 직원 연계, 그리고 관리하는 제한 사항을 안내합니다.
- [AI Agent](https://nexcmp.com/ko/docs/ai/ai-agent.md): 고객이 평문으로 작업을 설명하여 Linux VM을 관리할 수 있도록 지원합니다. 에이전트의 SSH 연결 방식, 자체 실행 가능한 작업, 사전 준비 사항을 설명합니다.

## 개발자

- [REST API](https://nexcmp.com/ko/docs/developers/api.md): NexCMP 설치의 고객 API 호출 방법(인증, 대화형 레퍼런스, OpenAPI 및 Postman 다운로드, 오류, 요청 제한, 멱등성 및 curl 예제)에 대해 알아보세요.
- [API 키 및 스코프](https://nexcmp.com/ko/docs/developers/api-keys.md): 고객이 API 키(vk_ 접두사)를 생성하고, 스코프를 선택하며, IP 및 만료일로 제한하는 방법과 관리자가 이를 검토하고 취소하는 방법을 설명합니다.
- [cmp 명령줄 도구](https://nexcmp.com/ko/docs/developers/cmp-cli.md): 패널에서 제공하는 cmp CLI를 설치하고 사용해 보세요. 일회용 코드로 브라우저 로그인, API에서 생성된 명령어, 출력 및 종료 코드, CI 사용 및 서명된 업데이트를 지원합니다.
- [MCP 서버](https://nexcmp.com/ko/docs/developers/mcp.md): Claude, Cursor, VS Code 등의 AI 어시스턴트를 /mcp의 내장 MCP 엔드포인트를 통해 설치된 API에 연결하세요. 인증, 클라이언트 구성, 도구 및 안전 규칙을 제공합니다.

## AI로 설정하기

- [AI로 설정하기](https://nexcmp.com/ko/docs/configure-with-ai/overview.md): AI 어시스턴트로 NexCMP를 설정하고 운영하세요. 관리자 내 AI Chat, MCP 기반 자체 AI 클라이언트 또는 YAML 파일을 지원합니다. 주요 기능과 안전 수칙을 확인하세요.
- [관리자의 AI Chat](https://nexcmp.com/ko/docs/configure-with-ai/ai-chat-in-admin.md): 관리자에서 채팅을 통해 NexCMP를 구성하세요. AI 소스 선택, 모든 변경 사항에 대한 확인 카드 검토, 안전한 비밀 정보 전달 및 일일 지출 한도 유지가 가능합니다.
- [AI 계정 및 구독](https://nexcmp.com/ko/docs/configure-with-ai/ai-accounts-and-subscriptions.md): AI Chat용 AI 소스(API 키, OpenRouter 또는 Google 로그인, 패널 제공자)를 연결하고, 공식 CLI를 통해 자신만의 Claude, ChatGPT 또는 Gemini 구독을 사용하세요.
- [관리자 API 키](https://nexcmp.com/ko/docs/configure-with-ai/admin-api-keys.md): AI Agent 및 스크립트용 ak_ 관리자 키 생성과 해지: 8가지 scope, 만료 기간, IP 대역, rate limit, 키로 불가능한 작업 및 모든 오류 코드.
- [AI 클라이언트 연결 (MCP)](https://nexcmp.com/ko/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/ko/docs/configure-with-ai/oauth-connectors.md): claude.ai 및 ChatGPT 같은 웹 AI 앱을 OAuth 2.1로 패널에 연결하세요. 관리자로 로그인하여 권한 범위와 기간을 선택하고, 원할 때 언제든지 연결을 해제할 수 있습니다.
- [코드 기반 설정](https://nexcmp.com/ko/docs/configure-with-ai/config-as-code.md): 패널 설정을 YAML 파일로 내보내고, 변경 사항을 미리 본 후 nexcmp config 또는 가져오기/내보내기 페이지를 통해 적용하세요. 보안 비밀은 파일에 포함되지 않으며 JSON Schema가 이를 검증합니다.
- [프롬프트 예시](https://nexcmp.com/ko/docs/configure-with-ai/example-prompts.md): AI Chat 또는 외부 AI 클라이언트에서 바로 사용할 수 있는 프롬프트 모음: 초기 설정, Proxmox 추가, 마진이 포함된 상품 테이블, SMTP, Stripe, 텔레그램, 고객 크레딧, 설정 내보내기.
- [설정 진행률 체크리스트](https://nexcmp.com/ko/docs/configure-with-ai/setup-checklist.md): 관리자 개요의 설정 진행 카드에는 작동하는 상점을 위한 10단계가 표시되며 AI 어시스턴트가 Do it for me로 다음 단계를 처리하도록 합니다.

## 관리

- [SMTP 및 이메일 템플릿](https://nexcmp.com/ko/docs/administration/smtp-and-emails.md): 발송용 이메일(SMTP)을 설정하고, 테스트 메시지를 보내고, 각 언어별 이메일 템플릿을 편집하며, 전송 로그를 확인합니다.
- [텔레그램 및 관리자 알림](https://nexcmp.com/ko/docs/administration/telegram-notifications.md): 운영 알림, 고객 회원가입 및 입금 이벤트를 텔레그램 그룹, 웹훅 또는 이메일로 전송하고 고객에게 표시되는 지원 바로가기를 설정합니다.
- [감사 로그 및 활동](https://nexcmp.com/ko/docs/administration/audit-log.md): 누가 무엇을 했는지 확인하세요: 통합 활동 타임라인, 관리자 작업, 고객 로그인, VM 이벤트 및 발송된 이메일, 이벤트 코드로 검색하는 방법.
- [보안](https://nexcmp.com/ko/docs/administration/security.md): 관리자 콘솔을 2단계 인증과 IP 허용 목록으로 보호하고, 관리자 역할을 관리하며, 패스키, Google 및 GitHub, 캡차, 차단된 이메일 도메인 등 고객 로그인 설정을 구성합니다.
- [일반 설정](https://nexcmp.com/ko/docs/administration/general-settings.md): 브랜드 이름 및 URL, 인쇄물에 표시되는 판매자 세부 정보, 인쇄물 번호 접두사, 기본 언어 및 고객 유지 관리 모드.
- [버그 신고](https://nexcmp.com/ko/docs/administration/report-a-bug.md): 관리자 콘솔에서 NexCMP 팀으로 버그 보고서를 티켓 형태로 직접 전송하세요. 양식, 전송/제외 항목, 제한 사항 및 오류 해결 방법을 안내합니다.

## 문제 해결 및 FAQ

- [설치 오류](https://nexcmp.com/ko/docs/troubleshooting/installation-errors.md): NexCMP 설치 프로그램이 출력할 수 있는 모든 오류 메시지의 원인과 해결 방법(시스템 요구사항, 라이선스 활성화, 다운로드 확인, 서비스 및 nginx/TLS)을 안내합니다.
- [업데이트 오류](https://nexcmp.com/ko/docs/troubleshooting/update-errors.md): NexCMP 업데이트 실패 원인(권한, 다운로드 검증, 서명, 재시작) 및 복구 또는 롤백 방법.
- [FAQ](https://nexcmp.com/ko/docs/troubleshooting/faq.md): 설치, 라이선스, 인프라 연결 및 NexCMP 운영에 관해 자주 묻는 질문.
- [지원](https://nexcmp.com/ko/docs/troubleshooting/support.md): NexCMP 지원을 받는 방법: 수집해야 할 정보, 메시지에 포함해야 할 내용 및 전송할 곳.

## Optional

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