Skip to content

cucker0/BindUI

BranchesTags

Repository files navigation

BindUI

Bind web admin UI.

这是一款基于BIND和WEB的智能DNS域名管理系。使用BIND + DLZ + MySQL/PostgreSQL + Django + Spring Boot技术进行开发。 支持常用的DNS记录类型、多线路智能解析（基于view实现的智能DNS）、批量导入/导出域名记录(RR)，并额外扩展了对HTTP URL转发的显性URL、隐性URL记录的支持。 降低了域名的管理和使用成本，成为一款易用的企业级域名管理系统。

快速体验

docker run -d --name dns \
 --restart=always \
 -p 53:53/udp \
 -p 53:53/tcp \
 -p 127.0.0.1:953:953/tcp \
 -p 80:80/tcp \
 -p 8000:8000/tcp \
 cucker/dns:latest
  • BindUI Account Info 
    url：http://<IP>:8000
user：admin
password：Dns123456!
  • Port Info 
    EXPOSE 53/udp 53/tcp 953/tcp 80/tcp 8000/tcp 3306/tcp
53/udp -> bind
53/tcp -> bind
953/tcp -> bind
80/tcp -> url-forwarder
8000/tcp -> BindUI
3306/tcp -> MySQL
  • Database 
    ## PostgreSQL 11
database：dns
user2：'dns_wr'@'%'
password：Ww123456!

user3：'dns_r'@'%'
password：Rr123456!

运行环境

Linux
Python 3.11
Django 4
JDK 17
Spring boot 3
MySQL 8 | MariaDB 10 | PostgreSQL 15 (任选一个)
Bind 9.12.1 | Bind 9.16.39 (任选一个)

系统部署

使用指南

系统架构、组件功能

本系统包含3个组件，分别是BindUI、url-forwarder 和 BIND。

  • BindUI
    BindUI 是一个基于 Django 架构的 WEB 项目，负责域名管理的可视化图形界面操作。
  • url-forwarder
    url-forwarder 是一个 URL 转发器，一个基于 Spring Boot 架构的 WEB 项目，负责 显性 URL、隐性 URL 记录的转发。

url-forwarder 项目：https://gitee.com/cucker/url-forwarder

  • BIND
    BIND 是一个开源的DNS软件，负责DNS的解析。

系统架构示意图

image

组件功能

  • BindUI系统功能
    • 域名管理
      • 域名(zone)的增、查、改、删
      • 域名(zone)的启用/暂停
    • RR管理
      • RR的增、查、改、删
      • RR的启用/暂停
      • RR的批量导入/导出，支持Text和Excel格式
    • 用户管理
      • 新建用户
      • 用户的登录/注销
      • 用户自助管理（更改密码、头像）
  • url-forwarder系统功能
    • HTTP URL的转发
      • 302显性URL
      • 301显性URL
      • 隐性URL
  • BIND系统功能
    • 基于View的智能DNS解析
    • 基于bind-dlz的动态DNS解析

工作原理

为什么 BIND 可以从数据库中加载 zone 数据？

是因为 BIND 扩展了 DLZ 驱动。

DLZ 允许 BIND 直接从外部数据库检索 zone 数据。

DLZ 驱动程序支持多种数据库后端，包括 PostgreSQL、MySQL 和 LDA P等，其中 dlz-postgres 是连接 PostgreSQL 的驱动，dlz-mysql 是连接 MySQL 的驱动。

说明：DLZ是BIND 9的扩展驱动（从BIND 9.4.0开始默认集成了DLZ drivers1，从BIND 9.17.19开始弃用DLZ drivers，从BIND 9.18开始移除DLZ drivers2

智能 DNS 是什么？

智能DNS（也称作智能域名解析）是一种先进的域名解析技术，它可以根据访问者的地理位置、网络运营商、时间等因素动态地将同一个域名指向不同的IP地址。

这样做的主要目的是优化用户体验，提高网站的加载速度和稳定性。

下面是一些智能DNS的关键特点及其应用场景：

  1. 基于地理位置的路由：智能DNS能够识别用户所在的位置，并将他们引导到最近或最合适的服务器上。比如，如果一个网站在中国和美国都有服务器，那么来自中国的访问者会被自动导向中国境内的服务器，而美国的访问者则被导向美国境内的服务器。这样做可以减少数据传输的距离，从而加快网页加载速度。
  2. 根据ISP进行路由：除了地理位置之外，智能DNS还可以根据不同互联网服务提供商(ISP)来分配流量。例如，某些内容可能更适合通过特定的ISP提供给用户，以获得更好的性能表现。
  3. 负载均衡：当企业拥有多个相同功能但位于不同地点的数据中心时，智能DNS可以帮助实现流量在这些数据中心之间的平衡分布，避免某一处过载而其他地方闲置的情况发生。
  4. 容灾切换：如果某个数据中心出现故障或者正在进行维护工作，智能DNS可以迅速将所有请求重定向到备用数据中心或其他正常运行的服务点上，确保业务连续性不受影响。
  5. 个性化服务：对于一些需要根据不同用户提供定制化内容的应用来说，智能DNS也可以发挥作用，比如向使用移动设备访问网站的用户展示专门针对小屏幕优化过的页面版本。

总之，智能DNS通过对用户访问请求做出更加精细且合理的响应策略调整，不仅提升了最终用户的上网体验，也为企业和组织提供了更高效灵活的网络资源管理方式。

BindUI 目前实现了下列这些智能DNS功能：

  1. 基于地理位置的路由（通过客户的源IP来确定其地址位置）
  2. 根据ISP进行路由（通过客户的源IP来确定其所属ISP）
  3. 负载均衡

智能DNS适用场景

  1. 多机房负载均衡
  2. 多线路负载均衡
  3. 内容分发网络（CDN）
  4. 企业内部可 WEB 管理的 DNS

多线路智能DNS解析是如何实现的？

BIND 中可配置多个 view，一个线路配置一个 view。
当配置了多个 view 时，则是按照配置文件中 view 的位置顺序从上往下逐个匹配，当客户的 IP 与 view 的 match-clients 子句所指定的 ACL 匹配时，则该客户IP与此view匹配，应用此 view，并停止匹配其他 view。

如果希望把一个view作为默认的view(当没有匹配到任何的view时，就应用默认的view。例如定义名为default的view)，则在配置文件中把该view放到所有view的后面。

基本原理：通过客户的源IP来确定其所属线路。

关于ACL
用户可以自定义 ACL， 一个 ACL 中可定义若干个网络。

BIND 内置了4个ACL，分别是any、none、localhost 和 localnets ACL。

显性 URL、隐性 URL是什么？

显性 URL、隐性 URL是实现DNS URL转发的两种不同的方式。
DNS URL转发是一种将一个域名的所有或部分请求重定向到另一个URL的技术。

DNS URL转发的适用场景：

  1. ‌网站迁移‌
    当网站从旧域名迁移到新域名时，通过DNS URL转发可以保持用户的访问流量，确保用户仍然能够访问到新的网站地址‌。
  2. 品牌保护
    ‌企业可以注册与品牌相关的多个域名，并通过DNS URL转发将它们统一到主网站上，以保护品牌并避免用户混淆。
  3. 简化网址‌
    有时企业可能拥有一个较长或复杂的网址，通过DNS URL转发，可以提供一个简短易记的域名，方便用户访问‌。
  4. 市场推广‌
    在进行市场推广活动时，企业可能会创建专门的推广域名，通过DNS URL转发将流量引导到特定的着陆页‌。

显性 URL、隐性 URL 是怎样工作的？

用户添加URL转发记录时，DNS会自动为用户添加CNAME记录，

而CNAME记录指向的地址则是URL转发服务器地址，目的就是通过URL转发服务器来帮助用户实现转发功能。

当访问者访问转发前域名时，实际上是向URL转发服务器发起请求，

如果是隐性URL转发，则是通过WEB服务应用来嵌套用户目标的URL，并返回带有iframe的页面给到访问者；

如果是显性URL转发，则是通过301或302重定向跳转到转发后页面。

  • DNS层：

    • 一条显性URL 或 一条隐性URL记录都是由两条相关联的记录共同实现的。
    • 一条是type字段为 'CNAME' 的记录（CNAME记录），主要用于查找URL转发器地址。data字段的值为URL转发器地址（URL转发服务器的A记录的FQDN值），该记录的basic字段值为3。
    • 另一条是type字段为 'TXT' 的记录（TXT记录），主要用于保存要转发的目标HTTP URL。该记录的data字段的值为要转发的目标HTTP URL，associate_rr_id字段的值为关联的CNAME记录的id。
    • basic字段的值是根据type类型和转发需求来确定，具体参考 "record 表设计" 的 basic 字段说明。

  • WEB层：

    • URL转发器用于实现显性URL和隐性URL记录的转发。
    • 显性URL记录使用URL重定向技术实现，包含302 URL重定向 和 301 URL重定向。
    • 隐性URL记录使用 HTML iframe 内联框架技术实现。

数据模型设计

主要的表有 record、zone 表，record 表用于保存 RR 数据，zone 表用于保存 zone（区域）数据。

  • zone 表设计
序号 字段 数据类型 长度 默认值 非空 描述
1 id bigint 是 主键，自动递增
2 zone_name varchar 255 是 zone名称，域名。要求唯一
3 status varchar 3 'on' 是 zone的启/停状态
4 create_time datetime 创建时间
5 update_time datetime 最近更新时间
6 comment varchar 255 备注

说明：

(1) status字段的可选值：'on' 表示开启，'off' 表示停用。

(2) 为提高查询效率，可基于zone_name字段创建索引。

  • record 表设计
序号 字段 数据类型 长度 默认值 非空 描述
1 id bigint 是 主键，自动递增
2 host varchar 255 '@' 是 主机
3 type varchar 64 'A' 是 RR类型
4 data varchar 4096 是 RR值
5 ttl int TTL存活时间（秒）
6 mx_priority int MX优先级（1-50），值越小越优先
7 refresh int SOA记录的同步间隔时间（秒）
8 retry int SOA记录的同步失败的重试时间（秒）
9 expire int SOA记录的过期时间（秒）
10 minimum int SOA记录的最小默认TTL值（秒）
11 serial bigint SOA记录的序列号，范围[0, 4294967295]3
12 mail varchar 255 域名负责人邮箱（SOA记录）
13 primary_ns varchar 255 SOA记录的主DNS服务器
14 status varchar 3 'on' 是 RR的启/停状态
15 resolution_line varchar 32 '0' 是 解析线路标识
16 basic int 0 是 其他信息
17 associate_rr_id bigint 关联record的id
18 zone_id bigint 是 外键，关联zone的id
19 create_time datetime 创建时间
20 update_time datetime 最近更新时间
21 comment varchar 255 备注

说明：

(1) type字段的常用可选项：

CNAME：别名记录，给域名取别名。
AAAA：IPv6记录，将域名指向一个IPv6地址。
NS：委派DNS zone使用指定的权威DNS服务器。
MX：邮件交换记录，用于给域指定邮件服务器。
SRV：通用服务定位记录。用于查询指定服务的信息，如服务名、通信协议、域名、优先级、权重、服务端口等信息。
TXT：文本记录。用于保存描述性文本。
PRT：指向主机记录或别名记录的指针。常用于DNS反向解析，指将IP地址映射到主机记录。
CAA：DNS证书颁发机构授权，约束主机/域可接受的CA。
URI：可用于发布从主机名到URI的映射。
SOA：zone的起始授权记录，一个zone在同一个view下有且仅有一条SOA记录。用于指定有关DNS区域的权威信息，包括主DNS服务器、域名负责人的电子邮箱、zone序列号以及与刷新zone相关的几个计时器(refresh, retry, expire, minimum)。

(2) mail字段表示域名负责人的电子邮箱，在mail字段中使用“.”来替代电子邮件中的“@”字符。

(3) status字段的可选值：'on' 表示开启，'off' 表示停用。

(4) resolution_line字段表示解析线路标识，即代表一个ACL。这里需要预先定义各个ACL对应的resolution_line值，例如：

'0'：其他网络(默认ACL)。
'cn'：中国网络。
'abroad'：国外网络。
'101'：中国电信网。
'102'：中国联通网络。
'103'：中国移动网络。
'104'：中国教育网络。

(5) basic字段用来表示其他信息，可选值和具体含义如下：

0：可重复的非基础记录（基础记录是指SOA、NS记录，非基础记录是指除SOA、NS之外的记录；重复部分是指host、type、zone_id字段的组合，下面的与此相同）。
1：可重复的基础记录。
2：不可重复的基础记录。
3：被显性URL或者隐性URL记录所关联的RR，被关联的RR为CNAME记录。
200：隐性URL记录，type字段的值为'TXT'。
301：301重定向显性URL记录，type字段的值为'TXT'。
302：302重定向显性URL记录，type字段的值为'TXT'。

(6) associate_rr_id字段用于保存显性URL或隐性URL记录所关联的RR的id。

性能

  • BIND 9.12.1/BIND 9.12.4 + PostgreSQL 11 QPS 可达 40000+.
  • BIND 9.16.36 + MySQL 8 QPS 可达 1000+.
  • BIND 9.16.36 + PostgreSQL 15 QPS 可达 1250+.

操作页面

image
image
image
image
image
image
image

注意

mysql 连接驱动改为 pymysql

  • 报错1
执行python manager.py 相关操作报错：
django.core.exceptions.ImproperlyConfigured: mysqlclient 1.3.13 or newer is required; you have 0.9.3.

解决方法

./bindUI/settings.py 添加下面的配置

import pymysql
# 指定 pymysql 的版本。主要是要比 Django 要求的最低版本要大
pymysql.version_info = (11, 1, 0, "final", 0)
pymysql.install_as_MySQLdb()
  • 报错2
AttributeError: 'str' object has no attribute 'decode'

解决方法

修改 {python安装根目录}/lib/python3.7/site-packages/django/db/backends/mysql/operations.py 146行，decode改为encode

if query is not None:
    query = query.decode(errors='replace')
return query

改成

if query is not None:
    query = query.encode(errors='replace')
return query

Footnotes

  1. Mark Andrews. BIND 9.4.0 is now available [EB/OL]. [2023-04-18]. https://lists.isc.org/pipermail/bind-announce/2007-February/000210.html ↩

  2. BIND 9 Significant Features Matrix [EB/OL]. [2023-04-18]. https://kb.isc.org/docs/aa-01310 ↩

  3. Serial Number Arithmetic [EB/OL]. [2023-06-23]. https://www.rfc-editor.org/rfc/rfc1982.txt#:~:text=The%20serial%20number%20in%20the,a%2032%20bit%20unsigned%20integer. ↩

About

bind ui, web admin

Topics

django python3

Resources

Readme
Activity

Stars

31 stars

Watchers

1 watching

Forks

20 forks
Report repository

Releases

1 tags

Packages

No packages published

Languages