Ad-Shield가 차단된 광고를 다시 삽입하거나 차단 방지 검사를 실행하지 못하도록 막는 유저스크립트입니다.
일반적인 광고를 직접 차단하는 도구는 아닙니다. AdGuard 또는 uBlock Origin 같은 광고 차단기와 함께 사용하는 것을 권장합니다.
- App Store에서 Userscripts 앱을 설치합니다.
- Safari 설정에서 Userscripts 확장 프로그램을 활성화하고 웹사이트 접근을 허용합니다.
- 위 설치 링크를 Safari로 연 뒤 Userscripts 확장 메뉴에서 설치합니다.
- 적용할 웹페이지를 새로고침합니다.
Tampermonkey 또는 Violentmonkey에서 위 설치 링크를 열어 설치할 수 있습니다. 주된 지원 대상은 iOS 및 iPadOS의 Userscripts입니다.
스크립트는 웹페이지가 시작될 때 실행되어 Ad-Shield 특유의 광고 초기화 및 재삽입 코드만 감지해 중단합니다. 동적으로 삽입되는 loader와 재삽입 스크립트는 실행 전에 비활성화하고, 함수 기반 보조 검사는 함수별로 한 번만 수행합니다. WeakMap 검사는 getter를 실행하지 않고 impression 데이터만 확인하며, 타이머는 실행 중인 loader의 출처로 판단합니다.
data, wp-data, data-resource에 담긴 CSS는 별도로 복원합니다. 같은 loader의 토큰 조회와 같은 CSS의 동시 요청을 공유하고, 요청이 5초 동안 완료되지 않으면 다음 호스트를 시도합니다. payload 디코딩 표는 2026-09-07에 확인한 loader 형식과 이전 형식을 지원하며, 형식이 바뀌면 갱신이 필요합니다.
페이지 로드 후 30초 동안 Ad-Shield 시그니처가 감지되지 않으면 설치했던 JavaScript 훅을 원래 상태로 복구하고 DOM 감시도 중단합니다. 시그니처가 한 번이라도 감지된 페이지에서는 광고 재삽입을 계속 막기 위해 훅을 유지합니다.
모든 HTTP 및 HTTPS 웹사이트에서 일찍 실행되어야 감지가 가능하지만, 방문 기록이나 페이지 내용을 저장하거나 외부로 전송하지 않습니다.
설치한 유저스크립트 관리자가 새 버전을 확인해 자동으로 업데이트합니다. 업데이트가 바로 보이지 않으면 잠시 후 다시 확인하거나 설치 링크에서 재설치해 주세요.
웹사이트가 정상적으로 동작하지 않으면 adShield Defense를 잠시 끄고 페이지를 새로고침해 보세요. 문제가 사라지면 사이트 주소와 재현 방법을 저장소의 Issue로 알려주세요.
개발 참여 방법은 CONTRIBUTING.md를 참고하세요.
이 프로젝트는 MPL-2.0으로 배포됩니다. 2b0ef9a40c2824861e2b11ec395c9c1dce94d4fe 커밋 이전까지의 버전은 FilteringDev/tinyShield를 바탕으로 작성되었습니다. 현재의 탐지·훅 구현은 로더 동작을 분석해 재작성했으며, 기존 기여 이력과 MPL-2.0 고지는 유지합니다.