---
title: 모듈
description: 기본 상태, 추가 기능, 필요한 인프라 및 활성화 위치를 포함하여 시작 시 읽어들이는 애드온 모듈을 포함한 모든 NexCMP 모듈입니다.
url: https://nexcmp.com/ko/docs/infrastructure/modules/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 모듈 {#modules}

> **관리자 위치:** System › Admin › License & updates (`/license`), **Module** 카드.

## 작동 내용 {#what-it-does}

모듈은 전체 기능을 켜거나 끌 수 있는 서비스 또는 기능입니다. **꺼진** 모듈은 관리자 메뉴에서 숨겨지며 고객이 구매할 수 없고, 애드온인 경우 API 라우트가 `404 module_disabled`을 반환합니다. 모듈을 켜면 기능만 노출되므로 그 뒤의 인프라는 여전히 연결되어 있어야 합니다(마지막 열 참조).

## 요구 사항 {#requirements}

| 항목 | 요구 사항 |
|---|---|
| 계정 | 쓰기 권한이 있는 관리자. 읽기 전용 직원은 스위치를 볼 수 있지만 변경할 수는 없습니다. |
| 인프라 | 표 참조: 각 모듈에 필요한 항목이 나열되어 있습니다. |
| 종속성 | 일부 모듈은 다른 모듈이 필요합니다 (예: DDoS Shield는 DDoS & BGP 필요). |

## 인프라 준비 {#prepare-the-infrastructure}

스위치 자체에는 필요하지 않습니다. 표에 링크된 페이지에 설명된 대로 각 모듈의 인프라를 연결하세요.

## NexCMP에서 연결 {#connect-in-nexcmp}

1. **System › Admin › License & updates**를 열고 **Module** 카드로 스크롤합니다. 비활성화된 모듈은 관리자 메뉴에서 숨겨지며 고객이 구매할 수 없다고 표시됩니다.
2. 모듈의 스위치를 사용합니다. 페이지가 **Saved: reloading menu**를 확인하고 새로 고쳐져 메뉴가 즉시 변경됩니다.

![각 모듈의 스위치가 있는 License & updates의 Module 카드](https://nexcmp.com/ko/docs/images/infrastructure/modules-01-license-modules.webp)

### 모듈 목록 {#the-modules}

| 모듈 (표시된 이름) | Default | 추가되는 기능 | 필요 사항 | 페이지 |
|---|---|---|---|---|
| **Virtual Machines** | 항상 켜짐 | VM 카탈로그, 주문, 콘솔, 스냅샷 | CloudStack 또는 Proxmox VE | [CloudStack](https://nexcmp.com/ko/docs/infrastructure/cloudstack/), [Proxmox VE](https://nexcmp.com/ko/docs/infrastructure/proxmox/) |
| **Bandwidth** | **켜짐** | VM, Kubernetes, S3용 할당량, 애드온, 알림 및 초과 사용 조치 | 추가 항목 없음 (CloudStack VM 통계) | [Bandwidth](https://nexcmp.com/ko/docs/catalog/bandwidth/) |
| **OS & ISO Images** | off | 고객이 자체 OS 이미지 및 ISO를 등록하고 GB 단위로 과금됨 | CloudStack; 보조 스토리지 VM용 인터넷 액세스 | [Requirements](https://nexcmp.com/ko/docs/infrastructure/requirements/) |
| **Kubernetes** | off | Kubernetes 클러스터 (CKS) | CKS가 활성화된 CloudStack | [Kubernetes 및 프라이빗 클라우드](https://nexcmp.com/ko/docs/infrastructure/kubernetes-and-private-cloud/) |
| **Private Cloud** | off | 전용 대역폭 플랜이 포함된 VPC | CloudStack VPC 및 네트워크 오퍼링 | [Kubernetes 및 프라이빗 클라우드](https://nexcmp.com/ko/docs/infrastructure/kubernetes-and-private-cloud/) |
| **Object Storage** | off | Ceph RGW 기반 S3 계정, 종량제 | Ceph RGW 및 S3 서비스가 포함된 존 | [S3](https://nexcmp.com/ko/docs/infrastructure/s3/) |
| **VPN** | off | 자체 노드에서의 VPN | `cmp-agent`을(를) 실행 중인 노드 | [VPN 및 프록시 노드](https://nexcmp.com/ko/docs/infrastructure/vpn-proxy-nodes/) |
| **IPv6 Proxy** | off | 자체 노드에서의 IPv6 프록시 | IPv6 프리픽스가 있는 프록시 노드 | [VPN 및 프록시 노드](https://nexcmp.com/ko/docs/infrastructure/vpn-proxy-nodes/) |
| **Bare Metal** | off | iDRAC을 통한 Dell 서버: 주문, OS 설치, 콘솔, 전원 | 관리 네트워크의 iDRAC 9 | [Dedicated servers](https://nexcmp.com/ko/docs/infrastructure/dedicated/) |
| **AI Models** | off | AI 모델에 대한 액세스를 판매하는 게이트웨이: 단일 키로 다중 모델 지원, 모델별 요금, 사용량 한도, 로그, 지갑 결제 | 직접 준비하는 모델 소스: 자체 키를 사용하는 OpenAI 호환 또는 Anthropic 호환 API | [AI Models](https://nexcmp.com/ko/docs/infrastructure/ai-models/) |
| **AI** | off | AI Chat(자동 지원) 및 AI Agent(자연어로 VM 관리) | OpenAI 호환 제공자 | [AI providers](https://nexcmp.com/ko/docs/ai/ai-providers/) |
| **DDoS Shield** | off | 고객을 위한 IP 보호; DDoS 및 BGP가 필요하므로 없으면 스위치가 비활성화 상태로 유지됨 | DDoS & BGP 애드온 | 아래 참조 |
| **DDoS & BGP** | 꺼짐, **추가 기능** | 엣지 라우터 콘솔: BGP, RTBH, XDP, 세션 및 엣지 트래픽 | 루트 데몬이 실행 중인 엣지 호스트 | 아래 참조 |

### 스위치별 역할 {#which-switch-does-what}

- **Bare Metal**은 두 개의 레이어로 구성됩니다. 모듈 스위치는 관리자 메뉴와 API를 표시합니다. 고객 대상 판매는 **Services › Dedicated Server**에서 직접 텍스트를 입력하여 확인하는 별도의 스위치로 관리되며, **Infrastructure › Bare Metal › Safety**에서 **live ops**를 켤 때까지 iDRAC에 대한 모든 쓰기 작업이 차단됩니다. [Dedicated servers](https://nexcmp.com/ko/docs/infrastructure/dedicated/) 항목을 참조하십시오.
- **Kubernetes**, **Private Cloud**, **VPN**, **IPv6 Proxy** 및 **Images**의 경우 모듈 스위치와 서비스 페이지의 판매 스위치가 동일한 설정으로 작동합니다.
- **AI**은(는) **System › Settings › AI provider**에 구성된 제공자도 필요합니다.
- **AI Models**은 2단계로 구성됩니다. 모듈 스위치는 관리자 메뉴와 API를 표시합니다. 고객 대상 판매는 AI Models 페이지 상단의 별도 판매 스위치로 관리되며, 기본값은 비활성화 상태입니다. [AI Models](https://nexcmp.com/ko/docs/infrastructure/ai-models/)을 참고하십시오.

### 시작 시 읽어오는 모듈 {#modules-read-at-start-up}

세 가지 기능은 일반적인 스위치가 아닙니다. **서비스가 시작될 때 한 번** 읽히며 표준 설치에 포함되지 않는 인프라가 필요합니다.

| 기능 | 설정 | 상태 | 필요한 항목 |
|---|---|---|---|
| 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`.

## 확인 {#verify}

1. 다시 로드한 후 모듈의 메뉴 항목이 표시되거나 사라집니다.
2. 고객용 모듈의 경우, 로그인한 고객에게 포털의 새로운 메뉴 항목이 표시됩니다. 꺼져 있는 모듈은 아무것도 표시하지 않거나 "coming soon"을 표시합니다.

## 제한 사항 및 참고 사항 {#limits-and-notes}

- 모듈을 끈다고 해서 데이터가 삭제되지는 않습니다. 실행 중인 VM, 클러스터, S3 계정 및 구독은 계속 실행되고 과금되며, 고객이 새로 생성만 할 수 없게 됩니다.
- 할당량 페이지에는 모듈이 켜져 있는 서비스만 나열됩니다.

## Troubleshooting {#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`. |
| 읽기 전용 직원은 저장할 수 없음 | 역할이 읽기 전용임 | 관리자 계정을 사용하세요. |