【免费下载】 Pi-hole Web 界面安装与配置指南

Pi-hole Web 界面安装与配置指南

1. 项目基础介绍

Pi-hole 是一个开源的网络级广告拦截器，它能够通过充当网络的DNS服务器来阻止广告和恶意域名。Pi-hole Web 界面是基于 AdminLTE 模板构建的，为用户提供了一个直观的方式来管理和查看 Pi-hole 的统计信息。

主要编程语言

• HTML/CSS/JavaScript：用于构建前端界面
• PHP：后端逻辑处理
• MySQL/SQLite：数据库存储

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

• AdminLTE：一个基于Bootstrap的开源管理面板和控制台模板，用于创建管理界面。
• jQuery：一个快速、小型且功能丰富的JavaScript库。
• Bootstrap：一个用于快速开发Web应用的前端框架。
• Highcharts：一个用于创建图表的JavaScript库。

3. 安装和配置准备工作

在开始安装 Pi-hole Web 界面之前，请确保您的系统满足以下要求：

• Pi-hole 已安装在您的系统上。
• 系统上安装有 Nginx 或 Apache 作为Web服务器。
• PHP 和必要的PHP扩展（如mbstring、json、pdo、tokenizer、xml、ctype、json和bcmath）已安装。
• MySQL 或 MariaDB 数据库服务器正在运行。
• 您已经为 Pi-hole 配置了正确的DNS记录。

详细安装步骤

步骤 1：克隆项目到您的服务器

打开终端，切换到您的Web服务器的根目录（通常是 /var/www/html/ 或 /usr/share/nginx/html/），然后运行以下命令：

git clone https://github.com/pi-hole/web.git

步骤 2：设置数据库

登录到MySQL数据库服务器，创建一个新的数据库用于Pi-hole Web界面：

mysql -u root -p
CREATE DATABASE pihole;
CREATE USER 'pihole'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON pihole.* TO 'pihole'@'localhost';
FLUSH PRIVILEGES;
EXIT;

替换 'your_password' 为一个安全的密码。

步骤 3：配置 Pi-hole Web 界面

编辑 /path/to/pi-hole/web/Includes/config.php 文件，并设置数据库连接信息：

<?php
// 数据库连接设置
$dbHost = 'localhost';
$dbUser = 'pihole';
$dbPass = 'your_password';
$dbName = 'pihole';

步骤 4：设置Web服务器

如果您使用的是Nginx，在 /etc/nginx/sites-available/ 目录下创建一个新的配置文件 pihole，并添加以下内容：

server {
    listen 80;
    server_name your_pi_hole_domain;

    location / {
        root /path/to/pi-hole/web;
        index index.php index.html index.htm;
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        include snippets/fastcgi-php.conf;
        fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; # 根据您的PHP版本进行调整
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }
}

替换 your_pi_hole_domain 为您的Pi-hole域名，并且根据您的PHP版本调整 fastcgi_pass 指令。

启用新的Nginx配置并重启Nginx：

ln -s /etc/nginx/sites-available/pihole /etc/nginx/sites-enabled/
nginx -t
systemctl restart nginx

如果您使用的是Apache，您需要在 /etc/apache2/sites-available/ 目录下创建相应的配置文件，并启用该配置。

步骤 5：完成安装

现在，您应该能够通过浏览器访问 http://your_pi_hole_domain/admin/ 来访问Pi-hole的Web界面。登录后，您可以开始管理您的Pi-hole设置了。

请注意，这些步骤是一个基础的安装流程。根据您的实际环境，您可能需要调整配置文件或执行额外的步骤。确保您在安装过程中参考Pi-hole的官方文档以获取更详细的指导。