pass-with-high-score/blockads-android

어떤 프로젝트인가요?

핵심 기능

• 01루트 권한 없이 로컬 VPN으로 시스템 전체의 광고, 트래커, 멀웨어 차단
• 02iptables를 사용하는 선택형 Root Proxy Mode
• 03앱별 MITM, CSS 꾸미기 및 JS 스크립틀릿을 지원하는 선택형 HTTPS 필터링
• 04StevenBlack, AdGuard DNS, EasyList 등의 필터 목록 내장
• 05검색 및 필터링을 지원하는 실시간 DNS 쿼리 로그
• 06DNS-over-HTTPS, 앱별 우회, 사용자 지정 차단 및 허용 규칙 지원

활용 사례

• Android 휴대전화를 루팅하지 않고 앱 내 광고와 웹 광고 차단
• 실시간 DNS 쿼리 로그에서 앱이 접속하는 도메인 확인
• 다른 트래픽은 필터링하면서 은행 및 결제 앱은 정상적으로 사용
• 시스템 전체 필터링과 함께 WireGuard 프로필 사용

빠른 시작

1. 1

   blobless clone으로 저장소를 복제합니다

   git clone --filter=blob:limit=1m https://github.com/pass-with-high-score/blockads-android.git
2. 2

   Android Studio에서 프로젝트를 엽니다

3. 3

   Gradle을 동기화하고 기기 또는 에뮬레이터에서 앱을 실행합니다

4. 4

   명령줄에서 debug APK를 빌드합니다

   ./gradlew assembleDebug

사용 전 알아둘 점

• !소스에서 빌드하려면 Android Studio, JDK 17 이상, Android SDK 36이 필요합니다.
• !GPL-3.0 라이선스가 적용되므로 파생 저작물도 카피레프트 조건에 따라 배포해야 합니다.
• !Root Proxy Mode를 사용하려면 루팅된 기기가 필요하지만, 기본 VPN 모드는 그렇지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

blockads-android은(는) 무엇인가요?

루트 권한 없이 로컬 VPN으로 광고, 트래커, 멀웨어를 시스템 전체에서 차단하는 무료 오픈소스 Android 광고 차단기입니다. BlockAds는 기기에서 DNS 쿼리를 필터링하는 오픈소스 Android 광고 차단기입니다. 로컬 VpnService를 실행해 각 쿼리를 Trie 구조로 저장된 필터 목록과 대조하고, 일치하는 도메인을 차단합니다. 일치하지 않는 트래픽은 정상적으로 통과하며, 기기 밖으로 전송되는 데이터는 없습니다.

blockads-android은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

blockads-android은(는) GPL-3.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

blockads-android은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. blockads-android의 마지막 커밋은 2026년 11월 5일입니다.

blockads-android은(는) 어디에 사용할 수 있나요?

Android 휴대전화를 루팅하지 않고 앱 내 광고와 웹 광고 차단 실시간 DNS 쿼리 로그에서 앱이 접속하는 도메인 확인 다른 트래픽은 필터링하면서 은행 및 결제 앱은 정상적으로 사용 시스템 전체 필터링과 함께 WireGuard 프로필 사용

blockads-android는 어떻게 설치하나요?

blobless clone으로 저장소를 복제합니다: git clone --filter=blob:limit=1m https://github.com/pass-with-high-score/blockads-android.git Android Studio에서 프로젝트를 엽니다 Gradle을 동기화하고 기기 또는 에뮬레이터에서 앱을 실행합니다 명령줄에서 debug APK를 빌드합니다: ./gradlew assembleDebug

blockads-android은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/pass-with-high-score/blockads-android