---
title: nexcmp 명령어 참조
description: status, update, backup, uninstall, open-port, close-port, fix-owner 등 nexcmp 서버 커맨드 라인 도구의 모든 하위 명령어.
url: https://nexcmp.com/ko/docs/getting-started/cli-reference/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# `nexcmp` 명령어 참조 {#nexcmp-command-reference}

설치 프로그램은 `/usr/local/bin/nexcmp`에 도우미를 배치합니다. NexCMP 서버에서 실행하세요. 시스템을 변경하는 명령어에는 `sudo`이(가) 필요합니다. (API용 고객 측 도구는 별도의 프로그램입니다. [cmp CLI](https://nexcmp.com/ko/docs/developers/cmp-cli/) 참조)

| 명령어 | 루트 필요 여부 | 작동 내용 |
|---|---|---|
| `nexcmp status` | 아니요 (`sudo`을(를) 통해 자세히 확인) | 버전, 서비스 상태(`nexcmp`, `nexcmp-vmd`), `/healthz`, 라이선스 요약, 공개 포트 상태, 마법사가 완료되지 않은 경우 설정 코드 |
| `nexcmp update` | 예 | 저장된 파라미터와 함께 설치된 릴리스에 포함된 설치 프로그램을 실행합니다 — [Updating](https://nexcmp.com/ko/docs/getting-started/updating/) 참조 |
| `nexcmp backup [dir]` | 예 | `/var/backups/nexcmp`(또는 `dir`) 백업 — [Backup and restore](https://nexcmp.com/ko/docs/getting-started/backup-and-restore/) 참조 |
| `nexcmp uninstall [--purge]` | 예 | 서비스 및 프로그램 제거; `--purge`는 데이터도 함께 제거함 — [Uninstall](https://nexcmp.com/ko/docs/getting-started/uninstall/) 참조 |
| `nexcmp open-port [minutes]` | 예 | **긴급**: 1~1440분(기본값 30) 동안 모든 인터페이스의 패널 포트(기본값 3000)에서 수신 대기한 후 자동으로 닫힘 |
| `nexcmp close-port` | 예 | 지금 긴급 창 닫기 |
| `nexcmp fix-owner` | 예 | root 소유인 `/var/lib/nexcmp` 내의 파일을 `nexcmp` 사용자에게 반환 |

## `nexcmp status`

```text
Version   : 1.6.1
nexcmp     : active
nexcmp-vmd : active
healthz    : ok
License   : active · domain cloud.example.com · token valid until 2026-11-12 · updates until 2027-10-30
Public port: 127.0.0.1 only (nginx proxy; emergency: sudo nexcmp open-port)
```

데이터 디렉터리의 파일 소유권이 root로 되어 있는 경우(예: root 권한으로 다른 `nexcmp` 명령을 `sudo`(으)로 실행하여 생성된 경우), 서비스 사용자가 읽을 수 없으므로 `status`에서 경고를 출력합니다. 전형적인 증상으로 라이선스에 HTTP 421이 표시됩니다. `sudo nexcmp fix-owner`(으)로 해결하십시오. 동일한 수정 작업이 서비스가 시작될 때마다 자동으로 실행됩니다.

## 긴급 액세스 {#emergency-access}

도메인, nginx 또는 TLS에 문제가 발생한 경우에도 패널에 접속할 수 있습니다.

```bash
sudo nexcmp open-port 30          # http://<server-IP>:3000/ for 30 minutes
sudo nexcmp close-port            # close it earlier
```

더 안전하고 별도의 설정이 필요 없는 방법: `ssh -L 3000:127.0.0.1:3000 user@server` 후 `http://127.0.0.1:3000/` 브라우징.

## 환경 변수 {#environment}

| 변수 | 용도 |
|---|---|
| `NEXCMP_BASE` | 라이선스 서버 기본 URL 재정의(기본값 `https://nexcmp.com`); 테스트 전용 |

파일 및 디렉토리: 프로그램 `/opt/nexcmp`, 설정 `/etc/nexcmp`, 데이터 `/var/lib/nexcmp`, 로그 `/var/log/nexcmp` 및 `journalctl -u nexcmp -u nexcmp-vmd`.