통합 백서 · 2026.08 개정

한국어 웹 광고 차단 가이드:
List-KR & filterslists-KO 백서

한국 인터넷 환경을 가장 쾌적하게 만드는 필터 세팅 가이드. 광고 차단 원리부터 안티 애드블록 무력화, 2026년 8월 발생한 프로젝트 분리 내역, 그리고 AdGuard와 uBlock Origin 설정까지 모두 담았습니다.

List-KR GitHub filterslists-KO GitHub
중요 공지: List-KR 프로젝트 분리 안내 (2026년 8월)

2026년 8월 13일부로 오리지널 프로젝트인 List-KR에서 filterslists-KO가 포크(Fork)되어 분리되었습니다.

List-KR은 특정 기업의 개입과 사유화를 거부하며, 커뮤니티 기여자들의 자발적인 참여로 투명하게 유지보수되는 오리지널 오픈소스 필터로 굳건히 남습니다. 반면, AdGuard 측은 자사의 주도 아래 포크된 필터인 filterslists-KO를 채택하여 운영 중입니다.

사용자 안내: AdGuard 등 일부 광고 차단 소프트웨어의 추천 필터 목록에서는 임의로 filterslists-KO로 교체되어 제공되고 있습니다. 기업 정책에 영향을 받지 않는, 커뮤니티 주도의 변함없는 본연의 List-KR을 계속 사용하시려면 아래 필터 적용하기 섹션을 참조하여 수동으로 구독 URL을 갱신 및 유지해 주시기 바랍니다.

1. 광고 차단의 원리와 필수 도구 (AdGuard, uBlock Origin)

인터넷 광고는 어떻게 차단되는 것일까요? 현대의 브라우저 광고 차단기는 주로 두 가지 핵심 기술을 통해 웹사이트를 깨끗하게 만듭니다.

최고의 광고 차단기는 무엇인가요?

웹 생태계에서 가장 성능이 뛰어나고 신뢰받는 도구는 uBlock Origin(uBO)AdGuard입니다. 이 두 프로그램은 오픈소스 철학을 바탕으로 강력한 차단 문법을 지원하여 고급 필터를 완벽히 구동할 수 있습니다. filterslists-KO와 List-KR은 오직 이 두 차단기만을 공식 지원합니다.

uBlock Origin

낮은 CPU 및 메모리 사용량으로 전 세계 웹에서 광고를 차단하는 효율적인 오픈소스 콘텐츠 차단기입니다. Firefox 및 파생 브라우저에서 가장 강력하게 동작합니다.

위키백과에서 자세히 보기

AdGuard AdBlocker

사용자 친화적인 인터페이스와 강력한 피싱, 멀웨어, 트래커 방지 기능을 갖춘 종합 광고 차단 솔루션입니다. 크롬 확장앱과 데스크톱 전체 앱을 제공합니다.

AdGuard 공식 사이트 Chrome 웹 스토어 설치

2. 프로젝트 개요 및 세밀한 필터링 정책

해외 중심의 EasyList 만으로는 한국어 웹사이트의 정교한 광고와 방해 요소를 모두 막기 어렵습니다. 한국 인터넷 환경에 특화된 필터들은 단순 광고 제거를 넘어, 트래커, 방해 요소(Annoyances), 안티 애드블록까지 처리합니다.

💡 합리적인 필터링 정책 예시

무조건 모든 것을 차단하여 사이트를 망가뜨리거나 최적화되지 않은 무거운 필터를 만들지 않습니다. 합리적인 기준을 세워 필터링을 진행합니다. 예를 들어, 네이버 카페 내의 배너 구좌에 설치된 광고의 경우, 사용자 수가 적은 카페까지 일괄 차단하는 것이 아니라 '열매 1' 이상 랭킹인 카페인 경우에만 차단하도록 정책적으로 설정되어 있습니다.

3. 안티 애드블록과 유저스크립트 완벽 이해

최근 인터넷 서핑을 하다 보면 화면 전체를 가리며 "원활한 이용을 위해 광고 차단기를 해제해주세요"라는 경고창을 마주치게 됩니다. 웹사이트 개발자들은 방문자의 브라우저에서 배너 높이가 0px로 감지되거나 스크립트가 차단되면 사이트 이용을 막아버리는 '안티 애드블록' 기술을 사용합니다.

기존 텍스트 기반 필터 리스트만으로는 극도로 난독화된 자바스크립트 기반의 안티 애드블록을 우회하기 어렵습니다. 이때 선제적으로 코드를 가로채거나 무력화하는 유저스크립트(Userscript)가 필요합니다. 현재 아래 스크립트들은 각 관리 주체(FilteringDev 또는 List-KR 커뮤니티)에 따라 나뉘어 제공되며, 사용하시는 필터 리스트와 연계하여 최적화된 방어 솔루션을 선택할 수 있습니다. 같은 플랫폼에 대응하는 유저스크립트를 동시에 사용하지 마세요. (tinyShield와 adshield-defense 중 하나만, NamuLink와 namuwiki-powerlink-blocker 중 하나만 사용)

tinyShield

웹사이트에 삽입되는 Ad-Shield의 강력하고 복잡한 안티 애드블록 메커니즘을 근본적으로 우회하기 위해 개발된 전용 유저스크립트입니다. (FilteringDev 관리, 더 많은 사용자)

이슈 트래커 확인하기 →

NamuLink

나무위키 등 특수한 DOM 구조를 지닌 웹사이트에서 파생되는 다양한 광고 및 안티 애드블록 요소에 대응하기 위해 최적화된 유저스크립트 솔루션입니다. (FilteringDev 관리, 더 많은 사용자)

이슈 트래커 확인하기 →

adshield-defense

Ad-Shield의 복잡한 안티 애드블록 메커니즘을 방어하기 위해 List-KR 커뮤니티에서 채택하여 독립적으로 유지보수하는 공식 유저스크립트입니다.

레포지토리 확인하기 →

namuwiki-powerlink-blocker

나무위키 파워링크 광고 등을 차단하기 위해 제로베이스부터 새롭게 개발된 List-KR 공식 유저스크립트입니다.

레포지토리 확인하기 →

4. 필터 리스트 적용하기 (수동 설치)

확장 프로그램 설정(대시보드)의 '사용자 설정 필터(Custom Filters)' 메뉴에서 아래 주소를 복사하여 추가하세요. List-KR(오리지널 커뮤니티 주도)과 filterslists-KO(AdGuard 주도 포크) 중 오직 하나만 선택하여 추가해야 충돌을 막을 수 있습니다.

버전 가이드:
- Unified: 일반 차단 + YouTube 등 주요 국제 사이트 맞춤 대응 포함, 대부분의 경우 베이스/기본 필터와 중복
- Standard(강력 권장): 일반 차단 + 트래커, 방해 요소 처리
- Classic: 애드가드 법적 허용 정책을 수용한 기본형

NPM 패키지가 @list-kr/filterslists 경로로 유지되는 커뮤니티 기여자 주도의 오리지널 버전입니다.
통합 필터 전환 안내: List-KR은 관리 및 유지보수의 편의성을 위해 Unified, Classic 등의 구분 없이 단일 통합 필터(Standard)로 통일하여 제공합니다. 기존 URL도 내용이 동기화되어 당분간 레거시로 지원되나, 향후 통지 없이 중단될 수 있으므로 아래의 주력 Standard 필터 URL로 교체하시는 것을 강력히 권장합니다.

List-KR for AdGuard (Standard - 추천 통합 필터)
List-KR for uBlock Origin (Standard - 추천 통합 필터)
List-KR DNS

AdGuard의 규칙 제한 정책과 함께 정기적인 유지보수 및 관리를 받는 @filteringdev/filterslists-ko 패키지 버전입니다.

filterslists-KO Unified for AdGuard
filterslists-KO Unified for uBlock Origin
filterslists-KO for AdGuard (Standard)
filterslists-KO for uBlock Origin (Standard)
filterslists-KO Classic for AdGuard
filterslists-KO Classic for uBlock Origin

5. 한국 웹 강력 추천 추가 필터 모음

메인 필터와 병행하여 사용할 때 가장 훌륭한 시너지를 발휘하여 차단 사각지대를 없애주는 오픈소스 필터들입니다.

YousList

한국의 주요 포털 및 사이트 배너, 광고, 트래커 제거에 중점을 둔 클래식하고 매우 안정적인 필터 리스트입니다. List-KR 또는 filterslists-KO 필터 리스트와 중복 사용이 권장되지 않습니다.

GitHub 보기 →

Adguard Gallery Filter

디시인사이드, 아카라이브 등 이미지 업로드 및 열람이 활발한 한국 특유의 대형 커뮤니티 사이트 환경을 완벽하게 클리닝하기 위한 맞춤형 필터입니다. List-KR 또는 filterslists-KO 필터 리스트와 중복 사용이 강력히 권장됩니다.

GitHub 보기 →

6. 필터 기여 및 개발자 가이드

오픈소스 생태계는 여러분의 작은 제보와 코드 기여(Pull Request)로 완성됩니다. List-KR 및 연관 프로젝트에 관련된 질문이나 문의는 각 공식 레포지토리의 이슈 트래커를 이용해 주시고, 비공개 지원이 필요하신 경우 각 기여자의 GitHub 프로필에서 연락처를 확인해 주세요. (AdGuard 자체 필터 관련 제보는 AdGuard 익명 제보 시스템을 이용해 주셔야 합니다.) 기여 규칙과 개발 환경 구축 팁을 확인하세요.

  • 절대적인 개인정보 보호: 수집된 개인정보(로그인 세션, 쿠키 정보 등)를 무단 공유해서는 안 됩니다.
  • 커밋 서명 강제: 투명성 확보를 위해 master 브랜치에 푸시되는 모든 커밋은 GPG 등으로 반드시 서명(Signed)되어야 합니다.
  • 투명성 정책: 본인의 이메일 주소를 퍼블릭으로 공개해야 하며, OpenPGP 공개 키 게시를 권장합니다.

무거운 로컬 개발 환경 없이 브라우저만으로 기여가 가능합니다.

  1. GitHub 레포지토리에서 키보드의 . (마침표) 키를 누르거나 URL을 github.dev/...로 변경합니다.
  2. 열린 Web VS Code 환경에서 룰을 추가/수정합니다.
  3. 변경사항을 커밋한 뒤 Pull Request를 생성합니다.
  • Adblock/AdGuard/uBlock filters grammar: 복잡한 필터 텍스트 파일에 문법 강조(Syntax Highlighting)를 제공합니다.
  • JavaScript and TypeScript Nightly: 스크립틀릿(Scriptlet) 및 유저스크립트 작성 시 최신 문법 검증을 돕습니다.
URL이 클립보드에 복사되었습니다.