wBlock

Safari 광고 차단의 끝판왕

Version

wBlock Filters for macOS in light and dark appearances

macOS, iOS, iPadOS, visionOS용 Safari 콘텐츠 차단기입니다.
5개 확장 프로그램에 750,000개 규칙, Protocol Buffer 저장, LZ4 압축, iCloud 동기화를 지원합니다.

[!NOTE] 자세한 비교가 필요하신가요? 비교 가이드에서 wBlock이 다른 Safari 콘텐츠 차단기와 어떻게 비교되는지 확인해 보세요.

기능

성능

플랫폼당 5개의 Safari 콘텐츠 차단 확장 프로그램에서 750,000개 규칙 용량 (각 150,000개)
유휴 시 약 40MB RAM — Safari의 네이티브 콘텐츠 차단 API가 프로세스 외부에서 규칙을 실행합니다
필터 저장을 위한 Protocol Buffers + LZ4; 스트리밍 I/O로 컴파일 중 메모리 사용량을 낮게 유지합니다
HTTP 조건부 요청 (If-Modified-Since/ETag)으로 변경된 부분만 다운로드하여 업데이트합니다
기기 간 필터 선택, 사용자 정의 목록, 사용자 스크립트, 화이트리스트를 위한 iCloud 동기화

콘텐츠 수정

요소 제거기 (macOS, iOS, iPadOS, visionOS) — Safari에서 페이지 요소를 시각적으로 선택하고 숨깁니다
자동 재생 없음 (macOS, iOS, iPadOS, visionOS) — 탭하거나 클릭할 때까지 동영상과 오디오를 일시정지 상태로 유지하여 음소거된 피드/스크롤 자동 재생을 중지합니다. Safari 툴바 팝업에서 전역으로 활성화하고, 페이지에서 필요할 때 사이트별로 자동 재생을 허용할 수 있습니다
Tube Cleaner 및 Player Cleaner — wBlock-userscripts 저장소에서 기본적으로 다운로드되는 선택적 원격 사용자 스크립트입니다. 첫 페인트 전에 기존 미디어 요소를 네이티브 Safari 플레이어로 변환하여 Picture-in-Picture 및 백그라운드 재생을 복원합니다. 앱 버전과 독립적으로 업데이트됩니다. wBlock의 콘텐츠 차단 규칙이 광고를 별도로 처리합니다
Greasemonkey API(GM_getValue, GM_setValue, GM_xmlhttpRequest)를 지원하는 사용자 스크립트 엔진
사용자 스타일 지원 — JS 래퍼 없이 CSS로 네이티브 적용되는 UserCSS 테마(.user.css) 설치
URL, 붙여넣기 또는 파일 가져오기를 통한 사용자 정의 필터 목록 — 모든 AdGuard 구문 차단 목록 지원
필터와 사용자 스크립트를 빠르게 찾기 위한 툴바 검색
최대 적용 범위를 위한 5개 콘텐츠 차단 슬롯 전체의 자동 규칙 분배

차단

네트워크 요청 차단 — 광고, 추적기, 쿠키 배너, 성가신 요소
미용 필터링 및 요소 숨기기를 위한 CSS 주입
원치 않는 JavaScript 차단을 위한 스크립트 차단
팝업 및 리디렉션 방지
URL 추적 매개변수 제거 — UTM 및 기타 추적 매개변수를 제거하고, 단축/리디렉션 URL을 해제합니다 (wBlock Scripts를 통해 기본 활성화)

구성

1시간마다부터 7일마다 또는 수동까지의 자동 업데이트. macOS는 번들 실행 에이전트와 백그라운드 업데이트 서비스를 통해 계속 확인할 수 있으며, iOS 백그라운드 확인은 최선의 노력 방식입니다
사이트별 제어 — Safari 툴바에서 특정 사이트의 차단 비활성화
차단 요청 로거 (macOS) — 각 페이지에서 차단된 항목 확인
사이트별 설정 — 신뢰할 수 있는 도메인 화이트리스트, 사이트별 사용자 스크립트 토글, 도메인별 요소 제거기 규칙 켜기/끄기
로케일 기반 자동 감지가 포함된 지역 필터
macOS용 Homebrew cask: brew tap 0xcub3/wblock && brew install --cask wblock

스크린샷

사용자 스크립트 관리
페이월, YouTube 싫어요 수 등 관리

설정 및 사용자 정의
자동 업데이트, 알림 및 기본 설정 구성

iOS 인터페이스
iPhone에서 완전한 기능의 차단

iPadOS 인터페이스
iPad에서 완전한 기능의 차단

기술 구현

핵심 아키텍처

필터 직렬화를 위한 Protocol Buffers (libprotobuf) 및 LZ4 압축
Swift 동시성(async/await, Task, Actor 격리)을 사용한 비동기 I/O
디스크로의 스트리밍 직렬화로 컴파일 중 최대 메모리 사용량 최소화
플랫폼당 5개의 Safari 콘텐츠 차단 확장 프로그램 (Safari API 최대 용량)
선언적 콘텐츠 차단을 위한 SafariServices 프레임워크 통합

의존성 및 표준

AdGuard에서 Safari 규칙 변환을 위한 SafariConverterLib v4.3.0
고급 차단 기술을 위한 번들 AdGuard scriptlet 엔진
프로젝트 수준 Swift 5 설정이 포함된 Swift 동시성(async/await, Task, Actor 격리)
SwiftUI 앱 전체에서 VoiceOver 및 Dynamic Type 지원
크로스 플랫폼 필터 저장 형식을 위한 SwiftProtobuf

개발 지원

wBlock은 무료 오픈 소스입니다.
프로젝트를 지원하고 싶다면:

FAQ

wBlock은 다른 광고 차단기와 어떻게 비교되나요?

uBlock Origin Lite, Wipr 2 및 AdGuard의 Safari 앱과 비교한 비교 가이드를 확인해 보세요.

App Store에서 설치해야 하나요, 아니면 DMG/Homebrew 릴리스를 설치해야 하나요?

App Store 버전은 앱 업데이트를 자동으로 처리하므로 일반적으로 선호됩니다. DMG/Homebrew 릴리스는 동일한 기능을 제공하며 App Store 외부에서 설치를 선호하는 사용자를 위한 것입니다.

wBlock을 다른 광고 차단기와 함께 사용해야 하나요?

아니요. 한 번에 범용 콘텐츠 차단기 하나만 사용하세요.

모든 광고 차단기 조합이 모든 페이지에 해를 끼친다는 것을 증명하는 통제된 연구는 없습니다. 그러나 브라우저 아키텍처와 확장 프로그램 문서는 중복 차단기를 피하는 것을 지지합니다:

확장 프로그램은 상충되는 변경을 만들 수 있습니다. Mozilla는 두 확장 프로그램이 동일한 응답 헤더에 상충되는 수정을 시도할 때 하나의 변경만 성공할 수 있다고 문서화합니다. 따라서 여러 차단기는 예측 가능한 보호 조합이 아닌 순서에 의존하는 동작을 만들 수 있습니다. Mozilla의 webRequest 문서를 참조하세요.
요청 가로채기에는 측정 가능한 계산 비용이 있습니다. Chromium은 차단 요청 핸들러와 관련된 직렬화, 프로세스 간 통신, 상주 프로세스 및 확장 프로그램 응답 처리 비용을 설명합니다. 중복 필터링 시스템을 실행하면 최소한 일부 규칙 평가 및 페이지 처리 작업이 중복됩니다. Chromium의 Web Request 및 Declarative Net Request 설명과 Chrome의 Manifest V3 개요를 참조하세요.
주요 차단기 유지관리자들은 중첩 사용을 명시적으로 권장하지 않습니다. 공식 uBlock Origin README는 다음과 같이 명시합니다: "다른 콘텐츠 차단기와 함께 uBO를 사용하지 마세요." 다른 차단기가 uBO의 개인정보 보호 또는 안티차단 해제 기능이 올바르게 작동하지 못하게 할 수 있다고 설명합니다. uBlock Origin 공식 문서를 참조하세요.
문서화된 실패 모드에는 느린 로딩과 기능 손상이 포함됩니다. AdGuard는 두 차단기가 동일한 요청을 두고 경쟁하여 페이지 로딩이 느려지거나, 웹사이트가 손상되거나, 동영상 재생 문제가 발생할 수 있다고 경고합니다. AdGuard의 지침을 참조하세요.

특히 wBlock의 경우, 다른 차단기가 있으면 문제 해결도 불가능해집니다. 광고가 살아남거나 사이트가 손상될 때, 두 차단기 중 하나의 네트워크 규칙, 미용 규칙, scriptlet, 예외 또는 실행 순서가 원인일 수 있습니다. 따라서 두 번째 차단기는 혼란 변수입니다. wBlock 문제를 보고하기 전에 다른 모든 콘텐츠 차단기를 비활성화하세요.

두 도구가 동일한 가로채기 계층에서 경쟁할 때 중복 차단기를 설치하는 것은 심층 방어가 아닙니다. 대조군이 없는 통제되지 않은 실험입니다.

자체 필터 목록을 사용할 수 있나요?

네. URL로 AdGuard 호환 필터 목록을 추가하거나, 규칙을 직접 붙여넣거나, 파일에서 가져올 수 있습니다.

더 나은 차단을 위해 더 많은 필터 목록을 활성화해야 하나요?

일반적으로 아닙니다. 권장 기본값은 이미 대부분의 광고와 추적기를 커버하며, 대부분의 다른 범용 목록은 이들과 중복됩니다. 더 활성화하면 주로 Safari의 규칙 한도를 소모하고 사이트 손상 가능성이 높아집니다. 예외는 기본값이 커버하지 않는 Annoyances 필터(쿠키 배너, 팝업, 소셜 위젯)와 비영어 사이트용 지역 필터입니다.

wBlock이 Safari를 느리게 하나요?

일반적인 사용에서는 아닙니다. wBlock은 Safari의 네이티브 선언적 콘텐츠 차단 API를 사용하여 앱 프로세스 외부에서 컴파일된 규칙을 적용합니다. 로컬 유휴 상태는 약 40MB이며, 페이지 로딩은 Safari의 네이티브 차단기 경로에 유지됩니다.

사용자 스크립트가 iOS 및 iPadOS에서 작동하나요?

네. 사용자 스크립트 엔진은 Safari Web Extensions를 통해 iOS, iPadOS 및 macOS에서 일반적인 Greasemonkey API(GM_getValue, GM_setValue, GM_xmlhttpRequest, GM_addStyle)를 구현합니다.

Twitch 광고를 어떻게 차단하나요?

wBlock은 AdGuard Extra 사용자 스크립트를 번들로 제공하며, Twitch의 GraphQL API(gql.twitch.tv)와 통신하여 Twitch 광고에 도움이 될 수 있습니다 — uBlock Origin 사용자들이 의존하는 것과 동일한 일반적인 접근 방식입니다. 기본적으로 비활성화되어 있으므로 Twitch에서 활성화하세요:

1. wBlock을 열고 사용자 스크립트 섹션으로 이동합니다.
2. 내장 목록에서 AdGuard Extra를 찾아 켭니다.
3. 열려 있는 Twitch 탭을 새로고침합니다.

이것은 최선의 노력 방식의 커뮤니티 스타일 광고 차단입니다: Twitch는 광고 제공 방식을 자주 변경하므로 사용자 스크립트가 업데이트될 때까지 가끔 작동하지 않을 수 있습니다. 모든 광고가 제거된다는 보장은 없습니다.

Tube Cleaner와 Player Cleaner란 무엇인가요?

Vinegar와 Baking Soda에서 영감을 받은 선택적 원격 다운로드 사용자 스크립트로, 사이트의 기존 미디어 요소에 Safari의 네이티브 컨트롤을 노출합니다. 기본적으로 비활성화되어 있으며 사용자 스크립트 섹션에서 활성화할 수 있습니다. 릴리스는 wBlock-userscripts에 호스팅되며 wBlock 앱 버전과 연결되지 않습니다.

Tube Cleaner는 YouTube 시청, Shorts 및 Music 페이지를 대상으로 합니다. /embed 및 youtube-nocookie 프레임은 YouTube 자체 플레이어에 남겨두어 해당 iframe이 비어 있지 않게 합니다. 시청 페이지에서는 YouTube가 자체 <video> 및 SABR/MSE 스트림을 생성하고 초기화하도록 한 다음, 네이티브 컨트롤을 적용하고 YouTube의 사용자 정의 chrome이 페인트되기 전에 숨깁니다. 호버 재생 썸네일 미리보기는 YouTube에 남아 시청 플레이어를 가로챌 수 없습니다. 동일한 미디어 요소를 재사용하여 버퍼링과 적응형 재생을 유지하면서 Picture-in-Picture 및 백그라운드 재생을 복원합니다. YouTube 챕터와 자막을 Safari의 네이티브 미디어 메뉴에 미러링하고 SponsorBlock의 개인정보 보호 해시 접두사 API를 통해 알려진 세그먼트를 건너뜁니다. 컴팩트한 SB 패널은 SponsorBlock 스타일의 카테고리 색상과 카테고리별 자동 건너뛰기, 건너뛰기 버튼 표시 또는 비활성화 동작, 최소 길이, 실행 취소 알림, 현재 동영상 및 채널 제외 컨트롤을 제공합니다. 선택적 DA 패널은 DeArrow를 사용하여 시청 페이지와 표시되는 YouTube 카드에서 제출된 제목과 썸네일을 대체하고, 호버 시 원본을 복원하거나 현재 채널을 제외할 수 있습니다. 결과는 세션 캐시됩니다. 무작위 대체 썸네일, 제목 재포맷, 제출 및 투표는 전체 DeArrow 확장 프로그램의 기능으로 남아 있습니다. SponsorBlock 및 DeArrow API 데이터는 CC BY-NC-SA 4.0에 따라 사용됩니다. SB와 DA는 품질 및 오디오/비디오 컨트롤 아래의 자체 툴바 행에 있습니다. iPhone과 iPad에서는 Safari의 네이티브 컨트롤이 재생을 소유하고 컴팩트 툴바가 그 위에 나타납니다. 모바일 품질 선택은 현재 동영상에만 적용되므로 고정 범위가 다음 ManagedMediaSource 스트림을 중단시킬 수 없습니다. Tube Cleaner는 또한 WebKit이 해당 스트림에 요구하는 원격 재생 제한을 유지하며, 오디오 전용은 macOS 기능으로 남아 있습니다. YouTube가 오프스크린 Shorts를 유지함에 따라 활성 플레이어를 따릅니다. 광고는 wBlock의 콘텐츠 차단 규칙의 책임으로 남아 있습니다.

Player Cleaner는 다른 웹사이트의 사용자 정의 플레이어(video.js, JW Player, Plyr, Flowplayer, MediaElement, Clappr, Media Chrome/Mux 등)를 대상으로 하며, Archive.org의 <play-av>와 같은 shadow-root 플레이어도 포함합니다. 네이티브 컨트롤을 즉시 활성화합니다. 안전한 직접 소스가 light DOM에서 사용 가능한 경우 원래 미디어 요소를 유지하면서 사용자 정의 chrome을 제거합니다. shadow 구성 요소와 불투명한 HLS/DASH/MSE 파이프라인은 그대로 유지되며 사이트의 스트림 메커니즘을 계속 사용합니다. 페이지 또는 일반적인 플레이어 API가 노출하는 자막 및 챕터 사이드카를 복구하고, 누락된 시스템 Now Playing 메타데이터와 미디어 키 작업을 채우며, 사이트별로 재생 속도, 볼륨, 음소거 상태, 자막 언어 및 재개 위치를 기억합니다. 사이트가 오작동하면 wBlock 툴바에서 해당 사이트의 Player Cleaner를 비활성화하세요.

어디에서 찾을 수 있고 무엇으로 테스트할 수 있나요?

둘 다 비활성화된 상태로 제공됩니다. 사용자 스크립트 탭을 열면 Tube Cleaner와 Player Cleaner가 일반 섹션 상단에 있습니다. 하나를 켠 다음 테스트하려는 페이지를 새로고침하세요. 목록에 없으면 이 변경 이전의 wBlock 빌드를 실행 중인 것입니다 — wBlock을 종료하고 Xcode에서 이 브랜치를 실행하세요 (Homebrew 또는 릴리스 설치에는 브랜치 코드가 포함될 수 없습니다).

Tube Cleaner (YouTube 시청 페이지):
• Big Buck Bunny — 길고, 다양한 품질, 품질 메뉴 테스트에 적합
• Sintel
• Tears of Steel
YouTube chrome이 번쩍이지 않고 네이티브 컨트롤이 나타나는지, 품질 및 오디오 전용 컨트롤이 작동하는지, 이미 호버된 플레이어 위로 마우스를 이동할 때 툴바가 다시 나타나는지, Picture-in-Picture가 작동하는지, 다른 탭에서 오디오가 계속 재생되는지 확인하세요. 다른 사이트에 포함된 YouTube iframe은 YouTube 자체 플레이어를 유지해야 합니다. DA 패널은 기본적으로 꺼져 있습니다. DeArrow 제목, 썸네일, 호버 시 원본 및 채널 제외를 테스트하려면 활성화하세요. 광고 동작은 활성화된 wBlock 필터 목록에 따라 달라집니다.

Player Cleaner (다른 사이트의 사용자 정의 플레이어), 지원되는 라이브러리당 데모 하나:
• video.js / Media Chrome — videojs.org
• Plyr — plyr.io
• JW Player — 스트림 테스터 및 데모
• Archive.org shadow-root JW Player — FedFlix 샘플
• Clappr — clappr.io 및 cdn.clappr.io
• MediaElement — mediaelementjs.com
• hls.js — hls.js 데모
• dash.js — DASH 참조 플레이어
네이티브 컨트롤이 신속하게 나타나는지, Picture-in-Picture 및 전체 화면이 작동하는지, 사용자 정의 chrome이 사라질 때 재생이 다시 시작되지 않는지 확인하세요. HLS/DASH/blob 플레이어는 네이티브 컨트롤을 사용하면서 스트림 파이프라인을 유지할 수 있습니다. 사이트가 오작동하면 wBlock 툴바에서 해당 사이트의 Player Cleaner를 비활성화하세요.

비공개 브라우징에서 쿠키 배너나 스크립틀릿이 작동하지 않는 이유는 무엇인가요?

Safari는 각 확장 프로그램에 대해 비공개 브라우징에서 허용을 활성화할 때까지 비공개 브라우징에서 웹 확장 프로그램을 비활성화합니다. 쿠키 알림 필터는 종종 스크립틀릿으로 배너를 닫는데(예: Sourcepoint를 통한 heise.de), 이러한 스크립틀릿은 wBlock Scripts를 통해서만 실행됩니다.

Safari → 설정 → 확장 프로그램 → wBlock Scripts 및 5개 wBlock 콘텐츠 차단기 모두에 대해 비공개 브라우징에서 허용을 활성화한 다음 비공개 창을 다시 로드하세요.

일반 창에서 배너가 이미 사라진 경우, 이는 저장된 동의 쿠키 때문일 수 있습니다. 해당 사이트의 쿠키를 지우고 다시 비교한 후에만 필터가 비공개 브라우징에서만 고장난 것인지 판단하세요.

필터는 얼마나 자주 업데이트되나요?

자동 업데이트 간격은 1시간에서 7일 사이로 구성하거나 수동으로 트리거할 수 있습니다. macOS에서는 자동 업데이트를 활성화하면 번들 실행 에이전트가 등록되어 백그라운드 업데이트 서비스를 통해 앱이 닫혀 있는 동안에도 계속 확인할 수 있습니다. iOS 및 iPadOS에서는 백그라운드 확인이 최선의 노력(best-effort) 방식이며, 시스템이 wBlock을 깨우거나 사용자가 다시 열 때까지 대기할 수 있습니다. Safari를 여는 것만으로는 업데이트가 트리거되지 않습니다. 업데이트는 서버가 지원하는 경우 HTTP 조건부 요청(If-Modified-Since/ETag 헤더)을 사용하므로 불필요한 다운로드를 줄일 수 있습니다.

요소 제퍼(Element Zapper)는 iOS 및 iPadOS에서 사용할 수 있나요?

네. Safari에서 wBlock 확장 프로그램 팝업을 열고 요소 제퍼 활성화를 탭하세요.