maza-ad-blocking
Maza 是一个本地的广告拦截工具，通过修改系统 hosts 文件屏蔽广告，支持多平台，纯 bash 脚本，无需浏览器扩展。
智能下载
前往项目主页
该项目暂未提供安装包，请直接访问源代码仓库
一条命令屏蔽全系统广告，比 Pi-hole 更轻量。
核心功能
- 一条命令屏蔽所有浏览器和应用的广告
- 无需安装浏览器扩展或额外软件
- 支持自动更新广告域名列表（cron）
- 可自定义忽略或添加需要屏蔽的域名
- 集成 Dnsmasq 实现子域名通配符拦截
避坑指南
- •macOS 用户需先安装 gnu-sed：brew install gnu-sed。2. 使用 cron 自动更新时，需在 crontab 中设置 PATH 和 TERM 变量，否则可能失败。3. hosts 文件不支持通配符子域名，如需过滤所有子域名请使用 Dnsmasq 模式。4. 屏蔽列表会默认忽略 localhost 等关键域名，避免系统问题。5. 某些系统服务（如本地开发环境）可能因 hosts 修改受影响，可自行添加白名单。
适用场景
- 个人电脑全系统广告屏蔽
- 家庭网络 DNS 广告过滤（配合 Dnsmasq）
- 快速搭建轻量级 Pi-hole 替代方案
Maza 是一款轻量级的本地广告拦截工具，通过修改系统 hosts 文件来屏蔽广告域名。无需安装浏览器扩展或额外软件，仅依赖 bash 命令。只需执行 `sudo maza start` 即可立即在所有浏览器和已安装应用中拦截广告。支持通过 cron 每日自动更新黑名单，可自定义忽略或添加域名，并可集成 Dnsmasq 实现通配符子域名拦截。相比 Pi-hole，Maza 无需专用硬件或服务器，直接在本地运行。适用于 macOS、Linux、BSD 及 WSL 用户。开源且无任何依赖。
标签
快速上手
安装软件
双击下载的安装程序，按提示完成安装
步骤1：打开终端，运行安装命令：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：建议先备份原 hosts 文件：sudo cp /etc/hosts /etc/hosts.backup
步骤3：启动广告拦截：sudo maza start
- 步骤1：打开终端，运行安装命令：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：建议先备份原 hosts 文件：sudo cp /etc/hosts /etc/hosts.backup
- 步骤3：启动广告拦截：sudo maza start
暂未获取到校验码
该项目暂未在 GitHub Release 页面提供 SHA-256 校验码
SHA256 校验码
暂无校验码
建议从 GitHub Releases 页面直接下载，并自行核对文件完整性
本平台所有 SHA-256 校验码均提取自项目在 GitHub 官方 Release 页面发布的文件，未做任何修改。你可以通过 GitHub Releases 页面自行验证。
开源透明
查看 GitHub 源码卸载说明
运行 sudo rm /usr/local/bin/maza && sudo rm -r /root/.config/maza 即可完全卸载。
无额外依赖
下载后即可直接使用，无需安装其他运行环境
遇到问题？查看下方 FAQ
5 FAQs