Radio DNS Server 镜像文档

镜像概述和主要用途

Radio DNS Server 是一个基于 Python 的 DNS 服务器镜像，专为配合 Radio API 使用而设计。其核心功能是将包含 wifiradiofrontier.com 的 DNS 查询解析到指定的 Radio API 服务地址，同时支持上游 DNS 转发、查询来源限制等功能。该镜像由 GitHub 仓库 KIMB-technologies/Radio-DNS-Server 通过 GitHub Action 构建，Docker 镜像托管于 Docker Hub。

核心功能和特性

1. 定向域名解析：将所有包含 wifiradiofrontier.com 的 DNS 查询解析到指定的 Radio API 地址（支持通过域名或 IP 指定）。
2. 灵活地址配置：支持通过 RADIO_DOMAIN（域名）或 RADIO_IP（IP 地址）指定 Radio API 位置，RADIO_DOMAIN 优先级高于 RADIO_IP。
3. 上游 DNS 转发：可配置上游 DNS 服务器（SERVER_UPSTREAM），用于转发非目标域名的查询。
4. 查询来源限制：通过 ALLOWED_DOMAIN 限制仅响应指定域名对应的 IP 来源的查询，提升安全性。
5. 时间服务器解析：针对 time.wifiradiofrontier.com 的查询，可解析到 TIME_SERVER 指定的域名地址。

使用场景和适用范围

适用于需要将 wifiradiofrontier.com 域名解析到自定义 Radio API 服务的场景，例如：

• 本地网络中部署 Radio API 时，需设备通过该域名访问服务；
• 开发或测试环境中，需定向解析特定域名至测试服务器；
• 需限制 DNS 查询来源，仅允许可信设备访问的场景（如家庭网络、小型企业网络）。

使用方法和配置说明

环境变量配置

所有配置通过环境变量实现，具体参数说明如下：

Docker 部署示例

1. docker run 命令示例

以下示例通过 RADIO_IP 指定 Radio API 地址为 192.168.1.100，允许所有来源查询：

bash
docker run -d \
  --name radio-dns \
  -p 53:53/udp \  # DNS 默认使用 UDP 协议，需映射 UDP 端口
  -e RADIO_IP=192.168.1.100 \  # 替换为实际 Radio API IP
  -e ALLOWED_DOMAIN=all \  # 允许所有来源（适合本地网络测试）
  kimbtechnologies/radio_dns

若需通过域名指定 Radio API（如 radio-api.example.com），并限制仅 trusted.example.com 来源的查询：

bash
docker run -d \
  --name radio-dns \
  -p 53:53/udp \
  -e RADIO_DOMAIN=radio-api.example.com \  # Radio API 域名
  -e ALLOWED_DOMAIN=trusted.example.com \  # 仅允许该域名解析的 IP 发起查询
  -e SERVER_UPSTREAM=8.8.8.8 \  # 上游 DNS 使用 Google DNS
  kimbtechnologies/radio_dns

2. docker-compose 配置示例

创建 docker-compose.yml 文件，配置如下：

yaml
version: '3'
services:
  radio-dns:
    image: kimbtechnologies/radio_dns
    container_name: radio-dns
    ports:
      - "53:53/udp"  # 映射 UDP 53 端口
    environment:
      - RADIO_DOMAIN=radio-api.local  # 本地 Radio API 域名
      - ALLOWED_DOMAIN=home.example.com,iot.example.com  # 允许两个可信域名来源
      - SERVER_PORT=53  # 默认 DNS 端口
      - TIME_SERVER=time.example.com  # 自定义时间服务器域名
    restart: unless-stopped  # 容器退出时自动重启

启动服务：

bash
docker-compose up -d

技术依赖和说明

• 基础镜像：基于 Alpine Linux 构建，体积轻量。
• 运行环境：Python 3。
• 核心依赖：
  • DnsLib：Python DNS 协议处理库。
• 代码参考：部分逻辑参考自 DNSServer（MIT 许可，Copyright (c) 2017 Samuel Colvin）。
• 正则表达式：使用 Validators 项目的正则模式（MIT 许可，Copyright (c) 2013-2014 Konsta Vesterinen）。