云原生运维后端容器编排【免费下载链接】all-in-one The official Nextcloud installation method. Provides easy deployment and maintenance with most features included in this one Nextcloud instance.项目地址https://gitcode.com/GitHub_Trending/al/all-in-one点击查看免费下载Nextcloud All-in-OneAIO官方仓库通过社区容器机制提供开箱即用的 Pi-hole 广告拦截器集成只需在 AIO 界面勾选启用系统便会自动拉取并配置pihole/pihole容器同时把 Web 管理面板、DNS 端口 53 和备份流程一并打通。读完本文你将掌握 Pi-hole 容器在 AIO 中的启用方法、pi-hole.json各项配置参数的底层含义、端口冲突排查技巧以及如何把整条家庭网络的 DNS 查询交给 Pi-hole 接管。社区容器与 Pi-hole 的定位在 community-containers/readme.md 中AIO 官方将社区容器定义为专为 AIO 构建、用于快速扩展额外功能的容器集合。从 v11 版本开始社区容器的启停管理已完全集成到 AIO 的 Web 界面界面最下方的 Community Containers 区块。Pi-hole 属于其中 Security Network安全与网络类别的社区容器在界面中显示名为Pi-hole。与内置容器不同社区容器由社区维护Pi-hole 的维护者为 szaimenAIO 官方在 community-containers.twig 中明确提示启用前必须逐一阅读对应容器的文档因为部分容器彼此不兼容盲目全开可能破坏整个 AIO 栈的启动。Pi-hole 正是这类有兼容性约束的典型代表。如何将 Pi-hole 添加到 AIO 栈通过 AIO 界面启用推荐登录 AIO 管理界面滚动到底部的Community Containers区块在容器列表中勾选Pi-hole勾选前请务必先阅读其文档点击Save changes保存。注意界面仅在容器全部停止时允许修改选项且社区容器的修改不会自动保存必须手动点击保存按钮回到主界面启动全部容器AIO 会自动完成pihole/pihole镜像的拉取与容器编排。界面背后AIO 的配置存储依赖 ConfigurationManager.php 中的aio_community_containers配置项以空格分隔的容器标识列表。被启用的社区容器会在启动编排时被动态并入容器定义。从仓库定位定义文件Pi-hole 容器的一切行为都声明在 community-containers/pi-hole/pi-hole.json 中这是 AIO 运行时读取的唯一数据源community-containers/pi-hole/readme.md 则提供了该容器的使用说明与注意事项。如果你希望为其他社区容器编写定义可参考 containers-schema.json 中的 JSON Schema 校验规则以及内置容器的完整定义 containers.json。深入解析 pi-hole.json 容器定义pi-hole.json采用aio_services_v1结构声明了一个名为nextcloud-aio-pihole的服务。逐字段拆解如下字段取值说明container_namenextcloud-aio-piholeAIO 命名规范要求以nextcloud-aio-前缀开头见 containers-schema.json 中container_name的正则约束display_namePi-hole在 AIO 界面中展示的名称image/image_tagpihole/pihole/latest上游官方镜像跟随 latest 标签滚动更新internal_port8573容器内部 Web 服务端口AIO 用于健康检查与界面关联restartunless-stopped容器退出后自动重启策略initfalse不注入 init 进程Pi-hole 镜像自带进程管理端口映射TCP/UDP 53 与 8573ports: [ { ip_binding: , port_number: 53, protocol: tcp }, { ip_binding: , port_number: 53, protocol: udp }, { ip_binding: , port_number: 8573, protocol: tcp } ]53/tcp 与 53/udpDNS 服务端口ip_binding为空表示绑定主机所有网卡这正是仅限家庭网络警告的技术根源——端口 53 一旦暴露到公网Pi-hole 就会被任何网络上的设备当作公开 DNS 递归服务器使用8573/tcpWeb 管理面板端口与internal_port对应。AIO 在运行时通过 ContainerDefinitionFetcher.php 将 ports 字段解析为ContainerPorts集合再交由 Docker 编排创建端口绑定。环境变量自动配置的四个关键项environment: [ TZ%TIMEZONE%, FTLCONF_webserver_api_password%PIHOLE_WEBPASSWORD%, FTLCONF_dns_listeningModeall, FTLCONF_webserver_port8573 ]TZ%TIMEZONE%时区由 AIO 全局配置注入占位符替换机制FTLCONF_webserver_api_password%PIHOLE_WEBPASSWORD%管理面板的 API 密码由 AIO 自动生成FTLCONF_dns_listeningModeall让 DNS 服务监听所有网络接口家庭局域网内各设备均可查询FTLCONF_webserver_port8573将 Pi-hole 的 Web 服务固定在 8573 端口与端口映射保持一致。这些%大写%占位符会在容器启动时由 AIO 运行时解析其机制与 AioVariables.php 及 ContainerEnvironmentVariables.php 中的变量处理逻辑一致。数据卷与备份集成volumes: [ { source: nextcloud_aio_pihole, destination: /etc/pihole, writeable: true }, { source: nextcloud_aio_pihole_dnsmasq, destination: /etc/dnsmasq.d, writeable: true } ], backup_volumes: [ nextcloud_aio_pihole, nextcloud_aio_pihole_dnsmasq ]nextcloud_aio_pihole挂载到/etc/pihole存放 Pi-hole 的核心配置广告列表、白名单、本地 DNS 记录等nextcloud_aio_pihole_dnsmasq挂载到/etc/dnsmasq.d存放 dnsmasq 扩展配置backup_volumes显式声明这两个卷自动纳入 AIO 的备份方案——这正是原文档强调Pi-hole 数据会自动包含在 AIO 备份中的底层实现依据。密码的秘密管理机制ui_secret: PIHOLE_WEBPASSWORD, secrets: [ PIHOLE_WEBPASSWORD ]PIHOLE_WEBPASSWORD是 Pi-hole 管理员的随机密码。AIO 在解析容器定义时见 ContainerDefinitionFetcher.php会把secrets中的每个密钥注册进配置管理器ConfigurationManager.php 的registerSecret并在首次使用时生成随机值ui_secret则将该密钥关联到容器 Web 界面使 AIO 能在容器旁显示这个管理密码。因此你无需手动设置密码登录 Pi-hole 面板时直接查看 AIO 界面中该容器旁展示的 admin key 即可。部署前必须确认的约束与冲突原文档用多条 Notes 划定了 Pi-hole 容器的使用边界这些约束全部可以映射到上面的容器定义中1. 只允许运行在家庭网络禁止部署在公网 VPS由于ip_binding为空、端口 53 直接绑定全部网卡一旦部署在公网服务器上Pi-hole 就会成为任何人都可访问的开放 DNS 解析器存在被滥用为 DNS 放大攻击源的风险。因此该容器只适用于路由器背后的家庭局域网。2. 与 dnsmasq 社区容器不兼容Pi-hole 与 dnsmasq 社区容器 都需要占用主机端口 53dnsmasq 的定义见 dnsmasq.json其internal_port为host两者同时启用必然导致端口冲突、容器无法启动。同一时间只能启用其中一个。3. 确保主机 53 端口空闲启用前先执行以下命令确认没有其他 DNS 服务占用端口sudo netstat -tulpn | grep 53如果输出显示已有进程监听 53 端口例如系统自带的 systemd-resolved 或已运行的 dnsmasq必须先停止或禁用该服务否则 Pi-hole 容器将无法绑定端口而启动失败。4. DHCP 功能已被禁用Pi-hole 自带的 DHCP 服务器功能在该容器中不会启用避免与家庭路由器或网络上既有 DHCP 服务产生冲突。需要分配 IP 时请继续使用路由器自身的 DHCP。部署后的三步接线让设备真正用上 Pi-hole容器启动后按照原文档的指引完成以下配置即可让整条家庭网络生效第一步登录管理面板完成初始化配置在浏览器中访问http://ip.address.of.this.server:8573/admin用 AIO 界面中该容器旁边显示的 admin key 登录。在这里你可以配置 Pi-hole 的广告拦截策略、添加本地 DNS 记录例如把内部服务的域名解析到局域网 IP。第二步配置路由器让客户端走 Pi-hole 解析进入家庭路由器的管理界面把 DHCP 下发的 DNS 服务器地址改为运行 AIO 的那台服务器 IP即 Pi-hole 容器的宿主地址。这样局域网内所有设备都会自动向 Pi-hole 发起 DNS 查询实现全网络广告拦截。第三步可选让 Docker 守护进程也使用 Pi-hole编辑/etc/docker/daemon.json加入 DNS 配置{ dns: [ ip.address.of.this.server, 8.8.8.8 ] }保存后重启 Docker 服务sudo systemctl restart docker即可生效。这样 AIO 所在主机上的其他容器在解析域名时也会优先通过 Pi-hole 完成查询保证包括 Nextcloud 自身在内的容器流量同样经过广告过滤。8.8.8.8作为兜底上游避免 Pi-hole 出现故障时容器完全无法解析。移除 Pi-hole 容器与清理残留数据当不再需要 Pi-hole 时可以直接在 AIO 界面的 Community Containers 区块取消勾选并保存然后停止并移除容器。若希望彻底清理服务器上的残留按 community-containers/readme.md 的指引依次执行# 1. 删除容器实例容器名按实际调整 sudo docker rm nextcloud-aio-pihole # 2. 清理不再使用的镜像 sudo docker image prune -a # 3. 查看并删除对应的持久化数据卷 sudo docker volume ls sudo docker volume rm nextcloud_aio_pihole nextcloud_aio_pihole_dnsmasq执行第 3 步前务必确认卷名确实对应 Pi-hole即nextcloud_aio_pihole与nextcloud_aio_pihole_dnsmasq因为删除数据卷会永久丢失其内的 Pi-hole 配置与统计历史。如果没有服务器的 CLI 访问权限也可以借助 container-management 社区容器在 Web 会话中执行这些 Docker 命令。容器定义在 AIO 运行时的加载原理从源码层面看Pi-hole 之所以能即勾即用依赖的是 ContainerDefinitionFetcher.php 的合并机制运行时根据aio_community_containers配置逐一读取community-containers/名称/名称.json并通过array_merge_recursive将其与内置的containers.json定义合并随后统一解析端口、卷、环境变量、依赖与密钥。因此任何社区容器包括 Pi-hole的启用、启动编排、健康检查与备份走的都是与内置容器完全相同的代码路径——这也解释了为什么 Pi-hole 的数据能够无缝融入 AIO 的备份方案。需要留意的是该合并逻辑同样会校验容器间的依赖关系当某个已启用的社区容器依赖了未启用的其他社区容器时相关依赖会被跳过ContainerDefinitionFetcher.php。Pi-hole 本身未声明depends_on它只依赖宿主机的 53 端口可用因此部署成败的关键仍在于端口冲突的排查。小结Pi-hole 社区容器为 Nextcloud All-in-One 用户提供了一行勾选、全自动配置的广告拦截方案AIO 负责镜像拉取、端口绑定、密码生成与数据备份你只需要完成路由器与 Docker 守护进程的 DNS 指向即可全网络生效。牢记三条红线——仅限家庭网络、不与 dnsmasq 同开、启用前检查 53 端口占用——就能稳定运行这套 DNS 广告拦截体系。赞分享云原生运维后端容器编排【免费下载链接】all-in-one The official Nextcloud installation method. Provides easy deployment and maintenance with most features included in this one Nextcloud instance.项目地址https://gitcode.com/GitHub_Trending/al/all-in-one点击查看免费下载相关推荐Docker Pi-hole打造高效的家庭网络广告拦截器Docker Pi hole打造高效的家庭网络广告拦截器 项目介绍 Docker Pi hole 是一个基于 Docker 的轻量级 x86 和 ARM 容器网络安全后端彻底拦截家庭网络广告极简配置指南彻底拦截家庭网络广告极简配置指南 家庭网络中无处不在的广告不仅影响浏览体验还可能泄露隐私数据。本文将通过问题 方案 优化三段式框架帮助家庭用户利用智能网络安全探秘网络广告拦截利器Pi-hole 及 FTLDNS探秘网络广告拦截利器Pi hole 及 FTLDNS ! Pi hole Logo https://pi hole.github.io/graphics/Vo上一篇ComfyUI-VideoHelperSuite视频加载失败3步快速修复与完整预防指南下一篇终极指南如何免费解锁Wand Pro版功能告别时间限制创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考