djlactose/dnsmasq

DNS MASQ 镜像文档

镜像概述

DNS MASQ容器旨在简化容器环境中的DNS服务器管理，提供便捷的DNS服务部署与配置方式，适用于需要在容器化环境中快速搭建和管理DNS服务的场景。

核心功能与特性

持久化存储

• 存储路径：/etc/dnsmasq.d/hosts
  该路径用于持久化存储DNS条目，确保容器重启后DNS配置不丢失。

端口说明

• 53/TCP：当UDP协议不可用或被阻止时使用的DNS端口
• 53/UDP：标准DNS服务端口，用于处理DNS查询请求
• 8000：Web管理界面端口，提供可视化配置与管理功能

使用场景

• 容器化开发/测试环境中的本地DNS服务搭建
• 小型网络环境中的DNS解析与管理
• 需要快速部署且配置简单的DNS服务场景

使用方法

基本部署（Docker Run）

bash
docker run -d \
  -p 53:53/udp \  # 映射标准DNS UDP端口
  -p 53:53/tcp \  # 映射DNS TCP端口（可选，根据环境需求）
  -p 8000:8000 \  # 映射Web管理界面端口
  -v /path/on/host:/etc/dnsmasq.d/hosts \  # 挂载本地目录持久化DNS条目
  --name dnsmasq \
  dnsmasq-image:latest

说明：/path/on/host需替换为本地实际存储DNS条目的目录路径。

Docker Compose 配置示例

yaml
version: '3'
services:
  dnsmasq:
    image: dnsmasq-image:latest
    ports:
      - "53:53/udp"
      - "53:53/tcp"
      - "8000:8000"
    volumes:
      - ./dnsmasq-hosts:/etc/dnsmasq.d/hosts  # 本地目录映射
    restart: always

配置说明

DNS条目通过持久化存储目录下的文件进行管理，直接编辑挂载的hosts文件即可添加/修改DNS记录，格式遵循标准hosts文件规范（如IP地址 域名）。修改后无需重启容器，服务会自动加载更新后的配置。