hblock - Improve your security and privacy by blocking ads,

项目说明

<p align="center">
<a href="
<img src="./resources/logo//logo-a.svg" width="320" height="100">
</a>
</p>

<p align="center">
Improve your security and privacy by blocking ads, tracking and malware domains.
</p>

<p align="center">
<a href="
<img src="
</a>
<a href="
<img src="
</a>
<a href="./LICENSE.md">
<img src="
</a>
</p>

What is this for?

hBlock is a POSIX-compliant shell script that gets a list of domains that serve ads, tracking scripts and malware from multiple sources
and creates a hosts file), among other formats, that prevents your system
from connecting to them.

:warning: hBlock by default replaces the hosts file of your system, consider making a backup first if you ha you want to preserve.

Installation

hBlock is a in package managers. Please check the PACKAGES.md file for an up-to-date list.

The latest a can also be installed manually by running the following commands:

Additionally, a systemd timer can be set to regularly update the hosts file for new additions.

Usage

The default behavior of hBlock can be adjusted with multiple options. Use the --help option or check the hblock.1.md file for the
full list.

![asciicast]()

Nightly builds

Nightly builds of the hosts file, among other formats, can be found on the hBlock website.

Temporarily disable hBlock

Sometimes you may need to temporarily disable hBlock, a quick option is to generate a hosts file without any blocked domains by running the following
command:

I found a false positive, what should I do?

It's possible that sometimes one of the hBlock sources includes a domain that shouldn't be blocked, in those cases the best way to proceed is to
temporarily add said domain to the allowlist and report the problem to the original blocklist author. This way it will also be automatically
removed from hBlock within 24h.

To find which blocklist is behind a false positive you can clone the hMirror project and search for that domain.
Although please note that not all hMirror blocklists are used by default in hBlock, an updated list of the sources used can be found in the
SOURCES.md file.

项目信息

开发语言：Shell

Star 数：1990

技术要点

该项目属于病毒分析方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕Improve your security and privacy by blocking ads, tracking and malware domains.展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。