Files
chzzk-bypass/README.md
chzzk-bypass owner d249975b84 docs: 현 상태(v1.0.0) 기능/위장 레이어/위험 정리한 README 작성
reset 이후 README 가 없어진 상태에서 코드 동작을 분석해 새로 작성.

- 동작 원리: JS (`content.js`) + HTTP 헤더 (`rules.json`) 두 레이어
  Mac 위장 (UA, platform, userAgentData / user-agent, sec-ch-ua-platform)
- 설치 / 파일 구조 / 권한 정리
- 알려진 위험: "허용되지 않는 비정상적 접근" 팝업 실측 트리거 사실과
  추가 핑거프린팅 신호(고엔트로피 CH, WebGL 등) 미위장 한계 명시
2026-05-28 19:28:21 +09:00

3.2 KiB

Chzzk Mac Spoofer (Grid Bypass)

치지직(CHZZK) 시청 시 브라우저 환경을 Mac 으로 위장해 그리드(Grid) 설치 없이 1080p 화질을 시청하기 위한 Chrome / Edge / Whale 계열 확장 (Manifest V3).

동작 원리

치지직은 Windows 에서 1080p 시청 시 자체 그리드 앱 설치를 요구하지만, Mac 환경에서는 요구하지 않습니다. 이 확장은 치지직 페이지에 한해 브라우저가 Mac 으로 보이도록 두 레이어를 동시에 위장합니다.

JS 레벨 위장 — content.js (world: MAIN, run_at: document_start)

  • navigator.userAgentMozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ... Chrome/122.0.0.0 Safari/537.36
  • navigator.platformMacIntel
  • navigator.userAgentData{ brands: [Chromium/122, Google Chrome/122, Not-A.Brand/24], mobile: false, platform: "macOS" }

네트워크 레벨 위장 — rules.json (declarativeNetRequest modifyHeaders)

  • user-agent → 위와 동일한 Mac Chrome 122 문자열
  • sec-ch-ua-platform"macOS"
  • 적용 범위: ||chzzk.naver.commain_frame / sub_frame / xmlhttprequest / ping / script 요청

JS 와 HTTP 헤더 값을 일치시켜 페이지가 보는 식별값과 서버가 받는 식별값이 어긋나지 않도록 합니다.

설치

  1. 이 저장소를 git clone 또는 ZIP 다운로드해 임의의 폴더에 둡니다.
  2. Chrome 계열 브라우저에서 chrome://extensions 접속.
  3. 우상단 개발자 모드 활성화.
  4. 압축해제된 확장 프로그램을 로드합니다 클릭 → 위 폴더 선택.
  5. 치지직(https://chzzk.naver.com) 새로고침.

파일 구조

manifest.json     확장 정의 (MV3)
content.js        navigator.userAgent / platform / userAgentData 를 Mac 으로 위장
rules.json        declarativeNetRequest 로 user-agent / sec-ch-ua-platform 헤더 위장
popup.html/css/js 툴바 팝업 (상태 표시)
icons/            확장 아이콘

권한

  • declarativeNetRequest, declarativeNetRequestWithHostAccess — 요청 헤더 위장에 필요
  • host_permissions: *://*.naver.com/*, *://*.ncloud.com/* — 치지직 / 네이버 CDN 요청에 규칙 적용

알려진 위험

본 확장으로 치지직 페이지를 열었을 때 "허용되지 않는 비정상적 접근입니다. 반복적인 접근 시 운영 정책에 따라 조치될 수 있습니다." 팝업이 뜨는 사례가 실측으로 확인되었습니다. 치지직이 JS 의 navigator.*, 저엔트로피 Client Hints 외에 고엔트로피 Client Hints (sec-ch-ua-platform-version, sec-ch-ua-arch, sec-ch-ua-full-version-list 등), WebGL renderer, Canvas 등 추가 핑거프린팅 신호를 함께 보는 것으로 추정됩니다. 이 확장은 그 모든 신호를 위장하지는 않습니다.

팝업이 반복되면 계정 제재 가능성이 있다고 명시되어 있으니, 본인 책임 하에 사용하시고 팝업이 뜨면 사용을 중단하시기 바랍니다.

면책

본 확장은 학습 및 개인 사용 목적의 우회 도구입니다. 사용에 따른 모든 책임은 사용자에게 있으며, 치지직 약관 및 관련 법령을 준수하여 사용하시기 바랍니다.