---
title: 버그 신고
description: 관리자 콘솔에서 NexCMP 팀으로 버그 보고서를 티켓 형태로 직접 전송하세요. 양식, 전송/제외 항목, 제한 사항 및 오류 해결 방법을 안내합니다.
url: https://nexcmp.com/ko/docs/administration/report-a-bug/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 버그 신고 {#report-a-bug}

> **관리자 콘솔 위치:** Top bar › **Report a bug** (Docs 옆, 최고 관리자에게만 표시됨).

NexCMP의 결함을 발견하셨나요? **Report a bug**를 누르고 문제를 설명한 후 전송하세요. 별도로 다른 곳에 로그인하거나 로그 파일을 직접 복사할 필요 없이, 보고서가 라이선스 계정의 티켓으로 NexCMP 팀에 한 번에 접수됩니다. 모든 플랜에서 이용할 수 있으며, NexCMP Free와 NexCMP Source 모두 버그 수정을 지원합니다.

::: info 버그 신고는 기술 지원 요청이 아닙니다
NexCMP Free에는 기술 지원이 제공되지 않으므로, 이 양식은 소프트웨어 결함 신고에만 사용해 주십시오. 초기 설정 지원 및 마이그레이션은 [NexCMP Source](https://nexcmp.com/pricing)에서 제공됩니다.
:::

## 요구 사항 {#requirements}

| 항목 | 필요 사항 |
|---|---|
| 버전 | NexCMP 1.5.2 이상 |
| 전송 가능 대상 | 최고 관리자 계정. 직원 계정(읽기 전용), 리셀러 콘솔, 고객 및 읽기 전용 데모에서는 전송할 수 없음 |
| 라이선스 | 정지되지 않은 활성 라이선스(Free 또는 Source) |
| 네트워크 | 서버가 HTTPS를 통해 `https://nexcmp.com`에 연결할 수 있어야 함(라이선스 확인 및 업데이트에 사용되는 주소와 동일) |

## 보고서 전송 {#send-a-report}

1. 상단 바에서 **Report a bug**를 클릭합니다. 모바일에서는 메뉴를 열고 **Report a bug**를 선택합니다.
2. **Subject**에 간단한 제목을 입력합니다.
3. **What happened**에 수행한 작업, 발생한 현상 및 예상한 결과를 설명합니다.
4. 선택 사항으로 **재현 단계**를 작성합니다.
5. **Impact**를 선택합니다: **Blocking**(작업 불가), **Major**(주요 기능 작동 불능) 또는 **Minor**(경미하거나 외관상의 문제).
6. **Attach diagnostics**를 켠 상태로 유지하고(권장) **What will be sent** 상자의 내용을 확인합니다.
7. **Send report**를 클릭합니다.

1.6.1에서는 모바일 환경을 포함하여 작업 버튼이 표시된 상태로 양식 본문이 스크롤됩니다. `password:` 또는 `password=` 뒤의 비밀번호 값은 보고서의 나머지 내용을 삭제하지 않고 마스킹 처리됩니다. 전송하기 전에 작성한 내용을 검토하고 고객 데이터 및 자격 증명을 제외하십시오.

![제목, 설명, 영향도 및 전송 대상 목록이 표시된 Report a bug 대화상자](https://nexcmp.com/ko/docs/images/administration/report-a-bug-01-dialog.webp)

보고서가 접수되면 대화상자에 티켓 번호와 링크가 표시됩니다. 팀의 답변은 nexcmp.com 라이선스 계정의 이메일 주소로 발송되며, 해당 사이트에 라이선스 소유자로 로그인하면 **Support** 아래에도 티켓이 표시됩니다.

## 전송되는 항목 {#what-is-sent}

**What will be sent** 상자에는 전송을 클릭하기 전에 다음 내용이 정확히 표시됩니다:

| 전송 항목 | 상세 정보 |
|---|---|
| 입력 텍스트 | 제목, 설명, 재현 단계 및 영향도 |
| 버전, 플랜, 도메인 | NexCMP 버전, Free 또는 Source 플랜, 설치 도메인 |
| 현재 페이지 | 현재 위치한 관리자 페이지(`?` 또는 `#` 뒤의 내용은 제외) |
| 브라우저 | 브라우저의 User-Agent 텍스트(이름, 버전 및 운영체제, 최대 200자로 제한) |
| 최근 오류 | 현재 브라우저 탭의 최근 오류 최대 5개. 스크립트 오류는 메시지만 전송되며, 실패한 요청은 메서드, 경로, 상태 코드만 전송됨 |

**Attach diagnostics**를 끌 수 있으며, 이 경우 직접 입력한 텍스트와 버전, 플랜, 도메인만 전송됩니다.

## 전송되지 않는 항목 {#what-is-never-sent}

- 비밀번호, 토큰, 쿠키 및 API 키. 입력 텍스트나 오류 메시지에서 이러한 형태를 띠는 모든 항목은 전송되기 전 서버에서 마스킹(`***` 또는 `[redacted]`로 표시) 처리됩니다.
- 요청 및 응답의 본문 — 실패한 요청은 메서드, 경로, 상태만 기록됩니다.
- 고객 데이터(이름, 이메일, 주문, 청구서) 및 고객의 IP 주소.
- 사용자의 브라우저 IP 주소 및 서버의 파일. 모든 라이선스 확인과 마찬가지로 라이선스 서버에는 서버가 접속하는 IP 주소만 표시됩니다.

티켓은 서버가 이미 보유한 라이선스 토큰을 통해 설치 환경과 연결되므로, 버전, 도메인, 설치 환경 정보는 서버에 의해 설정되며 브라우저에서 변경할 수 없습니다.

## 제한 {#limits}

| 제한 | 값 |
|---|---|
| 제목 | 150자 |
| 설명 및 재현 단계 | 합산 8 KB |
| Reports | 설치 환경 전체 기준 시간당 5건, 일일 20건 |

동일한 리포트를 두 번 전송해도(예: 네트워크 오류 발생 후) 티켓이 중복 생성되지 않습니다.

## Troubleshooting {#troubleshooting}

| 메시지 | 원인 | 해결 방법 |
|---|---|---|
| 라이선스를 먼저 활성화하십시오 | 설치 환경에 활성화된 라이선스가 없음 | **License & updates**를 열고 활성화한 후 다시 전송하십시오 |
| 라이선스 서버에 연결할 수 없습니다 | 서버가 `nexcmp.com`에 연결할 수 없음 | 서버의 아웃바운드 HTTPS 및 DNS를 확인한 다음 **Send report**를 다시 누르십시오(입력한 내용은 유지됩니다) |
| 이 설치 환경에서 버그 보고가 너무 많이 전송되었습니다 | 시간당 5건 또는 일일 20건 한도에 도달함 | 잠시 기다린 후 다시 시도하거나, 이미 열려 있는 티켓에 새로운 확인 내용을 추가하십시오 |
| 이 라이선스는 정지되었습니다 | 라이선스가 정지되었거나 환불됨 | [License and purchase](https://nexcmp.com/ko/docs/getting-started/license-and-purchase/)를 참조하십시오 |
| 이 설치가 철회되었습니다 | 라이선스 포털에서 설치 환경이 취소됨 | **License & updates**에서 다시 활성화하십시오 |
| 라이선스 토큰을 갱신할 수 없습니다 | 서버에서 라이선스 토큰을 갱신할 수 없음 | **License & updates**를 열고 **Refresh**를 누른 다음 다시 전송하십시오 |
| Report a bug 버튼이 없음 | 직원, 리셀러, 고객 계정으로 로그인되어 있거나 읽기 전용 데모 환경임 | 기본 관리자 계정으로 로그인하십시오 |

::: tip AI 어시스턴트 및 API 키 안내
관리자 콘솔의 어시스턴트와 관리자 API 키는 사용자를 대신해 버그 리포트를 전송할 수 없습니다. 해당 버튼을 사용하려면 기본 관리자로 로그인한 실제 사용자여야 합니다.
:::