Windows 지원 버전
Windows용 zqagent는 CLI 단일 파일, 데스크톱 앱, npm 설치의 세 형태입니다. 요구 사항이 서로 다르며 아래 표가 전체 지원 매트릭스입니다.
지원 매트릭스
| Windows 버전 | CLI 단일 파일 | 데스크톱 앱 | npm 설치 |
|---|---|---|---|
| Windows 11 | ✅ | ✅ | ✅ |
| Windows 10 1709 이상 | ✅ | ✅ | ✅ |
| Windows 10 Enterprise LTSC 2019 / 2021 | ✅ | ✅ | ✅ |
| Windows 10 Enterprise LTSC 2015 / 2016 | ✅ | ✅ | ✅ |
| Windows 10 1507 – 1703(일반판) | ✅ | ❌ | ✅ |
| Windows 8.1 / Server 2012 R2 | ❌ 보장 안 됨 | ❌ | ⚠️ 미검증 |
| Windows 8 / Server 2012 | ❌ | ❌ | ❌ |
| Windows 7 / Server 2008 R2 | ❌ | ❌ | ❌ |
| Windows Server 2016 / 2019 / 2022 | ✅ | ⚠️ 데스크톱 경험 필요 | ✅ |
| 32비트(x86) Windows | ❌ 산출물 없음 | ❌ | ⚠️ 미검증 |
산출물은 64비트(x64)와 ARM64 두 가지뿐입니다. 32비트 Windows는 다른 머신을 사용하세요.
데스크톱 버전의 Windows 10 기준은 1709
데스크톱 버전 설치 가능 여부를 결정하는 것은 Windows 버전 번호 자체가 아니라 WebView2 런타임입니다. 이는 Windows 10 SAC 1709 이상과 Enterprise LTSC 2015 / 2016 / 2019 / 2021을 지원합니다. 따라서 LTSC 2015(1507 기반)와 LTSC 2016(1607 기반)은 버전 번호가 1709보다 앞서도 데스크톱 버전을 설치할 수 있습니다. 반면 같은 번호의 일반판(1511 / 1607 / 1703)은 안 됩니다. 브라우저 UA로는 LTSC와 일반판을 구분할 수 없으므로 사이트는 이 두 버전에 데스크톱 버전을 권장하지 않습니다. 본 표를 보고 직접 판단하세요.
Windows 10은 2025-10-14에 지원 종료
Windows 10(Home / Pro)은 이 날짜부터 Microsoft 보안 업데이트를 받지 못합니다. 22H2가 마지막 버전입니다. 기술적 동작에는 영향이 없지만 민감한 데이터를 다룬다면 Windows 11로 업그레이드하는 것을 권장합니다. Enterprise / IoT LTSC는 각자의 장기 서비스 주기에 따라 업데이트가 계속됩니다.
Windows 7 / 8 / 8.1이 안 되는 이유
이것은 '설치 파일에 런타임이 빠졌다'는 문제가 아니라 운영체제 API가 없기 때문입니다:
- CLI 단일 파일에는 Node.js 22 런타임이 내장되어 있으며,
GetSystemTimePreciseAsFileTime(Windows 8부터)을 정적으로 가져오고WaitOnAddress등 Win8 이후의 동기화 프리미티브를 찾습니다. Windows 7에서는 프로그램이 실제로 실행되기 전에 시스템 로더가 거부합니다: "프로시저 진입점을 찾을 수 없습니다". - 내장 ripgrep은
api-ms-win-core-synch-l1-2-0.dll에 의존하며 이것도 Windows 8부터 있습니다. - 데스크톱 앱은 Node 런타임 외에 WebView2 런타임이 필요하며, WebView2(Microsoft Edge를 따름)는 Edge 109(2023-01)부터 Windows 7 / 8 / 8.1과 Server 2008 R2 / 2012 / 2012 R2 지원을 종료했습니다.
따라서 Visual C++ 런타임(UCRT / VC++ Redistributable)을 설치해도 해결되지 않습니다: Node 공식 바이너리는 C 런타임을 정적으로 링크해 UCRT를 로드하지 않습니다. 부족한 것은 kernel32의 시스템 함수이며 어떤 런타임으로도 보충할 수 없습니다.
오래된 머신이라면
요구 사항을 충족하는 다른 PC(또는 서버)에 zqagent를 설치하고, 오래된 머신의 브라우저로 그 콘솔에 접속하세요:
http://<새 호스트 IP>:8787이렇게 하면 오래된 머신은 브라우저 역할만 하며 zqagent 구성 요소를 실행할 필요가 없습니다.
데스크톱 앱의 추가 요구 사항
| 의존 | 요구 사항 |
|---|---|
| WebView2 런타임 | Windows 10 1709+ / Windows Server 2016+. Win11은 내장 |
| Node 런타임 | 데스크톱 버전에 포함. 별도 설치 불필요 |
| 시스템 아키텍처 | x64 또는 ARM64 |
Windows Server는 '서버 관리자'에서 데스크톱 경험 기능을 설치해야 완전한 GUI가 제공됩니다.