zeekzag/stubby

zeekzag/stubby 镜像说明

镜像概述

基于Alpine Linux的多架构Stubby容器镜像，用于运行Stubby服务实现安全的DNS over TLS（DoT）解析。默认采用Quad9（9.9.9.9）DNS服务器，兼容Cloudflare、NextDNS等其他主流服务商。

核心功能

• 多架构适配：支持多种硬件架构运行
• 加密解析：通过TLS协议加密DNS查询，保护用户隐私
• 灵活切换：默认使用Quad9，可轻松替换为其他合规DNS服务商
• 自定义配置：允许挂载本地stubby.yml文件调整解析规则

使用场景

• 个人或家庭网络的安全DNS解析需求
• 增强网络隐私防护，避免DNS查询被监听或篡改
• 与Pi-hole等网络工具配合，构建更安全的家庭网络环境

配置说明

1. 时区设置：通过TZ环境变量指定时区（例如Asia/Shanghai）
2. 自定义DNS：挂载本地stubby.yml文件到容器内/etc/stubby/stubby.yml路径（只读模式）

部署示例

默认配置Docker Compose

yaml
version: "3.9"
services:
  stubby:
    container_name: stubby
    hostname: stubby
    image: zeekzag/stubby:latest
    ports:
      - target: 53
        published: 53
        protocol: tcp
        mode: host
      - target: 53
        published: 53
        protocol: udp
        mode: host
    environment:
      # 替换为你的时区
      TZ: Asia/Shanghai
    restart: always

挂载自定义配置文件

在Compose文件中添加卷挂载配置：

yaml
    volumes: 
      - type: bind
        source: /home/${USER}/dns/stubby.yml # 本地配置文件路径
        target: /etc/stubby/stubby.yml
        read_only: true

参考https://gitlab.com/zeekzag/pi-hole-tls/-/raw/master/stubby.yml%EF%BC%8C%E5%85%B6%E4%B8%AD%E9%A2%84%E9%85%8D%E7%BD%AE%E4%BA%86%E5%A4%9A%E4%B8%AADNS%E6%9C%8D%E5%8A%A1%E5%95%86%EF%BC%8C%E5%8F%96%E6%B6%88%E6%B3%A8%E9%87%8A%E5%8D%B3%E5%8F%AF%E4%BD%BF%E7%94%A8%E6%88%96%E6%B7%BB%E5%8A%A0%E8%87%AA%E5%AE%9A%E4%B9%89%E6%9C%8D%E5%8A%A1%E5%95%86%E3%80%82