모듈
관리자 위치: System › Admin › License & updates (
/license), Module 카드.
작동 내용
모듈은 전체 기능을 켜거나 끌 수 있는 서비스 또는 기능입니다. 꺼진 모듈은 관리자 메뉴에서 숨겨지며 고객이 구매할 수 없고, 애드온인 경우 API 라우트가 404 module_disabled을 반환합니다. 모듈을 켜면 기능만 노출되므로 그 뒤의 인프라는 여전히 연결되어 있어야 합니다(마지막 열 참조).
요구 사항
| 항목 | 요구 사항 |
|---|---|
| 계정 | 쓰기 권한이 있는 관리자. 읽기 전용 직원은 스위치를 볼 수 있지만 변경할 수는 없습니다. |
| 인프라 | 표 참조: 각 모듈에 필요한 항목이 나열되어 있습니다. |
| 종속성 | 일부 모듈은 다른 모듈이 필요합니다 (예: DDoS Shield는 DDoS & BGP 필요). |
인프라 준비
스위치 자체에는 필요하지 않습니다. 표에 링크된 페이지에 설명된 대로 각 모듈의 인프라를 연결하세요.
NexCMP에서 연결
- System › Admin › License & updates를 열고 Module 카드로 스크롤합니다. 비활성화된 모듈은 관리자 메뉴에서 숨겨지며 고객이 구매할 수 없다고 표시됩니다.
- 모듈의 스위치를 사용합니다. 페이지가 Saved: reloading menu를 확인하고 새로 고쳐져 메뉴가 즉시 변경됩니다.

모듈 목록
| 모듈 (표시된 이름) | Default | 추가되는 기능 | 필요 사항 | 페이지 |
|---|---|---|---|---|
| Virtual Machines | 항상 켜짐 | VM 카탈로그, 주문, 콘솔, 스냅샷 | CloudStack 또는 Proxmox VE | CloudStack, Proxmox VE |
| Bandwidth | 켜짐 | VM, Kubernetes, S3용 할당량, 애드온, 알림 및 초과 사용 조치 | 추가 항목 없음 (CloudStack VM 통계) | Bandwidth |
| OS & ISO Images | off | 고객이 자체 OS 이미지 및 ISO를 등록하고 GB 단위로 과금됨 | CloudStack; 보조 스토리지 VM용 인터넷 액세스 | Requirements |
| Kubernetes | off | Kubernetes 클러스터 (CKS) | CKS가 활성화된 CloudStack | Kubernetes 및 프라이빗 클라우드 |
| Private Cloud | off | 전용 대역폭 플랜이 포함된 VPC | CloudStack VPC 및 네트워크 오퍼링 | Kubernetes 및 프라이빗 클라우드 |
| Object Storage | off | Ceph RGW 기반 S3 계정, 종량제 | Ceph RGW 및 S3 서비스가 포함된 존 | S3 |
| VPN | off | 자체 노드에서의 VPN | cmp-agent을(를) 실행 중인 노드 | VPN 및 프록시 노드 |
| IPv6 Proxy | off | 자체 노드에서의 IPv6 프록시 | IPv6 프리픽스가 있는 프록시 노드 | VPN 및 프록시 노드 |
| Bare Metal | off | iDRAC을 통한 Dell 서버: 주문, OS 설치, 콘솔, 전원 | 관리 네트워크의 iDRAC 9 | Dedicated servers |
| AI Models | off | AI 모델에 대한 액세스를 판매하는 게이트웨이: 단일 키로 다중 모델 지원, 모델별 요금, 사용량 한도, 로그, 지갑 결제 | 직접 준비하는 모델 소스: 자체 키를 사용하는 OpenAI 호환 또는 Anthropic 호환 API | AI Models |
| AI | off | AI Chat(자동 지원) 및 AI Agent(자연어로 VM 관리) | OpenAI 호환 제공자 | AI providers |
| DDoS Shield | off | 고객을 위한 IP 보호; DDoS 및 BGP가 필요하므로 없으면 스위치가 비활성화 상태로 유지됨 | DDoS & BGP 애드온 | 아래 참조 |
| DDoS & BGP | 꺼짐, 추가 기능 | 엣지 라우터 콘솔: BGP, RTBH, XDP, 세션 및 엣지 트래픽 | 루트 데몬이 실행 중인 엣지 호스트 | 아래 참조 |
스위치별 역할
- Bare Metal은 두 개의 레이어로 구성됩니다. 모듈 스위치는 관리자 메뉴와 API를 표시합니다. 고객 대상 판매는 Services › Dedicated Server에서 직접 텍스트를 입력하여 확인하는 별도의 스위치로 관리되며, Infrastructure › Bare Metal › Safety에서 live ops를 켤 때까지 iDRAC에 대한 모든 쓰기 작업이 차단됩니다. Dedicated servers 항목을 참조하십시오.
- Kubernetes, Private Cloud, VPN, IPv6 Proxy 및 Images의 경우 모듈 스위치와 서비스 페이지의 판매 스위치가 동일한 설정으로 작동합니다.
- AI은(는) System › Settings › AI provider에 구성된 제공자도 필요합니다.
- AI Models은 2단계로 구성됩니다. 모듈 스위치는 관리자 메뉴와 API를 표시합니다. 고객 대상 판매는 AI Models 페이지 상단의 별도 판매 스위치로 관리되며, 기본값은 비활성화 상태입니다. AI Models을 참고하십시오.
시작 시 읽어오는 모듈
세 가지 기능은 일반적인 스위치가 아닙니다. 서비스가 시작될 때 한 번 읽히며 표준 설치에 포함되지 않는 인프라가 필요합니다.
| 기능 | 설정 | 상태 | 필요한 항목 |
|---|---|---|---|
| DDoS & BGP | module_ddos | 꺼져 있을 때는 Add-on package, 켜져 있을 때는 Installed(으)로 표시됩니다. 콘솔에 스위치가 없습니다. | 루트로 실행되는 엣지 라우터 데몬(BGP, RTBH, XDP, 플로우 통계). 패널은 권한이 없는 사용자로 실행되므로 이를 실행할 수 없습니다. |
| AI | module_ai | 일반적인 스위치입니다. 라우팅이 즉시 반영됩니다. AI Chat의 백업 작업(티켓 조사, 예약된 응답)은 서비스가 다음번에 다시 시작될 때 시작됩니다. 콘솔에 재시작을 권장한다는 메시지가 표시됩니다. | AI 제공자. |
| Web SSH terminal | feature_ssh_web | 기본적으로 꺼져 있으며 콘솔에 스위치 없음 | 별도의 SSH 프록시 서비스 및 해당 라우팅. 이 기능이 없으면 포털의 Console 탭에 VNC 페이지만 표시됩니다. AI Agent does not need it: 패널이 자체적으로 만드는 SSH 연결을 통해 명령을 실행합니다. |
시작 설정을 변경한 후 서비스를 재시작하세요: sudo systemctl restart nexcmp nexcmp-vmd.
확인
- 다시 로드한 후 모듈의 메뉴 항목이 표시되거나 사라집니다.
- 고객용 모듈의 경우, 로그인한 고객에게 포털의 새로운 메뉴 항목이 표시됩니다. 꺼져 있는 모듈은 아무것도 표시하지 않거나 "coming soon"을 표시합니다.
제한 사항 및 참고 사항
- 모듈을 끈다고 해서 데이터가 삭제되지는 않습니다. 실행 중인 VM, 클러스터, S3 계정 및 구독은 계속 실행되고 과금되며, 고객이 새로 생성만 할 수 없게 됩니다.
- 할당량 페이지에는 모듈이 켜져 있는 서비스만 나열됩니다.
Troubleshooting
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 메뉴 항목이 표시되지 않음 | 페이지가 다시 로드되지 않음 | 관리자 콘솔을 새로고침하세요. |
| DDoS Shield 스위치가 비활성화되어 있음 | DDoS & BGP가 설치되지 않음 | DDoS Shield에는 DDoS & BGP 애드온이 필요합니다. |
| "This module is an add-on package and cannot be switched here" (HTTP 409 또는 422) | 사용자(또는 스크립트)가 DDoS & BGP 전환을 시도함 | 애드온 패키지이므로 스위치가 없습니다. |
| "DDoS 실드에는 DDoS & BGP 애드온이 필요합니다" | Same, for DDoS Shield | 애드온을 먼저 설치하세요. |
모듈 라우트가 404를 반환함 module_disabled | 모듈이 꺼져 있음 | 모듈을 켜세요. |
| AI Chat은 응답하지만 티켓 조사가 시작되지 않음 | 재시작 없이 AI 모듈이 켜졌음 | sudo systemctl restart nexcmp nexcmp-vmd. |
| 읽기 전용 직원은 저장할 수 없음 | 역할이 읽기 전용임 | 관리자 계정을 사용하세요. |