---
title: NexCMP 설치
description: 한 줄 설치 프로그램으로 Ubuntu에 NexCMP를 설치하세요. 매개변수, 설치 프로그램의 동작, TLS 및 nginx, 그리고 설정 마법사에 접속하는 방법을 안내합니다.
url: https://nexcmp.com/ko/docs/getting-started/installation/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# NexCMP 설치 {#install-nexcmp}

설치 프로그램은 라이선스 서버에서 제공하는 단일 스크립트입니다. 머신을 확인하고, 라이선스를 활성화하며, 프로그램을 다운로드 및 검증하고, 서비스를 설치하며, (선택 사항으로) Let's Encrypt 인증서와 함께 nginx를 설정합니다.

## 시작하기 전에 {#before-you-start}

- [requirements](https://nexcmp.com/ko/docs/getting-started/requirements/)을(를) 충족하는 서버와 루트(root) 권한.
- [license page](https://nexcmp.com/licenses)의 **라이선스 키** 및 **메인 도메인** — [License and purchase](https://nexcmp.com/ko/docs/getting-started/license-and-purchase/) 참조.
- 도메인의 DNS 레코드 — [DNS and Cloudflare](https://nexcmp.com/ko/docs/getting-started/dns-and-cloudflare/) 참조. 먼저 설치하고 나중에 DNS를 수정해도 됩니다. 설치 프로그램이 누락된 항목을 알려주므로 단순히 다시 실행하면 됩니다.

## 설치 {#install}

1. 서버에 로그인한 후 루트 권한을 획득합니다(또는 `sudo`을(를) 앞에 붙입니다).
2. 라이선스 페이지의 명령어를 실행합니다. 형태는 다음과 같습니다:

```bash
curl -fsSL https://nexcmp.com/install.sh | sudo bash -s -- \
  --license NXC-XXXXX-XXXXX-XXXXX-XXXXX \
  --domain cloud.example.com \
  --email admin@example.com
```

3. 체크 마크가 나타날 때까지 기다립니다. 새 설치는 몇 분 정도 걸리며, 첫 시작 시 데이터베이스 스키마를 생성하므로 느린 디스크에서는 최대 1분이 소요될 수 있습니다.
4. 마지막 요약을 읽어보세요. 포털 및 관리자 URL, **설정 코드**, 그리고 다음 단계가 출력됩니다.

![포털 URL, 관리자 URL 및 일회용 설정 코드로 완료되는 설치 프로그램](https://nexcmp.com/ko/docs/images/getting-started/installation-01-finish.webp)

## 매개변수 {#parameters}

| Parameter | Default | 의미 |
|---|---|---|
| `--license KEY` | 최초 설치 시 필수 | 라이선스 키입니다. |
| `--domain NAME` | 최초 설치 시 필수 | 메인 도메인입니다. 라이선스와 일치해야 합니다. `https://` 및 후행 경로는 제거됩니다. |
| `--email ADDRESS` | none | Let's Encrypt 만료 알림을 위한 담당자 이메일입니다. 이메일이 없으면 인증서가 이메일 없이 등록됩니다. |
| `--port N` | `3000` | 패널의 로컬 포트 (1–65535). |
| `--no-nginx` | off | nginx / TLS를 설치하거나 설정하지 않습니다. 자체 리버스 프록시를 운영하거나 NexCMP를 먼저 살펴보고 싶을 때 사용하세요. |
| `--behind-cloudflare` | auto-detected | "도메인이 Cloudflare를 통해 프록시됨" 모드를 강제로 활성화합니다. 일반적으로 DNS에서 감지됩니다. |
| `--channel NAME` | `stable` | 릴리스 채널. |

**매개변수 없이** 설치 프로그램을 다시 실행하면 저장된 설정(`/etc/nexcmp/install.conf`)이 재사용되며, 데이터, 설정 및 계정을 유지한 채 안전하게 업그레이드됩니다. 이것이 바로 `sudo nexcmp update`이(가) 수행하는 작업입니다.

## 설치 프로그램의 동작 {#what-the-installer-does}

1. **머신 확인** — Ubuntu 22.04/24.04, x86_64, 최소 2 GB RAM, 8 GB 여유 디스크.
2. **필요한 패키지를 설치합니다** (`curl`, `zstd`, `openssl`, `python3`, `openssh-client` 등).
3. **서비스 사용자** `nexcmp` 및 디렉터리를 생성합니다: `/opt/nexcmp` (프로그램용, root 소유, 서비스는 읽기 전용), `/etc/nexcmp` (설정), `/var/lib/nexcmp` (데이터), `/var/log/nexcmp`.
4. 도메인에 대한 **라이선스를 활성화**하고 이 머신에 대한 고정 인스턴스 ID를 저장합니다.
5. **사용 권한이 있는 최신 릴리스를 다운로드**한 다음 SHA-256 및 Ed25519 서명을 검증합니다. 유효한 서명이 없는 릴리스는 거부됩니다. 실행 중인 최신 버전을 이전 버전으로 다운그레이드하지 않습니다.
6. **설정 및 systemd 유닛을 작성하고** (`nexcmp`, `nexcmp-vmd`, `nexcmp-update`) 서비스를 시작합니다. `/healthz`의 응답을 대기합니다.
7. **nginx 및 TLS를 설정합니다** (`--no-nginx`인 경우 제외): certbot(webroot 챌린지)을 사용하여 도메인 및 해당 이름도 확인될 때 `admin.<domain>` / `partner.<domain>`에 대한 Let's Encrypt 인증서를 발급받습니다. DNS가 아직 이 서버(또는 Cloudflare)를 가리키지 않는 경우 이 단계를 건너뛰고 그 사실을 알립니다.
8. URL 및 (관리자가 아직 없는 경우) **설정 코드**가 포함된 **요약 정보를 출력합니다**.

## 패널 포트 (3000) {#the-panel-port-3000}

- 최초 설치 시 패널은 `0.0.0.0:3000`에서 수신 대기하므로 `http://<server-IP>:3000/setup`에서 설정 마법사를 열 수 있습니다.
- 마법사가 완료되고 **또한** TLS가 활성화되면 패널은 `127.0.0.1`에서만 수신 대기하며, nginx가 `https://<domain>`을 그곳으로 프록시합니다.
- 비상 시(nginx 손상, DNS 오류) 제한된 시간 동안 포트를 열 수 있습니다: `sudo nexcmp open-port 30` (30분 후 자동 닫힘) — 또는 SSH 터널을 사용합니다: `ssh -L 3000:127.0.0.1:3000 <server>` 및 `http://127.0.0.1:3000/` 브라우징.

::: warning 일반 HTTP
포트 3000은 일반 HTTP입니다. 신뢰할 수 있는 네트워크의 설정 마법사 용도로만 사용하거나 SSH 터널을 통해 사용하십시오. 열어둔 채로 두지 마십시오.
:::

## 공인 도메인 없이 설치하기 (랩 또는 테스트) {#installing-without-a-public-domain-lab-or-test}

아직 DNS가 없는 머신에 설치할 수 있습니다:

```bash
curl -fsSL https://nexcmp.com/install.sh | sudo bash -s -- \
  --license NXC-XXXXX-XXXXX-XXXXX-XXXXX --domain lab.example.com --no-nginx
```

그런 다음 SSH 터널(`ssh -L 3000:127.0.0.1:3000 <server>`, `http://127.0.0.1:3000/setup` 브라우징)을 통해 마법사를 엽니다. DNS가 생성되면 `--no-nginx` 없이 설치 프로그램을 다시 실행하십시오.

## Docker 및 Kubernetes {#docker-and-kubernetes}

공식 배포된 컨테이너 이미지는 없습니다. 설치 프로그램(네이티브 systemd 설치)이 공식 지원되는 설치 방법입니다.

## 확인 {#verify}

```bash
sudo nexcmp status
```

버전, `nexcmp: active`, `nexcmp-vmd: active`, `healthz: ok` 및 마법사가 완료될 때까지는 설정 코드가 표시되어야 합니다. [setup wizard](https://nexcmp.com/ko/docs/getting-started/setup-wizard/)로 계속 진행하십시오.

문제가 발생하면 [Installation errors](https://nexcmp.com/ko/docs/troubleshooting/installation-errors/)를 참조하십시오.