热门搜索:
aleksanderbl/pihole-unbound
aleksanderbl
集成Pi-Hole和Unbound的Docker镜像，在单个容器中提供DNS广告拦截与递归解析服务，直接连接DNS根服务器，简化网络配置（无需macvlan）。
3 次收藏下载次数: 0状态：社区镜像维护者：aleksanderbl仓库类型：镜像最近更新：5 天前
Docker 上的 Pi-Hole + Unbound
https://github.com/aleksanderbl29/docker-pihole-unbound/actions/workflows/auto-build-container.yml/badge.svg](https://github.com/aleksanderbl29/docker-pihole-unbound/actions/workflows/auto-build-container.yml)
使用 Docker 运行 Pi-Hole 与上游 Unbound 解析器
- 将 Unbound 直接安装到 Pi-Hole 容器中
- 此配置直接连接 DNS 根服务器，详情请阅读 Pi-Hole 文档 Pi-hole 作为全方位 DNS 解决方案 以了解其含义。
- 通过这种方式，我们还可以简化 Docker 网络，因为不再需要
macvlan。
更新
此镜像会定期使用官方 Pi-Hole 镜像的最新版本进行更新。
每当 https://hub.docker.com/r/pihole/pihole 有更新时，会自动打开拉取请求以实施更新，我会尽力快速合并这些更新。
相关工作流文件位于 .github/workflows/auto-build-container.yml
该工作流在 pihole-unbound/Dockerfile 中的镜像标签更新时运行。我会在 https://github.com/renovatebot/renovate 的帮助下半手动执行此操作。因此，当 https://hub.docker.com/r/pihole/pihole 有更新时，可能会有一定延迟。
描述
此 Docker 部署在单个容器中同时运行 Pi-Hole 和 Unbound。
容器的基础镜像是 https://hub.docker.com/r/pihole/pihole%EF%BC%8C%E6%B7%BB%E5%8A%A0%E4%BA%86%E9%A2%9D%E5%A4%96%E7%9A%84%E6%9E%84%E5%BB%BA%E6%AD%A5%E9%AA%A4%EF%BC%8C%E6%A0%B9%E6%8D%AE Pi-Hole 团队直接提供的说明 将 Unbound 解析器直接安装到容器中。
设置
- 在某处创建一个目录用于设置，例如
/opt/docker/pihole-unbound/。 - 下载/复制
docker-compose.yaml文件并放入此目录。 - 在该目录中创建
.env文件，用于替换部署的变量。
Pi-hole 环境变量
变量及描述复制自 https://github.com/pi-hole/docker-pi-hole/#environment-variables%EF%BC%9A
| 变量 | 默认值 | 取值 | 描述 |
|---|---|---|---|
TZ | UTC | <时区> | 设置您的时区，确保日志在本地午夜轮换。 |
WEBPASSWORD | 随机 | <管理密码> | [***] 的密码。运行 docker logs pihole | grep random 可找到随机密码。 |
FTLCONF_LOCAL_IPV4 | 未设置 | <主机 IP> | 设置服务器的局域网 IP，用于网页拦截模式和 lighttpd 绑定地址。 |
REV_SERVER | false | <"true"|"false"> | 启用 DNS 条件转发以解析设备名称 |
REV_SERVER_DOMAIN | 未设置 | 网络域名 | 如果启用条件转发，设置本地网络路由器的域名 |
REV_SERVER_TARGET | 未设置 | 路由器 IP | 如果启用条件转发，设置本地网络路由器的 IP |
REV_SERVER_CIDR | 未设置 | 反向 DNS | 如果启用条件转发，设置反向 DNS 区域（例如 192.168.0.0/24） |
WEBTHEME | default-light | <"default-dark"|"default-darker"|"default-light"|"default-auto"|"lcars"> | 要使用的用户界面主题。 |
VIRTUAL_HOST | $FTLCONF_LOCAL_IPV4 | <自定义主机名> | 网页服务器的“虚拟主机”，通过此主机名/IP 访问管理界面可修改白名单/黑名单，默认地址为 '[***] |
与 docker-compose.yaml 同目录的 .env 文件示例：
envFTLCONF_LOCAL_IPV4=192.168.1.10 TZ=Europe/Copenhagen WEBPASSWORD=QWERTY123456asdfASDF REV_SERVER=true REV_SERVER_DOMAIN=local REV_SERVER_TARGET=192.168.1.1 REV_SERVER_CIDR=192.168.0.0/16 HOSTNAME=pihole DOMAIN_NAME=pihole.local PIHOLE_WEBPORT=80 WEBTHEME=default-light VIRTUAL_HOST=pihole.box
运行堆栈
bashdocker-compose up -d
如果使用 Portainer，只需将
docker-compose.yaml内容粘贴到堆栈配置中，并在 UI 中直接添加环境变量。
配置 Pi-Hole
- 打开 Pi-Hole 仪表盘（网页界面）。
在浏览器中，若在主机上访问，可前往 [***]
127.0.0.1替换为运行 Pi-Hole 的机器的局域网 IPv4。
- 打开“设置”菜单并导航至“DNS”选项卡。
- 确保“上游 DNS 服务器”面板中的所有复选框均未勾选。
- 勾选“自定义 1 (IPv4)”并将其值设置为
127.0.0.1#5335。 - 点击页面底部的“保存”。
设置完成！接下来需将网络/设备配置为使用 Pi-Hole。
故障排除
本地设备使用 Pi-Hole 作为 DNS 时无网络/网络受限
尝试 ping google.com 和 8.8.8.8。如果 google.com 失败但 8.8.8.8 成功，可能是 Pi-Hole 的“仅允许本地请求”（位于“设置 > DNS > 接口设置”）未将本地设备识别为本地设备。将其改为“允许所有来源”可解决问题，但可能引入安全风险。根本原因需自行排查，此方法可帮助诊断 Pi-Hole 导致“网络中断”的问题。
本地构建镜像
- 将此仓库克隆到您的机器
- 运行以下命令
bashcd docker-pihole-unbound docker build . -t dev/docker-pihole-unbound:latest
使用 Github Actions 自动开发构建
我已设置 Github Action，在所有拉取请求上运行，构建并发布仓库中配置的镜像。该 Action 位于 .github/workflows/dev-build.yml。如需使用此功能，请评论您的仓库并标记我 (@aleksanderbl29)，我将为您运行工作流。
贡献者
感谢所有贡献者帮助改进此项目。
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 pihole-unbound 镜像标签
docker pull docker.xuanyuan.run/aleksanderbl/pihole-unbound:<标签>
DockerHub 原生拉取命令
docker pull aleksanderbl/pihole-unbound:<标签>
更多 pihole-unbound 镜像推荐
cbcrowe/pihole-unbound
cbcrowe
通过Docker运行Pi-Hole与上游Unbound解析器的解决方案，提供两种配置：one-container（Unbound直接集成到Pi-Hole容器，直接连接DNS根服务器，简化网络）和two-container（Pi-Hole与Unbound分离容器，使用第三方加密DNS解析器）。
67 次收藏100万+ 次下载
2 年前更新
rlabinc/pihole-unbound
rlabinc
A supercharged Pi-Hole docker container with Unbound built-in. [Auto Updates 🚀]
9 次收藏10万+ 次下载
1 年前更新
mpgirro/pihole-unbound
mpgirro
一个在单个容器中运行Pi-Hole并集成Unbound DNS解析器的Docker镜像，提供网络广告拦截和本地DNS解析功能。
7 次收藏10万+ 次下载
1 个月前更新
pluim003/pihole-unbound
pluim003
在Docker中运行Pi-Hole并集成最新版本Unbound作为上游解析器的单容器解决方案，提供广告拦截和安全DNS解析功能，Unbound版本持续更新以确保使用最新特性。
1 次收藏1万+ 次下载
29 天前更新
pihole/pihole
pihole
Pi-hole官方Docker镜像，通过您自己的Linux硬件实现网络级广告拦截，支持DNS服务、广告过滤及Web管理界面。
2.9千 次收藏5亿+ 次下载
12 天前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
配置了专属域名后，docker search 为什么会报错？
docker search 限制
Docker Hub 上有的镜像，为什么在轩辕镜像网站搜不到？
站内搜不到镜像
机器不能直连外网时，怎么用 docker save / load 迁镜像？
离线 save/load
docker pull 拉插件报错（plugin v1+json）怎么办？
插件要用 plugin install
WSL 里 Docker 拉镜像特别慢，怎么排查和优化？
WSL 拉取慢
轩辕镜像安全吗？如何用 digest 校验镜像没被篡改？
安全与 digest
第一次用轩辕镜像拉 Docker 镜像，要怎么登录和配置？
新手拉取配置
轩辕镜像合规吗？轩辕镜像的合规是怎么做的？
镜像合规机制
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
docker 无法连接轩辕镜像域名怎么办？
域名连通性排查
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"