aleksanderbl/pihole-unbound Docker 镜像 - 轩辕镜像

Docker 上的 Pi-Hole + Unbound

![构建并发布容器]([] ![Docker 拉取量]([]

使用 Docker 运行 Pi-Hole 与上游 Unbound 解析器

• 将 Unbound 直接安装到 Pi-Hole 容器中
  • 此配置直接连接 DNS 根服务器，详情请阅读 Pi-Hole 文档 Pi-hole 作为全方位 DNS 解决方案 以了解其含义。
  • 通过这种方式，我们还可以简化 Docker 网络，因为不再需要 macvlan。

更新

此镜像会定期使用官方 Pi-Hole 镜像的最新版本进行更新。

每当 原始 pihole 镜像 有更新时，会自动打开拉取请求以实施更新，我会尽力快速合并这些更新。

相关工作流文件位于 .github/workflows/auto-build-container.yml

该工作流在 pihole-unbound/Dockerfile 中的镜像标签更新时运行。我会在 renovate 机器人 的帮助下半手动执行此操作。因此，当 原始 pihole 镜像 有更新时，可能会有一定延迟。

描述

此 Docker 部署在单个容器中同时运行 Pi-Hole 和 Unbound。

容器的基础镜像是 官方 Pi-Hole 容器，添加了额外的构建步骤，根据 Pi-Hole 团队直接提供的说明 将 Unbound 解析器直接安装到容器中。

设置

1. 在某处创建一个目录用于设置，例如 /opt/docker/pihole-unbound/。
2. 下载/复制 docker-compose.yaml 文件并放入此目录。
3. 在该目录中创建 .env 文件，用于替换部署的变量。

Pi-hole 环境变量

变量及描述复制自 官方 pihole 容器：

与 docker-compose.yaml 同目录的 .env 文件示例：

env
FTLCONF_LOCAL_IPV4=192.168.1.10
TZ=Europe/Copenhagen
WEBPASSWORD=QWERTY***asdfASDF
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

运行堆栈

bash
docker-compose up -d

如果使用 Portainer，只需将 docker-compose.yaml 内容粘贴到堆栈配置中，并在 UI 中直接添加环境变量。

配置 Pi-Hole

1. 打开 Pi-Hole 仪表盘（网页界面）。

在浏览器中，若在主机上访问，可前往 [***] 127.0.0.1 替换为运行 Pi-Hole 的机器的局域网 IPv4。

2. 打开“设置”菜单并导航至“DNS”选项卡。
3. 确保“上游 DNS 服务器”面板中的所有复选框均未勾选。
4. 勾选“自定义 1 (IPv4)”并将其值设置为 127.0.0.1#5335。
5. 点击页面底部的“保存”。

设置完成！接下来需将网络/设备配置为使用 Pi-Hole。

故障排除

本地设备使用 Pi-Hole 作为 DNS 时无网络/网络受限

尝试 ping google.com 和 8.8.8.8。如果 google.com 失败但 8.8.8.8 成功，可能是 Pi-Hole 的“仅允许本地请求”（位于“设置 > DNS > 接口设置”）未将本地设备识别为本地设备。将其改为“允许所有来源”可解决问题，但可能引入安全风险。根本原因需自行排查，此方法可帮助诊断 Pi-Hole 导致“网络中断”的问题。

本地构建镜像

• 将此仓库克隆到您的机器
• 运行以下命令

bash
cd docker-pihole-unbound
docker build . -t dev/docker-pihole-unbound:latest

使用 Github Actions 自动开发构建

我已设置 Github Action，在所有拉取请求上运行，构建并发布仓库中配置的镜像。该 Action 位于 .github/workflows/dev-build.yml。如需使用此功能，请评论您的仓库并标记我 (@aleksanderbl29)，我将为您运行工作流。

贡献者

感谢所有贡献者帮助改进此项目。