Pi-hole Blocklist 项目安装与配置指南

Pi-hole Blocklist 项目安装与配置指南

1. 项目基础介绍

Pi-hole 是一个开源的网络级别的广告拦截工具，它可以通过DNS过滤来阻挡广告和恶意域名。Pi-hole Blocklist 项目是 Pi-hole 的一个扩展，它提供了额外的黑名单规则来增强广告拦截的能力。该项目主要使用的编程语言是 Python。

2. 项目使用的关键技术和框架

该项目使用的主要技术是 Python 编程语言，以及 Pi-hole 的 DNS 过滤功能。它依赖于 Pi-hole 的基础设施，通过添加自定义的 DNS 黑名单来提高广告和恶意内容的拦截效果。

3. 项目安装和配置的准备工作及详细步骤

准备工作

在开始安装之前，请确保您的系统已经满足了以下要求：

• 运行着 Pi-hole 的系统
• 安装了 Git
• 确保您的用户具有执行脚本和修改 Pi-hole 配置文件的权限

安装步骤

1. 克隆仓库

   打开终端（在 Linux 或 macOS 上）或命令提示符（在 Windows 上），然后执行以下命令以克隆项目仓库：

   git clone https://github.com/zangadoprojects/pi-hole-blocklist.git
   

2. 安装依赖

   进入项目目录，安装所需的 Python 依赖：

   cd pi-hole-blocklist
   pip install -r requirements.txt
   

3. 配置 Pi-hole

   在 Pi-hole Blocklist 项目目录中，有一个名为 update.sh 的脚本，该脚本会自动更新 Pi-hole 的黑名单规则。执行以下命令来运行脚本：

   ./update.sh
   

   脚本将会自动添加新的黑名单规则到 Pi-hole 中。

4. 设置定时任务

   为了让黑名单规则保持最新，您可以设置一个定时任务来自动执行更新脚本。在 Linux 系统上，可以使用 cron：

   crontab -e
   

   然后添加以下行到您的 crontab 文件中，以便每天自动更新一次：

   0 0 * * * /path/to/pi-hole-blocklist/update.sh
   

   替换 /path/to/pi-hole-blocklist/update.sh 为实际的脚本路径。

5. 重启 Pi-hole

   为了让新的黑名单规则生效，您需要重启 Pi-hole 服务：

   sudo systemctl restart pihole-FTL
   

   或者，如果您的系统不支持 systemctl，可以使用：

   sudo service pihole-FTL restart
   

完成以上步骤后，您的 Pi-hole 系统应该已经成功集成了 Pi-hole Blocklist 项目，可以更有效地拦截广告和恶意内容了。