patterns/sinkhole

sinkhole镜像说明

镜像概述

patterns/sinkhole是一个DNS sinkhole工具，基于***的域名黑名单生成逻辑，采用Golang实现，可拦截广告、***网站等不需要的域名解析，帮助用户净化网络环境。

核心功能

• 基于域名黑名单拦截指定域名，返回0.0.0.0阻止访问
• 支持通过构建参数或自定义配置文件设置服务端口
• 兼容dig等常见DNS查询工具，方便验证拦截效果
• 基于开源组件构建，透明合规且易于扩展

使用场景

• 个人/家庭网络：拦截广告、追踪域名，提升浏览体验
• 企业内部网络：过滤***网站，保障网络安全
• 开发测试环境：控制特定域名的解析结果，模拟网络场景

配置与部署

快速启动

1. 安装Docker（https://docker.com/%EF%BC%89
2. 克隆仓库：git clone https://github.com/patterns/sinkhole/
3. 构建并运行镜像：

bash
cd sinkhole
docker build -t sinkhole .
docker run -ti -p 5300:5300/udp sinkhole

4. 验证基础DNS解析：

bash
dig @127.0.0.1 -p 5300 adafruit.com

该命令会返回正常IP地址（如104.20.38.240或104.20.39.240）。

5. 验证拦截效果：

bash
dig @127.0.0.1 -p 5300 doubleclick.net

返回0.0.0.0表示拦截成功。

端口配置

方式1：通过构建参数设置

bash
docker build --build-arg PORT=5353 -t sinkhole .

方式2：使用自定义配置文件

1. 下载示例配置文件：

bash
curl -o dns.toml https://github.com/DNSCrypt/dnscrypt-proxy/blob/master/dnscrypt-proxy/example-dnscrypt-proxy.toml

2. 编辑配置文件，修改绑定端口（搜索bind行，如[127.0.0.1:5353]）
3. 运行镜像并挂载配置：

bash
docker run -ti -p 5353:5353/udp -v $(pwd):/opt/mydns sinkhole -c /opt/mydns/dns.toml

Credits

• dnscache from djbdns
• *** Argo Tunnel by https://github.com/***%EF%BC%88https://github.com/***/blob/master/LICENSE%EF%BC%89
• DNS library by https://github.com/miekg/dns%EF%BC%88https://github.com/miekg/dns/blob/master/LICENSE%EF%BC%89
• *** by https://github.com/dnscrypt/***%EF%BC%88https://github.com/DNSCrypt/***/blob/master/LICENSE%EF%BC%89
• Unbound image by https://gitlab.com/klutchell/unbound%EF%BC%88https://gitlab.com/klutchell/unbound/blob/master/LICENSE%EF%BC%89
• https://github.com/oznu/dns-zone-blacklist
• Unified hosts file by https://github.com/StevenBlack/hosts%EF%BC%88https://github.com/StevenBlack/hosts/blob/master/license.txt%EF%BC%89
• Pi-hole guide on recursive DNS
• https://wiki.archlinux.org/index.php/unbound#Domain_blacklisting
• sync/errgroup

注意事项

- 支持树莓派4（arm64架构）
- Ubuntu-server arm64部署步骤：
  - 查看网络接口：ip a（wlan0）
  - 配置无线网络：/etc/netplan/wireless.yaml（参考/usr/share/doc/cloud-init/examples）
  - 应用网络配置：sudo netplan --debug try/generate/apply
  - 系统更新：sudo apt update -y && sudo apt upgrade -y && sudo apt dist-upgrade -y
  - 安装unbound：sudo apt install -y unbound
  - 配置pihole规则：sudo vi /etc/unbound/unbound.conf.d/pihole.conf（参考Pi-hole递归DNS指南）
  - 下载黑名单：curl -o unbound.bl https://raw.githubusercontent.com/oznu/dns-zone-blacklist/master/unbound/unbound.blacklist
  - 停止systemd-resolved：sudo systemctl stop systemd-resolved
  - 编辑resolved配置：sudo vi /etc/systemd/resolved.conf
  - 链接resolv.conf：sudo ln -sf /run/systemd/resolve/resolv.conf /etc/resolv.conf
  - 开放防火墙端口：sudo ufw allow in on wlan0 from 192.168.0.0/16 to any port53
  - 启用防火墙：sudo ufw enable && sudo ufw status
  - 添加hosts记录：sudo echo "127.0.0.1 pihole" >> /etc/hosts
  - 修改主机名：sudo rm /etc/hostname && echo pihole > /etc/hostname
  - 可选：禁用cloud-init：touch /etc/cloud/cloud-init.disabled