---
title: 설정 마법사
description: /setup에서 설정 코드, 라이선스, CloudStack 또는 Connect later, 관리자 및 브랜드를 단계별로 구성하는 초기 마법사를 진행합니다.
url: https://nexcmp.com/ko/docs/getting-started/setup-wizard/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 설정 마법사 {#setup-wizard}

> **어드민 위치:** 마법사는 첫 번째 관리자가 생성될 때까지만 `/setup`에 독립 페이지로 표시됩니다. 이후에는 System › Admin › Start(`/setup`)에서 동일한 점검 항목을 확인할 수 있습니다.

마법사는 네 단계의 간단한 과정을 통해 새로 설치된 시스템을 바로 사용 가능한 패널로 완성합니다. 3000 포트(`http://<server-IP>:3000/setup`) 또는 TLS가 이미 활성화된 경우 `https://<domain>/setup`에서 제공됩니다.

::: warning 3단계 이후 마법사가 사라집니다
관리자가 생성되면 마법사가 닫히고 설정 코드가 삭제됩니다. 이후 패널에 접속하려면 관리자 콘솔을 사용하십시오.
:::

## Step 0 — 설정 코드 {#step-0-—-setup-code}

설치 프로그램 완료 시 **일회성 설정 코드**가 출력됩니다. 다음 명령으로 다시 확인할 수 있습니다:

```bash
sudo nexcmp status
```

이를 **Setup code**에 붙여넣고 **Continue**을 클릭합니다. 이 코드는 마법사를 보호하기 위한 장치로, 열린 포트를 찾더라도 이 코드가 없으면 관리자를 생성할 수 없습니다.

![일회성 설정 코드를 입력하는 설정 마법사의 Step 0](https://nexcmp.com/ko/docs/images/getting-started/setup-wizard-00-code.webp)

## Step 1 — 라이선스 {#step-1-—-license}

| 필드 | 값 |
|---|---|
| 라이선스 키 | `NXC-XXXXX-XXXXX-XXXXX-XXXXX` — 설치 프로그램에 의해 미리 활성화되므로 이 단계에서는 일반적으로 "Activated for cloud.example.com"이 표시됩니다. |
| 메인 도메인 | 라이선스에 등록된 도메인 |

설치 프로그램이 이미 라이선스를 활성화한 경우, 마법사가 이를 인식하고 다음 단계로 진행합니다. 그렇지 않은 경우 키와 도메인을 입력하고 **Activate**를 클릭하세요. 오류는 빨간색으로 표시됩니다. [Installation errors](https://nexcmp.com/ko/docs/troubleshooting/installation-errors/)를 참조하세요.

![주요 도메인에 대해 라이선스가 이미 활성화된 상태로 표시되는 설정 마법사 1단계](https://nexcmp.com/ko/docs/images/getting-started/setup-wizard-01-license.webp)

## Step 2 — CloudStack (or Connect later) {#step-2-—-cloudstack-or-connect-later}

두 가지 선택지가 있습니다:

- **지금 연결.** CloudStack **API URL** (`https://cloudstack.example.com/client/api`), **API key** 및 **Secret key**를 입력하고 **Test connection**을 클릭한 다음 **Zone**, **Guest network for customer VMs**, **Zone display name**, 그리고 두 자리 **Country**를 선택합니다. **Save CloudStack**을 클릭하세요.
- **나중에 연결.** **Connect later**를 클릭하세요. 다른 기능은 모두 정상 작동하며, CloudStack이나 Proxmox VE는 나중에 Infrastructure 메뉴에서 연결할 수 있습니다. 그때까지는 상태 패널에 연결된 소스가 없다는 알림이 표시됩니다.

![CloudStack API URL, API key 및 secret key 필드에 예시 값이 입력된 마법사 2단계](https://nexcmp.com/ko/docs/images/getting-started/setup-wizard-02-cloudstack-form.webp)

::: important 전용 CloudStack 계정 사용
ROOT 관리자 키를 사용하지 마세요. NexCMP를 위한 전용 도메인과 계정을 생성하고 해당 API 키를 사용하세요. [CloudStack](https://nexcmp.com/ko/docs/infrastructure/cloudstack/#create-a-dedicated-account-and-api-key)을 참조하세요. 마법사는 선택한 네트워크가 해당 키의 존 및 계정에 속하는지 확인합니다.
:::

![Test connection 이후: 존 및 게스트 네트워크 목록, 존 표시 이름 및 국가 필드](https://nexcmp.com/ko/docs/images/getting-started/setup-wizard-02b-cloudstack-picked.webp)

**Proxmox VE**만 사용할 계획인 경우 **Connect later**를 선택하고 [Proxmox VE](https://nexcmp.com/ko/docs/infrastructure/proxmox/) 안내를 따르세요.

## Step 3 — 관리자 및 브랜드 {#step-3-—-administrator-and-brand}

| 필드 | 규칙 |
|---|---|
| 관리자 이메일 (로그인) | 유효한 이메일 주소입니다. 이것이 관리자 사용자 이름이 됩니다. |
| 비밀번호 | 문자와 숫자를 포함하여 12자 이상이어야 합니다. |
| 브랜드 이름 | 고객에게 표시되는 이름입니다 (기본값 "Cloud"). 최대 60자까지 가능합니다. |
| 지원 이메일 | 기본값은 관리자 이메일입니다. |

![관리자 이메일, 비밀번호, 브랜드 이름 및 지원 이메일이 입력된 마법사 3단계](https://nexcmp.com/ko/docs/images/getting-started/setup-wizard-03-admin.webp)

**Finish setup**을 클릭하세요. 패널이 재시작되고 (약 1~2초 소요) 페이지가 `https://<domain>/admin/`의 관리자 로그인 페이지로 이동합니다. 해당 주소가 아직 응답하지 않는 경우 (DNS 또는 TLS 대기 중), 대신 현재 주소의 `/`로 이동합니다.

![패널이 재시작 중이라는 메시지와 함께 완료된 마법사 화면](https://nexcmp.com/ko/docs/images/getting-started/setup-wizard-03-done.webp)

## 마법사가 설정하는 항목 {#what-the-wizard-sets-up-for-you}

- 브랜드 이름, 사이트 URL (`https://<domain>`), 관리자 URL (`https://<domain>/admin`), 콘솔 URL (`https://<domain>/console`), 지원 이메일 및 발신자 이름.
- NexCMP에 기본 포함된 모듈의 기본 설정: DDoS & BGP, AI, 웹 SSH는 **꺼짐**, 대역폭 측정은 **켜짐** 상태입니다. [Modules](https://nexcmp.com/ko/docs/infrastructure/modules/)를 참조하세요.
- CloudStack을 연결한 경우: 공급자 #1, 첫 번째 존, 게스트 네트워크, 그리고 고객 지원을 위해 고객 VM에 연결되는 운영 키 쌍.

다음: [First login](https://nexcmp.com/ko/docs/getting-started/first-login/).