reset 이후 README 가 없어진 상태에서 코드 동작을 분석해 새로 작성. - 동작 원리: JS (`content.js`) + HTTP 헤더 (`rules.json`) 두 레이어 Mac 위장 (UA, platform, userAgentData / user-agent, sec-ch-ua-platform) - 설치 / 파일 구조 / 권한 정리 - 알려진 위험: "허용되지 않는 비정상적 접근" 팝업 실측 트리거 사실과 추가 핑거프린팅 신호(고엔트로피 CH, WebGL 등) 미위장 한계 명시
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.userAgent→Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) ... Chrome/122.0.0.0 Safari/537.36navigator.platform→MacIntelnavigator.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.com의main_frame/sub_frame/xmlhttprequest/ping/script요청
JS 와 HTTP 헤더 값을 일치시켜 페이지가 보는 식별값과 서버가 받는 식별값이 어긋나지 않도록 합니다.
설치
- 이 저장소를
git clone또는 ZIP 다운로드해 임의의 폴더에 둡니다. - Chrome 계열 브라우저에서
chrome://extensions접속. - 우상단 개발자 모드 활성화.
- 압축해제된 확장 프로그램을 로드합니다 클릭 → 위 폴더 선택.
- 치지직(
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 등 추가 핑거프린팅 신호를 함께 보는 것으로 추정됩니다. 이 확장은 그 모든 신호를 위장하지는 않습니다.
팝업이 반복되면 계정 제재 가능성이 있다고 명시되어 있으니, 본인 책임 하에 사용하시고 팝업이 뜨면 사용을 중단하시기 바랍니다.
면책
본 확장은 학습 및 개인 사용 목적의 우회 도구입니다. 사용에 따른 모든 책임은 사용자에게 있으며, 치지직 약관 및 관련 법령을 준수하여 사용하시기 바랍니다.