Pi-hole Android Private DNS 安装与使用手册

Pi-hole Android Private DNS 安装与使用手册

pi-hole-android-private-dnsScript to auto-install & configure Android Private DNS For Pi-Hole项目地址:https://gitcode.com/gh_mirrors/pi/pi-hole-android-private-dns

一、项目目录结构及介绍

本项目位于GitHub上的仓库地址是 https://github.com/varunsridharan/pi-hole-android-private-dns.git，其主要结构和各部分功能如下：

• .gitattributes: 控制Git在处理特定类型文件时的行为。
• .gitignore: 列出在版本控制中应忽略的文件或文件夹模式。
• CHANGELOG.md: 记录了项目的所有显著变更。
• LICENSE: 项目使用的许可证，这里是GPL-3.0。
• README.md: 包含项目简介、安装步骤和其他重要说明。
• pi-hole-android-private-dns.sh: 主要的安装脚本，适用于Pi-hole 4及以下版本。
• pi-hole5.sh: 更新后的安装脚本，专为Pi-hole 5设计。
• github/workflows: 目录包含自动化工作流程配置文件。
• assets: 可能存放着部署过程中或项目相关的静态资源。

二、项目启动文件介绍

pi-hole-android-private-dns.sh 与 pi-hole5.sh

这两个脚本是项目的核心，用于设置Pi-hole以支持Android设备的Private DNS功能。

• pi-hole-android-private-dns.sh: 适用于较旧版本的Pi-hole（4及以下）。它通过一系列命令配置您的Pi-hole以响应DNS请求，并通过Let's Encrypt获取SSL证书来支持安全连接，以便您的Android设备能通过TLS进行DNS查询。

• pi-hole5.sh: 针对更新到Pi-hole 5.x的用户，此脚本同样用于配置Pi-hole以适应Android私有DNS需求，但可能包含了与新版Pi-hole兼容的更改或优化。

使用方法示例:

• 对于Pihole 5及以上，执行以下命令（替换为您自己的域名和邮箱）：

  sudo wget https://raw.githubusercontent.com/GhostlyCrowd/pi-hole-android-private-dns/main/pi-hole5.sh
  sudo bash pi-hole5.sh [your_domain_name] [your_email@example.com]
  

• 对于Pihole 4及更低版本：

  sudo wget https://raw.githubusercontent.com/GhostlyCrowd/pi-hole-android-private-dns/main/pi-hole-android-private-dns.sh
  sudo bash pi-hole-android-private-dns.sh [your_domain_name] [your_email@example.com]
  

三、项目的配置文件介绍

尽管该脚本自动进行了大部分配置，实际的Pi-hole配置文件位于Pi-hole服务器上。关键配置通常涉及到/etc/pihole/gravity.db（存储黑名单和白名单）、/etc/pihole/pihole-FTL.conf（控制FTL引擎行为），以及Web界面中的设置。对于实现Android私有DNS功能，您可能还需要调整DNS监听设置，确保Pi-hole可以支持DNS over TLS，这通常涉及到编辑/etc/dnsmasq.d/01-pihole-external.conf或其他相关dnsmasq配置文件，开启必要的TLS端口（如853）并配置SSL证书路径。

请注意，手动调整这些配置之前，最好备份原有文件，并参考官方Pi-hole文档和该脚本的注释，确保正确实施修改。

pi-hole-android-private-dnsScript to auto-install & configure Android Private DNS For Pi-Hole项目地址:https://gitcode.com/gh_mirrors/pi/pi-hole-android-private-dns