jenssels/whitelisted-pihole Docker Image Overview

jenssels/whitelisted-pihole

基于官方PiHole镜像扩展，预安装白名单项目，包含常用网站列表以避免被过度严格的黑名单屏蔽，并支持通过可配置的定时任务自动更新白名单，无需重启容器。

0 次下载activejenssels镜像

🚀专业版镜像服务，面向生产环境设计

中文简介版本下载

🚀专业版镜像服务，面向生产环境设计

白名单增强版PiHole

白名单增强版PiHole扩展了官方PiHole镜像，集成了白名单项目。
该镜像包含精选的常用网站列表，可防止这些网站被过度严格的黑名单误屏蔽。

提供预安装白名单的镜像，并支持通过可配置的定时任务更新白名单，无需重启容器。
项目维护在GitHub。

标签	描述
dev	开发构建，优先接收变更。为个人使用版本，可能不稳定，严禁任何生产环境使用。
test	测试版构建，包含已完成的功能。可能存在 bugs，功能可能无法正常工作。
rc	新版本发布候选版，包含经测试的新功能，合并到稳定版前的过渡版本。可能存在小 bug，但整体稳定。
latest	最新稳定版，包含最新稳定功能，适合生产环境使用。
1.0-lts	1.0长期支持版，稳定但仅在发现严重问题时更新。

环境变量

可通过以下环境变量自定义镜像行为：

名称	默认值	取值范围	描述
UPDATE_CRON	0 6 * * */7	有效的Cron表达式	白名单更新的定时任务计划。推荐使用Crontab guru验证表达式合法性
UPDATE_REFERRAL	false	"true"或"false"	是否在白名单中包含推荐网站。详情参见白名单项目GitHub页面

Docker Compose示例

yaml
version: '3'  

services:
    pihole:
        image: jenssels/whitelisted-pihole:latest  # 使用最新稳定版镜像
        container_name: whitelisted-pihole         # 容器名称
        ports:
          - "53:53/tcp"    # DNS TCP端口
          - "53:53/udp"    # DNS UDP端口
          - "67:67/udp"    # DHCP端口（可选，如不需要可移除）
          - "80:80/tcp"    # Web管理界面端口
        environment:
          - "UPDATE_CRON=0 6 * * */7"  # 每周日6:00更新白名单
          - UPDATE_REFERRAL=false      # 不包含推荐网站
          - TZ=Europe/Brussels         # 时区设置
          - WEBPASSWORD=MySuperSecretPassword  # Web管理界面密码
          - DNS1=1.1.1.1               # 上游DNS服务器1（Cloudflare）
          - DNS2=8.8.8.8               # 上游DNS服务器2（Google）
        volumes:
          - '/path/to/pihole/dir/:/etc/pihole/'    # PiHole数据持久化目录
          - '/path/to/dnsmasq/dir/:/etc/dnsmasq.d/' # dnsmasq配置持久化目录
        cap_add:
            - NET_ADMIN  # 赋予网络管理权限（DHCP功能需要）
        restart: unless-stopped  # 除非手动停止，否则自动重启

查看更多 whitelisted-pihole 相关镜像 →