cv4pve-diag

자체 포함 실행 파일 및 크로스플랫폼

별도 런타임 설치 없이 단일 실행 파일을 복사하여 바로 실행할 수 있습니다. Windows, Linux, macOS에서 동일한 동작을 제공합니다.

API 기반 원격 점검

루트 권한이나 SSH 접근 없이 Proxmox VE API를 통해 원격으로 진단을 수행합니다. 사용자명/비밀번호 또는 API 토큰(user@realm!token=uuid) 방식을 모두 지원합니다.

클러스터 인식 진단

한 번의 실행으로 모든 노드, VM, 컨테이너, 스토리지를 함께 분석합니다. 고가용성 환경에서는 여러 호스트를 지원하고 페일오버 상황을 함께 고려합니다.

다양한 출력 형식

Text, HTML, JSON, Markdown, Excel 다섯 가지 출력 형식을 지원합니다. --output 옵션 또는 --output-file의 확장자(.xlsx, .html, .json, .md)에 따라 형식이 자동 결정됩니다.

심각도 분류 및 진단 카탈로그

결과는 Critical, Warning, Info 세 단계로 분류되며, 170개 이상의 점검은 docs/checks.md에서 코드, 설명, 심각도와 함께 확인할 수 있습니다.

설정 기반 임계값 및 무시 규칙

JSON 기반 settings.json으로 CPU, 메모리, 디스크, 네트워크, 헬스 점수, SMART, PSI 압력 등 임계값을 조정할 수 있습니다. MaxParallelRequests와 ApiTimeout으로 고지연 클러스터 환경을 튜닝할 수 있으며, ErrorCode/Id/SubContext/Description 기준으로 알려진 항목을 무시하는 규칙도 지원합니다.

컴플라이언스 매핑 및 보고

ISO 27001, NIS2, DORA, PCI DSS, GDPR, AgID, ENS, BSI C5, SOC 2, NIST 800-53, ISO 27017, ISO 27018, CIS Controls, NIST CSF 등 14개 프레임워크의 통제 항목이 40개 이상의 점검과 연계되어 있습니다. --compliance=<standard> 옵션으로 특정 표준에 맞춰 보고서를 필터링하고 ControlId 컬럼을 추가할 수 있습니다.

옵션 CVE 스캔

Proxmox VE 전용으로 NVD 조회 기능을 통해 설치된 Proxmox VE 버전에 영향을 주는 알려진 취약점을 확인할 수 있습니다.

Windows

• WinGet: winget install --id Corsinvest.cv4pve.diag --exact
• 수동 설치: GitHub 릴리스 페이지에서 cv4pve-diag-win-x64.zip을 다운로드하여 압축 해제

Linux

• 일반 Linux: wget .../cv4pve-diag-linux-x64.zip 후 압축 해제하고 chmod +x cv4pve-diag으로 실행 권한 부여
• Arch Linux: AUR의 yay -S cv4pve-diag
• Debian/Ubuntu: sudo dpkg -i cv4pve-diag-VERSION-ARCH.deb
• RHEL/Fedora: sudo rpm -i cv4pve-diag-VERSION-ARCH.rpm

macOS

• Homebrew: brew tap Corsinvest/homebrew-tap && brew install cv4pve-diag
• 수동 설치: 릴리스 페이지의 cv4pve-diag-osx-x64.zip 다운로드 후 압축 해제

Q. 진단 시 Proxmox VE에 어떤 권한이 필요한가요?

VM.Audit, Datastore.Audit, Pool.Audit, Sys.Audit, Sys.Modify 권한이 필요합니다. 루트 계정이나 SSH 접근은 요구되지 않습니다.

Q. API 토큰을 사용할 수 있나요?

Proxmox VE 6.2 이상에서 user@realm!token=uuid 형식의 API 토큰으로 인증할 수 있습니다.

Q. 컴플라이언스 보고 기능은 어떤 표준을 지원하나요?

ISO 27001:2022, NIS2, DORA, PCI DSS v4.0, GDPR, AgID, ENS, BSI C5:2020, SOC 2, NIST SP 800-53 rev.5, ISO/IEC 27017, ISO/IEC 27018, CIS Controls v8, NIST CSF 2.0 등 14개 프레임워크의 통제 항목에 40개 이상의 진단 결과가 매핑되어 있습니다.

Q. 단일 노드 Proxmox VE에서도 사용할 수 있나요?

사용할 수 있습니다. 다만 HA·복제 관련 클러스터 비교 점검은 자동으로 생략되며, 단일 노드 구성 자체가 갖는 복원성 공백(IC0017 등)은 매 실행마다 표시됩니다. 개발/실험 환경에서는 무시 규칙으로 침묵 처리할 수 있습니다.