tanrax/maza-ad-blocking

어떤 프로젝트인가요?

핵심 기능

• 01확장 프로그램 없이 모든 브라우저와 애플리케이션에서 시스템 전체의 광고를 차단합니다.
• 02시작, 중지, 업데이트, 상태 확인 명령을 제공하는 단일 Bash 스크립트로 실행됩니다.
• 03macOS, Linux, BSD, WSL을 지원합니다.
• 04특정 도메인을 제외하고 차단할 사용자 지정 도메인을 추가할 수 있습니다.
• 05설정 URL을 통해 다른 차단 목록 소스로 전환할 수 있습니다.
• 06선택적으로 Dnsmasq를 연동해 와일드카드 차단을 지원합니다.

활용 사례

• 개인용 노트북이나 데스크톱에서 모든 브라우저와 앱의 광고를 차단합니다.
• 별도 서버를 설치하지 않고 Linux나 macOS에서 로컬 광고 차단기를 실행합니다.
• Dnsmasq를 사용해 Raspberry Pi나 VPS에 Pi-hole과 유사한 소규모 DNS 서버를 구축합니다.

빠른 시작

1. 1

   maza 스크립트를 다운로드해 /usr/local/bin에 설치합니다

   curl -o maza https://raw.githubusercontent.com/tanrax/maza-ad-blocking/master/maza && sudo rm -rf /usr/local/bin/maza && chmod +x maza && sudo mv maza /usr/local/bin
2. 2

   광고 차단을 시작합니다

   sudo maza start

사용 전 알아둘 점

• !sudo가 필요하고 시스템 hosts 파일을 수정하므로 백업을 권장합니다.
• !hosts 파일은 하위 도메인(와일드카드)을 차단할 수 없습니다. 완전한 필터링을 위해서는 로컬 Dnsmasq 서버가 필요합니다.
• !macOS에서는 Homebrew를 통해 GNU sed(gsed)도 설치해야 합니다.

포함된 컬렉션

토픽

자주 묻는 질문

maza-ad-blocking은(는) 무엇인가요?

순수 Bash로 작성된 로컬 OS 수준 광고 차단기로, hosts 파일이나 Dnsmasq를 통해 모든 브라우저와 앱의 광고 도메인을 차단합니다. Maza는 Pi-hole처럼 별도 서버에서 실행하는 대신 컴퓨터에서 로컬로 동작하는 명령줄 광고 차단기입니다. 광고 도메인 목록으로 시스템 hosts 파일을 업데이트하므로, 해당 도메인을 조회하는 컴퓨터의 모든 브라우저와 애플리케이션에 적용되며 브라우저 확장 프로그램을 설치할 필요가 없습니다.

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

maza-ad-blocking은(는) Apache-2.0 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

maza-ad-blocking은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. maza-ad-blocking의 마지막 커밋은 2026년 8월 14일입니다.

maza-ad-blocking은(는) 어디에 사용할 수 있나요?

개인용 노트북이나 데스크톱에서 모든 브라우저와 앱의 광고를 차단합니다. 별도 서버를 설치하지 않고 Linux나 macOS에서 로컬 광고 차단기를 실행합니다. Dnsmasq를 사용해 Raspberry Pi나 VPS에 Pi-hole과 유사한 소규모 DNS 서버를 구축합니다.

maza-ad-blocking는 어떻게 설치하나요?

maza 스크립트를 다운로드해 /usr/local/bin에 설치합니다: curl -o maza https://raw.githubusercontent.com/tanrax/maza-ad-blocking/master/maza && sudo rm -rf /usr/local/bin/maza && chmod +x maza && sudo mv maza /usr/local/bin 광고 차단을 시작합니다: sudo maza start

maza-ad-blocking은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/tanrax/maza-ad-blocking