白名单增强版PiHole扩展了***PiHole镜像,集成了白名单项目。
该镜像包含精选的常用网站列表,可防止这些网站被过度严格的黑名单误屏蔽。
提供预安装白名单的镜像,并支持通过可配置的定时任务更新白名单,无需重启容器。
项目维护在GitHub。
所有构建每日更新,以同步基础镜像更新或源码分支变更。
构建通过Jenkins镜像此处自动化完成。
| 标签 | 描述 |
|---|---|
| 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页面 |
yamlversion: '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 # 除非手动停止,否则自动重启
来自真实用户的反馈,见证轩辕镜像的优质服务
免费版仅支持 Docker Hub 加速,不承诺可用性和速度;专业版支持更多镜像源,保证可用性和稳定速度,提供优先客服响应。
免费版仅支持 docker.io;专业版支持 docker.io、gcr.io、ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等。
当返回 402 Payment Required 错误时,表示流量已耗尽,需要充值流量包以恢复服务。
通常由 Docker 版本过低导致,需要升级到 20.x 或更高版本以支持 V2 协议。
先检查 Docker 版本,版本过低则升级;版本正常则验证镜像信息是否正确。
使用 docker tag 命令为镜像打上新标签,去掉域名前缀,使镜像名称更简洁。
探索更多轩辕镜像的使用方法,找到最适合您系统的配置方式
通过 Docker 登录认证访问私有仓库
在 Linux 系统配置镜像加速服务
在 Docker Desktop 配置镜像加速
Docker Compose 项目配置加速
Kubernetes 集群配置 Containerd
在宝塔面板一键配置镜像加速
Synology 群晖 NAS 配置加速
飞牛 fnOS 系统配置镜像加速
极空间 NAS 系统配置加速服务
爱快 iKuai 路由系统配置加速
绿联 NAS 系统配置镜像加速
QNAP 威联通 NAS 配置加速
Podman 容器引擎配置加速
HPC 科学计算容器配置加速
ghcr、Quay、nvcr 等镜像仓库
无需登录使用专属域名加速