uip9av6y/nsd

NSD镜像使用说明

镜像概述

本镜像提供NSD（仅权威、高性能、简单的开源域名服务器），基于Docker官方Alpine镜像构建，遵循BSD开源许可证，专注于提供高效的权威域名解析服务。

核心功能

• 仅权威解析：专注于响应域名记录的权威查询，不处理递归请求
• 高性能优化：支持多线程运行（可配置线程数）和SO_REUSEPORT网络优化
• 灵活配置：通过挂载卷自定义配置文件与区域文件，支持环境变量设置访问密钥等参数
• 安全支持：自动生成SSL证书用于nsd-control工具的安全通信

使用场景

• 企业内部权威DNS服务器部署
• 个人/小型项目的域名解析服务
• 需要高性能权威DNS的场景

配置说明

挂载卷

• /etc/nsd/conf.d：存放自定义配置文件，内容会被包含到NSD主配置中
• /etc/nsd/zones.d：存放区域文件（如域名解析记录）
• /etc/nsd/server-conf.d：存放服务器级配置（仅允许单个server块）

环境变量

• DISABLE_CONTROL_SETUP：禁用nsd-control的SSL证书生成
• LAZY_CONTROL_SETUP：结合DISABLE_CONTROL_SETUP使用，仅在证书不存在时生成
• SERVER_COUNT：线程数，默认等于CPU核心数
• DISABLE_REUSEPORT：禁用SO_REUSEPORT选项
• ACCESS_KEY_*：前缀为ACCESS_KEY_的变量用于设置通信密钥，格式：名称 算法 base64密钥（如ACCESS_KEY_transfer="transfer hmac-sha256 6KM6qiKfwfEpamEq72HQdA=="）

部署示例

Docker Run命令

bash
docker run -d --name my-running-nsd \
  --mount type=bind,source=$PWD/config,destination=/etc/nsd/conf.d \
  --mount type=bind,source=$PWD/zones,destination=/etc/nsd/zones.d \
  --env ACCESS_KEY_transfer='transfer hmac-sha256 6KM6qiKfwfEpamEq72HQdA==' \
  uip9av6y/nsd:latest

Docker Compose示例

yaml
version: '3'
services:
  nsd:
    image: uip9av6y/nsd:latest
    volumes:
      - ./config:/etc/nsd/conf.d
      - ./zones:/etc/nsd/zones.d
    environment:
      - ACCESS_KEY_transfer=transfer hmac-sha256 6KM6qiKfwfEpamEq72HQdA==
    ports:
      - "53:53/udp"
      - "53:53/tcp"

许可证说明

NSD软件遵循BSD许可证，基础镜像Alpine及其他依赖软件的许可证请参考各自官方文档。用户需确保使用本镜像符合所有相关许可证要求。 ===END===