lhstack/small-dns

lhstack/small-dns 镜像说明

镜像概述

lhstack/small-dns是一款轻量级DNS服务器镜像，具备资源占用低、配置灵活的特点，支持正则表达式解析、IP反向解析，兼容内网与公网解析需求，可部署于Docker、Docker Compose及Kubernetes环境。

核心功能

• 支持正则域名到IP解析
• 支持正则IP反向解析到域名
• 兼容内网与公网DNS解析
• 3.0.0+版本支持MySQL存储解析数据、Redis缓存
• 多版本兼容（1.0.0基础解析、2.0.0正则泛域名、3.0.0数据库缓存）
• 3.0.0+版本提供HTTP服务用于配置管理

使用场景

• 内网环境自定义域名解析管理
• 开发/测试环境快速搭建DNS服务
• 企业内部DNS解析规则定制
• Kubernetes集群内DNS服务配置

配置说明

1.0.0版本（基础解析）

基于JSON配置文件实现固定域名与IP映射。
Docker Run示例：

shell
docker run --name small-dns --restart=always -p 53:53/udp -v ${PWD}/config:/config -e LOCAL_DNS_RESOLVE_CONFIG="/config/config.json" -d lhstack/small-dns:1.0.0

Docker Compose示例：

yaml
version: '3'
services:
  small-dns:
    image: lhstack/small-dns:1.0.0
    restart: always
    container_name: small-dns
    ports:
    - '53:5300/udp'
    environment:
      DNS_LISTEN_ADDRESS: ":5300"
      LOCAL_DNS_RESOLVE_CONFIG: "/config/config.json"
      DNS_REMOTE_RESOLVE_ADDRESS: "114.114.114.114:53,8.8.8.8:53"
    volumes:
    - ./config:/config
    logging:
      options:
        max-file: '1'
        max-size: 16k
    deploy:
      resources:
        limits:
          cpus: '0.1'
          memory: 16M

2.0.0版本（正则解析）

兼容1.0.0功能，新增正则与泛域名支持。
配置文件示例（config.json）：

json
[
  {
    "type": "Ptr",
    "names": ["127.0.0.1", "192\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}"],
    "ttl": 600,
    "values": ["www.lhstack.com", "lhstack.com"],
    "ordered": 1
  },
  {
    "type": "Ipv4",
    "names": ["[\\d\\w]*\\.lhstack\\.com"],
    "ttl": 300,
    "values": ["192.168.2.188"],
    "ordered": 2
  }
]

Docker Compose示例：

yaml
version: '3'
services:
  small-dns:
    image: lhstack/small-dns:2.0.0
    restart: always
    container_name: small-dns
    network_mode: host
    environment:
      DNS_LISTEN_ADDRESS: ":53"
      DNS_REPO_TYPE: HighLevelLocal
      HIGH_LEVEL_LOCAL_DNS_RESOLVE_CONFIG: "/config/config.json"
      DNS_REMOTE_RESOLVE_ADDRESS: "114.114.114.114:53,8.8.8.8:53"
      HIGH_LEVEL_LOCAL_DNS_RESOLVE_CONFIG_CHECK_INTERVAL_SECONDS: "5"
    volumes:
    - ./config:/config
    logging:
      options:
        max-file: '1'
        max-size: 16k
    deploy:
      resources:
        limits:
          cpus: '0.1'
          memory: 16M

3.0.0+版本（数据库缓存）

新增MySQL存储、Redis缓存及HTTP管理服务。
Docker Compose示例：

yaml
services:
  dns:
    image: lhstack/small-dns:3.0.0
    container_name: small-dns
    restart: always
    ports:
      - "5300:53/udp"
      - "80:80"
    deploy:
      resources:
        limits:
          cpus: "0.1"
          memory: "8M"
    volumes:
      - ./logs:/app/logs
    environment:
      LOG_OUT_TYPE: '1'
      ENABLE_CACHE: "true"
      REDIS_HOST: "192.168.17.128:6379"
      REDIS_PASS: "123456"
      REDIS_DB: "1"
      DB_USERNAME: "root"
      DB_PASSWORD: "123456"
      DB_HOST: "192.168.17.128:3306"
      DB_NAME: "dns"
      DB_LOG_LEVEL: "4"
      HTTP_SERVER_LISTEN_PORT: 80
      HTTP_SERVER_BASIC_ENABLE: true

关键环境变量说明：

• LOG_OUT_TYPE：日志输出类型（0:不输出/1:控制台/2:文件）
• ENABLE_CACHE：是否开启Redis缓存
• REDIS_HOST：Redis服务地址
• DB_USERNAME：MySQL用户名
• HTTP_SERVER_BASIC_ENABLE：是否开启HTTP Basic认证

Kubernetes部署示例

yaml
apiVersion: v1
kind: Namespace
metadata:
  name: dns
---
apiVersion: v1
kind: ConfigMap
metadata:
  name: dns
  namespace: dns
data:
  config.json: |
    [
      {
        "type": "Ptr",
        "names": ["127.0.0.1", "192\\.\\d{1,3}\\.\\d{1,3}\\.\\d{1,3}"],
        "ttl": 600,
        "values": ["[***]", "lhstack.com"]
      },
      {
        "type":"Ipv4",
        "names":["www.github.com", "github.com"],
        "ttl":600,
        "values":["20.205.243.166", "140.82.112.4"]
      }
    ]
---
apiVersion: v1
kind: ConfigMap
metadata:
  name: small-dns-env
  namespace: dns
data:
  DNS_LISTEN_ADDRESS: ":53"
  DNS_REPO_TYPE: HighLevelLocal
  HIGH_LEVEL_LOCAL_DNS_RESOLVE_CONFIG: "/config/config.json"
  DNS_REMOTE_RESOLVE_ADDRESS: "10.43.0.10:53,114.114.114.114:53"
---
apiVersion: v1
kind: Pod
metadata:
  name: dns
  namespace: dns
  labels:
    app: dns
spec:
  containers:
  - name: small-dns
    image: lhstack/small-dns
    ports:
    - name: udp
      containerPort: 53
      protocol: UDP
    envFrom:
    - configMapRef:
        name: small-dns-env
    volumeMounts:
    - name: config
      mountPath: /config
    resources:
      limits:
        cpu: 20m
        memory: 16Mi
  volumes:
  - name: config
    configMap:
      name: dns
---
apiVersion: v1
kind: Service
metadata:
  name: dns
  namespace: dns
spec:
  type: ClusterIP
  ports:
  - name: udp
    port: 53
    protocol: UDP
  selector:
    app: dns