tanrax/maza-ad-blocking

这是什么？

核心功能

• 01无需浏览器扩展，对系统内所有浏览器和应用统一拦截广告。
• 02单个 Bash 脚本实现启动、停止、更新和状态查看等命令。
• 03支持 macOS、Linux、BSD 和 WSL。
• 04可设置忽略域名，也可添加自定义屏蔽域名。
• 05可通过配置 URL 切换为其他规则列表。
• 06可选集成 Dnsmasq，实现通配符和子域名屏蔽。

适用场景

• 在个人笔记本或台式机上，为所有浏览器和应用统一拦截广告。
• 在 Linux 或 macOS 上运行本地广告拦截，无需额外部署服务器。
• 借助 Dnsmasq 在树莓派或 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 编写的本地广告拦截工具，通过 hosts 文件或 Dnsmasq 对所有浏览器和应用生效。 Maza 是一个在本地运行的命令行广告拦截工具，不需要像 Pi-hole 那样单独部署服务器。它通过更新系统的 hosts 文件屏蔽广告域名，因此电脑上任何解析这些域名的浏览器或应用都会受到影响，无需安装浏览器扩展。

maza-ad-blocking 可以免费使用吗？用的什么许可证？

maza-ad-blocking 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

maza-ad-blocking 还在维护吗？

半年内有更新。maza-ad-blocking 最近一次提交是在 2026年8月14日。

maza-ad-blocking 适合用来做什么？

在个人笔记本或台式机上，为所有浏览器和应用统一拦截广告。 在 Linux 或 macOS 上运行本地广告拦截，无需额外部署服务器。 借助 Dnsmasq 在树莓派或 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