终极Pi-Hole域名白名单配置指南3种列表的实战应用与优化技巧【免费下载链接】whitelistA simple tool to add commonly white listed domains to your Pi-Hole setup.项目地址: https://gitcode.com/gh_mirrors/wh/whitelistGitHub 加速计划wh/whitelist是一款专为Pi-Hole设计的实用工具能够帮助用户轻松添加常用白名单域名确保关键服务正常运行同时拦截广告。本文将详细解析项目中的三种域名列表文件提供简单快速的配置方法让新手也能轻松掌握Pi-Hole白名单管理技巧。什么是Pi-Hole白名单为什么它如此重要Pi-Hole作为一款强大的网络广告拦截工具通过拦截恶意域名来净化网络环境。但过度拦截可能导致正常服务无法访问——比如流媒体平台、软件更新或智能家居设备可能被误拦截。这就是白名单的价值所在精准放行必要域名平衡广告拦截与服务可用性。GitHub加速计划的白名单解决方案包含三个核心文件位于项目的domains/目录下whitelist.txt基础必备域名列表optional-list.txt按场景分类的可选域名referral-sites.txt推荐链接相关域名核心白名单文件解析whitelist.txtdomains/whitelist.txt是项目的核心文件包含190个经过验证的必要域名确保系统基础功能和常用服务正常运行。这些域名涵盖基础服务如android.clients.google.comAndroid设备同步、time.nist.gov时间同步内容分发网络如akamaihd.net、cloudfront.net确保视频、图片等资源加载常用平台如github.com、youtube-nocookie.com开发与视频服务使用建议直接导入完整列表作为基础白名单这些域名经过社区验证适用于大多数家庭网络环境。图Pi-Hole管理界面中的白名单配置示例显示了域名添加后的效果场景化可选列表optional-list.txtdomains/optional-list.txt提供了按功能分类的域名集合每个类别都有明确注释用户可根据自身需求选择性添加主要分类场景流媒体服务Netflix、Spotify、Pluto.tv等平台的必要域名智能设备Amazon Alexa、Samsung TV、Nvidia设备的验证与更新域名社交平台Facebook、Instagram的媒体加载域名开发工具GitHub、raw.githubusercontent.com等代码仓库域名使用技巧用文本编辑器打开文件删除不需要的类别以#开头的行是注释保留所需服务的域名块。例如不使用Amazon设备可删除Amazon Alexa部分。推荐链接处理referral-sites.txtdomains/referral-sites.txt专注于处理推荐链接和联盟营销域名如cj.com、shareasale.com。这类域名通常用于跟踪流量来源部分会被广告拦截规则误判。适用场景博主或 affiliate 营销人员需要保留推荐链接功能某些电商平台的返利链接需要正常跳转避免合法营销内容被误拦截注意导入此列表可能会允许部分营销跟踪域名建议根据个人隐私需求决定是否使用。快速上手3步完成白名单配置1. 获取项目文件git clone https://gitcode.com/gh_mirrors/wh/whitelist cd whitelist2. 导入基础白名单在Pi-Hole管理界面中进入Settings Blocklists点击Add a new list输入本地文件路径如/path/to/whitelist/domains/whitelist.txt点击Add并更新 Gravity3. 按需添加可选域名根据使用场景从optional-list.txt和referral-sites.txt中选择需要的域名块复制到Pi-Hole的Local DNS DNS Records或通过命令行导入# 示例导入可选列表中的流媒体部分 grep -A 10 # Netflix domains/optional-list.txt | pihole -w -f -i local -图Pi-Hole批量导入域名的操作演示显示了从文件选择到确认导入的完整流程最佳实践与维护建议定期更新通过git pull获取最新域名列表确保覆盖新出现的必要服务分类管理将不同来源的白名单分组如基础服务、娱乐、工作便于管理冲突检查使用Pi-Hole的Query Log功能监控被拦截的域名发现误拦时从白名单文件中查找对应条目备份配置定期导出Pi-Hole配置包含自定义白名单设置常见问题解答Q: 导入完整列表会影响广告拦截效果吗A: 不会。项目经过严格筛选仅包含必要服务域名不会放行广告或跟踪器。Q: 如何验证某个域名是否在白名单中A: 使用Pi-Hole管理界面的Tools Search Adlists功能输入域名进行查询。Q: 可以将自定义域名添加到这些文件中吗A: 建议创建单独的custom-whitelist.txt文件管理个人添加项避免更新时冲突。通过合理配置这三种域名列表你可以打造既安全又实用的网络环境让Pi-Hole在拦截广告的同时确保所有必要服务畅通无阻。立即尝试这份完整指南优化你的网络体验吧【免费下载链接】whitelistA simple tool to add commonly white listed domains to your Pi-Hole setup.项目地址: https://gitcode.com/gh_mirrors/wh/whitelist创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考