milindpatel63/pihole-dot-doh

jacklul pihole 镜像文档

镜像概述

jacklul pihole镜像是一个集成Cloudflare Tunnel的pihole解决方案，旨在提供安全的远程访问能力，避免将pihole Web UI直接暴露到公网环境。该镜像基于pihole核心功能，结合Cloudflare Tunnel的安全隧道技术，实现便捷且安全的远程管理。

核心功能与特性

• 广告拦截与DNS管理：保留pihole核心功能，包括网络广告拦截、自定义DNS规则、域名过滤等
• 内置Cloudflare Tunnel：集成Cloudflare Tunnel服务，无需端口转发即可实现远程访问
• 安全访问：避免将Web UI直接暴露到公网，通过Cloudflare网络安全中转，降低被***风险
• 简化部署：一站式解决方案，无需单独配置pihole和Cloudflare Tunnel，减少部署复杂度

使用场景与适用范围

• 家庭网络管理：家庭用户需要远程管理pihole广告拦截规则，同时不想暴露家庭网络端口
• 小型办公环境：小型办公网络中，管理员需远程维护pihole配置，确保网络安全
• 隐私保护需求：对网络安全和隐私有较高要求，希望避免公网直接访问内部服务的场景

使用方法与配置说明

基本部署（docker run）

bash
docker run -d \
  --name jacklul-pihole \
  -e TZ=Asia/Shanghai \
  -e CLOUDFLARE_TOKEN=your_cloudflare_api_token \
  -e CLOUDFLARE_TUNNEL_NAME=pihole-tunnel \
  -v pihole_data:/etc/pihole \
  -v dnsmasq_data:/etc/dnsmasq.d \
  --restart=unless-stopped \
  docker.xuanyuan.run/jacklul/pihole-cloudflare-tunnel

环境变量说明

docker-compose配置示例

yaml
version: '3'

services:
  pihole:
    image: docker.xuanyuan.run/jacklul/pihole-cloudflare-tunnel
    container_name: jacklul-pihole
    environment:
      - TZ=Asia/Shanghai
      - CLOUDFLARE_TOKEN=your_cloudflare_api_token
      - CLOUDFLARE_TUNNEL_NAME=pihole-tunnel
      - PIHOLE_PASSWORD=your_secure_password
    volumes:
      - pihole_data:/etc/pihole
      - dnsmasq_data:/etc/dnsmasq.d
    restart: unless-stopped

volumes:
  pihole_data:
  dnsmasq_data:

远程访问方法

1. 确保Cloudflare Tunnel配置成功（可通过容器日志查看Tunnel连接状态）
2. 通过Cloudflare Dashboard中配置的域名或Tunnel URL访问pihole Web UI
3. 使用设置的PIHOLE_PASSWORD登录管理界面

注意事项

• 需提前在Cloudflare账户中创建API令牌，并赋予Tunnel管理权限
• 首次启动时，容器会自动配置Cloudflare Tunnel，可能需要几分钟时间完成初始化
• 数据卷挂载确保pihole配置和数据持久化，避免容器重启后配置丢失