cspeers/technitium-dns-linux

Technitium DNS Server 容器镜像文档

镜像概述和主要用途

镜像概述

Technitium DNS Server 容器镜像是将 Technitium DNS Server 软件打包为 Docker 容器的分发形式。该软件是一款功能全面的跨平台 DNS 服务器，支持标准 DNS 协议及扩展功能，容器化部署使其具备环境隔离、快速启停、跨平台兼容等特性，简化了传统 DNS 服务的配置与维护流程。

主要用途

提供 DNS 域名解析服务，支持自定义域名规则、DNS 缓存、DNSSEC 验证、广告拦截等功能，适用于家庭网络、小型企业、开发测试环境等场景，满足从基础域名解析到高级 DNS 管理的多样化需求。

核心功能和特性

核心功能

• 标准 DNS 协议支持：兼容 UDP/TCP 53 端口，处理 A、AAAA、CNAME、MX、TXT 等各类 DNS 记录解析。
• DNSSEC 支持：提供 DNS 安全扩展（DNSSEC）验证与签名功能，增强域名解析的安全性。
• DNS 缓存机制：本地缓存解析结果，减少重复查询上游 DNS 服务器的延迟，提升解析效率。
• 灵活转发规则：支持配置上游 DNS 转发器（如 8.8.8.8、1.1.1.1），或基于域名/客户端 IP 自定义转发策略。
• Web 管理界面：内置 Web 控制台（默认端口 5380），支持可视化配置 DNS 规则、监控解析日志、管理客户端等。

容器特性

• 数据持久化：支持挂载宿主机目录存储配置文件、解析日志、缓存数据，容器重启后数据不丢失。
• 环境变量配置：通过环境变量快速设置管理员密码、端口映射等核心参数，无需手动修改配置文件。
• 多平台兼容：镜像支持 amd64、arm64 等主流架构，可运行于 Linux、Windows、macOS 等系统的 Docker 环境。

使用场景和适用范围

典型使用场景

• 家庭网络优化：自定义本地域名（如将 nas.local 解析到家庭 NAS 设备 IP）、拦截广告域名（通过阻止 ads.example.com 等域名解析）。
• 小型企业网络：作为内网 DNS 服务器，管理内部服务域名（如 server1.internal），避免依赖公网 DNS。
• 开发测试环境：快速搭建隔离的 DNS 环境，模拟特定域名解析结果（如将 test-api.com 指向本地开发服务器）。
• DNS 缓存加速：缓存常用域名解析结果，减少公网 DNS 查询延迟，提升网络访问速度。

适用范围

• 个人/家庭用户、小型企业 IT 管理员、开发/测试工程师。
• 网络环境：家庭宽带、小型局域网、虚拟化/容器化部署环境（如 Proxmox、Kubernetes 边缘节点）。

使用方法和配置说明

基本部署（docker run 命令）

通过 docker run 快速启动容器，需映射必要端口并配置持久化存储：

bash
docker run -d \
  --name technitium-dns \
  --restart always \
  -p 53:53/udp \  # DNS 服务端口（UDP）
  -p 53:53/tcp \  # DNS 服务端口（TCP，用于大报文解析）
  -p 5380:5380 \  # Web 管理界面端口
  -v /opt/technitium:/opt/technitium \  # 持久化数据目录
  -e ADMIN_PASSWORD="YourSecurePassword123" \  # 管理员密码
  technitium/dns-server

docker-compose 部署

通过 docker-compose.yml 配置文件管理服务，适合需要持久化配置或集成其他服务的场景：

yaml
version: '3.8'
services:
  technitium-dns:
    image: docker.xuanyuan.run/technitium/dns-server
    container_name: technitium-dns
    restart: always
    ports:
      - "53:53/udp"
      - "53:53/tcp"
      - "5380:5380"
    volumes:
      - ./technitium-data:/opt/technitium  # 宿主机当前目录下的 technitium-data 目录作为数据卷
    environment:
      - ADMIN_PASSWORD="YourSecurePassword123"  # 管理员密码（必填，建议强密码）
      - WEB_PORT=5380  # Web 管理界面端口（默认 5380，可自定义）
      - DNS_PORT=53  # DNS 服务端口（默认 53，需与宿主机映射端口一致）
      - LOG_LEVEL=info  # 日志级别（可选：debug/info/warn/error，默认 info）

启动命令：

bash
docker-compose up -d  # 后台启动服务

关键配置说明

1. 持久化存储

容器数据（配置文件、解析日志、缓存）默认存储于 /opt/technitium，需通过 -v 参数挂载宿主机目录实现持久化，避免容器删除后数据丢失。示例中 /opt/technitium（宿主机）映射到容器内同路径。

2. 端口映射

3. 环境变量配置

4. 自定义 DNS 配置

通过 Web 管理界面（http://宿主机IP:5380）完成核心配置：

• 转发器设置：进入「设置 > 转发器」，添加上游 DNS 服务器（如 8.8.8.8、1.1.1.1），实现公网域名解析。
• 本地记录管理：进入「记录 > 本地区域」，添加自定义 DNS 记录（如 nas.local A 192.168.1.100）。
• 广告拦截：进入「过滤器 > 阻止列表」，添加第三方广告域名列表（如 https://raw.githubusercontent.com/StevenBlack/hosts/master/hosts）。

5. 配置文件自定义

若需通过配置文件批量修改参数，可将宿主机自定义配置文件（如 config.json）挂载到容器 /opt/technitium/config 目录，覆盖默认配置。配置文件格式参考 Technitium DNS Server 官方文档。

访问与管理

1. Web 管理界面：容器启动后，通过 http://宿主机IP:5380 访问，使用 ADMIN_PASSWORD 登录。
2. 验证 DNS 服务：通过 nslookup 或 dig 工具测试解析功能：

   bash
   nslookup example.com 宿主机IP  # 替换为宿主机实际IP，验证基本解析
   

注意事项

• 端口冲突：宿主机若已运行 DNS 服务（如 systemd-resolved），需先停止该服务释放 53 端口，否则容器启动失败。
• 权限问题：挂载的宿主机目录需确保 Docker 容器有读写权限（建议设置目录权限为 755）。
• 防火墙规则：若宿主机启用防火墙（如 ufw、firewalld），需开放 53（UDP/TCP）和 5380（TCP）端口，允许内网/指定 IP 访问。

总结

Technitium DNS Server 容器镜像提供了一种轻量、灵活的 DNS 服务部署方案，通过简单的 Docker 命令即可快速搭建功能完善的 DNS 服务器，适用于家庭、小型企业及开发测试场景，满足自定义解析、缓存加速、安全增强等多样化需求。