WebGL2를 사용할 수 없나요? 플랫폼별 3D 미리보기 문제 해결 가이드
나타나는 증상
미리보기 영역에 "3D 미리보기를 사용할 수 없음" 메시지가 표시되거나, 페이지가 비어 있거나 모델이 표시되지 않습니다. Any3D의 온라인 미리보기는 WebGL2를 사용하여 GPU에서 3D 장면을 렌더링합니다. WebGL2를 사용할 수 없으면 미리보기가 시작되지 않습니다.
일반적인 원인
| 원인 | 일반적인 시나리오 |
|---|---|
| 하드웨어 가속 비활성화 | 브라우저 또는 시스템 설정에서 GPU 비활성화 |
| 그래픽 드라이버 오래됨/비정상 | Windows 노트북 듀얼 그래픽, Linux 오픈 소스 드라이버 |
| 브라우저 블랙리스트 | 매우 오래된 GPU가 브라우저의 소프트웨어 렌더링 목록에 포함됨 |
| 원격 데스크톱 / 가상 머신 | RDP, VM에서 GPU 패스스루 없음 |
| 기업 정책 | GPO에서 하드웨어 가속 비활성화, VDI에서 3D 가속 없음 |
| WebView / 오래된 커널 | 카카오톡, 네이버 앱 등 내장 브라우저, 오래된 앱 |
| 확장 프로그램 간섭 | Canvas 지문 방지 플러그인 등 강제 차단 확장 프로그램 |
플랫폼별 문제 해결
Windows
-
하드웨어 가속 켜기
Chrome/Edge: 설정 → 시스템 → "가능한 경우 하드웨어 가속 사용" → 브라우저 다시 시작. -
그래픽 드라이버 업데이트
NVIDIA / AMD / Intel 공식 홈페이지 또는 Windows 업데이트에서 최신 드라이버 설치. 노트북의 경우 그래픽 제어판에서 브라우저를 "고성능"으로 설정. -
그룹 정책 / 레지스트리 (기업)
IT 부서에서 GPU 합성을 비활성화하는 정책을 적용했을 수 있음. 개인 사용자는chrome://gpu에서 "Software only"가 많이 표시되는지 확인. -
원격 데스크톱
사무실 PC에 RDP 연결 시 WebGL이 작동하지 않는 경우가 많음. → 로컬 PC 브라우저에서 Any3D를 열거나, GPU를 지원하는 원격 솔루션 사용. -
자녀 보호
Windows 가족 보호 하위 계정은 일반적으로 WebGL을 차단하지 않음. 타사 "어린이 브라우저" 사용 시 Chrome/Edge로 테스트.
macOS
- Safari / Chrome 최신 버전; 시스템 설정 → 디스플레이 → 재생률/해상도가 정상인지 확인.
- 저전력 모드에서 GPU 성능 저하, 극단적인 경우 WebGL에 영향 → 전원 연결 후 재시도.
- 스크린 타임은 WebGL을 직접 차단하지 않음. MDM에서 그래픽 제한 시 IT 부서에 문의.
Linux
- 전용 드라이버(NVIDIA) 또는 최신 Mesa;
chrome://gpu에서 GL 상태 확인. - Wayland와 X11 중 한쪽이 실패하면 세션을 전환하여 비교.
iOS / iPadOS
- Safari는 WebGL2 지원이 우수함; 시스템 업데이트 유지.
- 저전력 모드가 성능을 제한할 수 있으므로 미리보기가 끊기거나 실패하면 충전 후 재시도.
- 앱 내 WebView → Safari로 열기.
- 학교 관리 iPad에서 "카메라/파일"을 차단해도 WebGL에는 영향 없지만, 시스템 업데이트 차단 시 커널이 너무 오래될 수 있음.
Android
- Chrome 업데이트; 개발자 옵션 → 강제 GPU 렌더링 켜기 (일부 구형 기기에서 효과적, 최신 시스템에서는 기본값일 수 있음).
- 국내 브랜드 브라우저의 호환 커널은 WebGL2가 없는 경우가 많음 → Chrome 사용.
- 절전 모드가 GPU를 제한하므로 꺼두고 재시도.
네트워크, VPN 및 기업 내부망
WebGL2는 로컬 GPU API이므로 VPN의 직접적인 영향을 받지 않는 경우가 일반적입니다. 그러나 다음 상황은 주의해야 합니다.
| 상황 | 설명 |
|---|---|
| 기업 VDI (Citrix/VMware) | GPU 패스스루가 활성화되지 않으면 WebGL을 사용할 수 없음. IT 부서에서 vGPU를 활성화하거나 로컬 브라우저 사용 |
| VPN이 강제로 브라우저 확장 설치 | 확장 프로그램이 WebGL 컨텍스트를 방해할 수 있음 |
| 내부망에서 IE/구형 Edge만 허용 | WebGL2가 없으므로 최신 Chromium 기반 브라우저로 전환해야 함 |
자녀 보호 및 공공 환경
- 도서관/학교 PC: 잠긴 브라우저나 내장 그래픽 없음 → 개인 노트북으로 확인.
- Family Link가 Chrome 버전 제한: Play 스토어에서 Chrome 업데이트 허용.
단계별 수정 (공통)
chrome://gpu(Chrome/Edge) 또는about:support→ 그래픽에서 WebGL2가 Hardware accelerated로 표시되는지 확인.- 하드웨어 가속 켜기, 드라이버 업데이트, 브라우저 및 시스템 다시 시작.
- 시크릿 창에서 확장 프로그램 배제.
- 다른 브라우저/다른 기기로 교차 확인.
빠른 자가 진단
(() => {
const c = document.createElement("canvas");
return c.getContext("webgl2") !== null;
})();
false가 반환되면 WebGL2 컨텍스트를 생성할 수 없는 것입니다.
WebGL Report (외부 네트워크 접속 필요)에서 자세한 기능을 확인할 수도 있습니다.
OffscreenCanvas와의 관계
텍스처 압축 Worker 경로에도 OffscreenCanvas + WebGL2가 필요합니다. 미리보기는 정상인데 하단 노란색 Worker 경고만 표시된다면 OffscreenCanvas 가이드를 우선 확인하세요. 미리보기 자체가 실패하는 경우 이 글을 따르세요.
요약
WebGL2를 사용할 수 없는 핵심 원인은 GPU/드라이버/하드웨어 가속 문제이며, 기업 VDI, 원격 데스크톱, 오래된 WebView도 흔합니다. 플랫폼에 맞게 가속을 켜고, 드라이버를 업데이트하고, 로컬 브라우저로 접속하면 대부분 3D 미리보기를 복구할 수 있습니다.