dns-serrvice/README.md

DNS Web Manager

基于 BIND9 的 DNS 服务器 Web 管理界面，使用 Flask + SQLite 构建。

功能概览

功能	说明
仪表盘	BIND 服务状态、域名/记录统计、服务控制（启动/停止/重启/重载）
域名管理	创建/删除 Zone（支持 master/slave）、查看 Zone 详情、编辑原始 zone 文件
记录管理	添加/删除 DNS 记录（A、AAAA、CNAME、MX、TXT、NS、PTR、SRV、CAA）
DNS 查询	在线 dig 测试，支持所有记录类型
配置管理	在线编辑 named.conf.options 和 named.conf.local，带语法校验
操作日志	全部操作的审计日志，支持分页
用户认证	登录/登出/修改密码

截图

仪表盘

• BIND 服务状态卡片（运行状态、开机自启）
• 域名数量、记录总数统计
• 服务控制按钮（启动/停止/重启/重载）
• 域名概览表格
• 最近操作日志

域名管理

• 域名列表（域名、类型、Zone 文件、记录数）
• 创建域名表单（域名、类型、NS 服务器、管理员邮箱）
• Zone 详情页：SOA 信息、记录列表、添加记录表单、原始文件编辑

DNS 查询

• 输入域名 + 记录类型 + DNS 服务器，执行 dig 查询
• 显示完整 dig 输出

技术栈

• DNS 服务器: BIND 9.18+（named）
• Web 框架: Flask 3.0
• 数据库: SQLite（用户认证 + 审计日志）
• 前端: Jinja2 模板 + 原生 CSS（无前端框架依赖）
• WSGI 服务器: Gunicorn

目录结构

dns-service/
├── app.py                  # Flask 应用主文件（路由、模型、BIND 操作）
├── wsgi.py                 # Gunicorn 入口
├── init_db.py              # 数据库初始化脚本
├── requirements.txt        # Python 依赖
├── README.md
├── templates/              # Jinja2 模板
│   ├── base.html           # 布局模板（导航栏 + 页脚）
│   ├── login.html          # 登录页
│   ├── dashboard.html      # 仪表盘
│   ├── zones.html          # 域名列表
│   ├── zone_form.html      # 创建域名表单
│   ├── zone_detail.html    # Zone 详情 + 记录管理
│   ├── zone_raw.html       # 原始 Zone 文件编辑
│   ├── query.html          # DNS 查询测试
│   ├── config.html         # BIND 配置管理
│   ├── logs.html           # 操作日志
│   ├── change_password.html
│   └── error.html          # 错误页
├── static/
│   └── style.css           # 全部样式
└── instance/               # SQLite 数据库（运行时生成）
    └── dns_web.db

BIND 配置文件

文件	用途	默认路径（Debian/Ubuntu）
named.conf	主配置	/etc/bind/named.conf
named.conf.options	全局选项（监听端口、转发器、查询权限）	/etc/bind/named.conf.options
named.conf.local	Zone 声明（由 Web UI 自动管理）	/etc/bind/named.conf.local
zone files	DNS 记录文件	/etc/bind/zones/db.*

路径可通过环境变量覆盖（见下方"路径配置"章节）。RHEL/CentOS/Rocky 默认 BIND 路径为 /var/named、/etc/named.conf，需要在环境变量里重新指。

安装部署

1. 安装 BIND9

apt-get update
apt-get install -y bind9 bind9utils dnsutils

2. 配置 BIND

Debian/Ubuntu（默认路径）

# 创建 zone 文件目录
mkdir -p /etc/bind/zones
chown bind:bind /etc/bind/zones

# named.conf.options（监听 53 端口）
cat > /etc/bind/named.conf.options << 'EOF'
options {
    directory "/var/cache/bind";
    listen-on port 53 { any; };
    listen-on-v6 { none; };
    forwarders { 8.8.8.8; 8.8.4.4; };
    allow-query { any; };
    allow-recursion { 127.0.0.0/8; 10.168.1.0/24; };
    dnssec-validation auto;
    auth-nxdomain no;
};
EOF

# named.conf（包含 options + local + default-zones）
cat > /etc/bind/named.conf << 'EOF'
include "/etc/bind/named.conf.options";
include "/etc/bind/named.conf.local";
include "/etc/bind/named.conf.default-zones";
EOF

# named.conf.local（空，由 Web UI 自动填充）
cat > /etc/bind/named.conf.local << 'EOF'
// Local zone configurations - managed by DNS Web UI
EOF

# 启动 BIND
systemctl enable named
systemctl start named

RHEL / CentOS 7 / Rocky Linux

CentOS 默认 BIND 路径在 /var/named/ 和 /etc/named.conf，需要：

yum install -y bind bind-utils

# Zone 文件目录（默认 /var/named 即可；如想用 /etc/bind/zones 也可以，但需同步修改下方环境变量）
mkdir -p /var/named
chown root:named /var/named
chmod 2770 /var/named

# named.conf（追加 include，让 named 加载 Web UI 写入的 named.conf.local）
grep -q 'named.conf.local' /etc/named.conf || \
  echo 'include "/etc/named.conf.local";' >> /etc/named.conf

# 给 Web UI 一个空白的入口文件
touch /etc/named.conf.local
chown root:named /etc/named.conf.local
chmod 640 /etc/named.conf.local

systemctl enable named
systemctl start named

3. 安装 Web 应用

git clone ssh://git@git.cnbugs.com:10022/AI-Agent/dns-service.git
cd dns-service

# 安装 Python 依赖
pip install -r requirements.txt

# 创建数据库目录
mkdir -p instance

# 初始化数据库（创建默认 admin/admin 账号）
python3 init_db.py

# 启动（开发模式）
python3 app.py

4. 生产部署（Gunicorn + Systemd）

# 创建 systemd 服务
cat > /etc/systemd/system/dns-web.service << 'EOF'
[Unit]
Description=DNS Web Manager
After=network.target named.service

[Service]
Type=notify
User=root
WorkingDirectory=/root/dns-service
ExecStart=/usr/local/bin/gunicorn --workers 2 --bind 0.0.0.0:5300 wsgi:app
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl enable dns-web
systemctl start dns-web

5. 路径配置（环境变量）

BIND 在不同发行版的默认路径不同，下面这些环境变量可以覆盖默认值（不设置则使用 Debian/Ubuntu 默认）：

变量	Debian/Ubuntu 默认	RHEL/CentOS 推荐值
BIND_CONF_DIR	/etc/bind	/etc
BIND_ZONES_DIR	/etc/bind/zones	/var/named
BIND_CONF_LOCAL	/etc/bind/named.conf.local	/etc/named.conf.local
BIND_CONF_OPTIONS	/etc/bind/named.conf.options	/etc/named.conf
BIND_RNDC_KEY	/etc/bind/rndc.key	/etc/rndc.key
BIND_SERVICE	named	named

在 systemd 服务里加 Environment=：

cat > /etc/systemd/system/dns-web.service << 'EOF'
[Unit]
Description=DNS Web Manager
After=network.target named.service

[Service]
Type=notify
User=root
WorkingDirectory=/root/dns-service
Environment=BIND_CONF_DIR=/etc
Environment=BIND_ZONES_DIR=/var/named
Environment=BIND_CONF_LOCAL=/etc/named.conf.local
Environment=BIND_CONF_OPTIONS=/etc/named.conf
Environment=BIND_RNDC_KEY=/etc/rndc.key
ExecStart=/usr/local/bin/gunicorn --workers 2 --bind 0.0.0.0:5300 wsgi:app
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target
EOF

systemctl daemon-reload
systemctl restart dns-web

注意：覆盖 BIND_CONF_LOCAL 后，必须让 named 主配置 include 这个文件。CentOS 7 的 /etc/named.conf 默认不会 include，需要按上面"配置 BIND / RHEL"一节里的命令追加 include "/etc/named.conf.local";。

使用说明

登录

• 访问 http://<服务器IP>:5300
• 默认账号: admin / 密码: admin
• 首次登录后请修改密码

创建域名

1. 进入「域名管理」→「+ 添加域名」
2. 填写域名（如 example.com）、选择类型（master/slave）
3. 可选填写 NS 服务器和管理员邮箱（留空则自动生成）
4. 点击「创建域名」

添加 DNS 记录

1. 进入域名详情页
2. 点击「+ 添加记录」
3. 填写记录名称、类型、TTL、数据
4. 点击「添加」

记录类型说明：

类型	数据格式	示例
A	IPv4 地址	10.168.1.100
AAAA	IPv6 地址	2001:db8::1
CNAME	别名（FQDN，以 . 结尾）	www.example.com.
MX	优先级 + 邮件服务器（FQDN）	10 mail.example.com.
TXT	文本内容	"v=spf1 ~all"
NS	NS 服务器（FQDN）	ns1.example.com.
PTR	反向解析目标（FQDN）	host.example.com.
SRV	优先级 权重 端口 目标	10 5 5060 sip.example.com.

DNS 查询测试

1. 进入「DNS 查询」页面
2. 输入域名和记录类型
3. DNS 服务器留空默认查询本地 BIND（127.0.0.1:53）
4. 点击「查询」查看结果

配置管理

1. 进入「配置管理」页面
2. 可在线编辑 named.conf.options（监听端口、转发器等）
3. 可在线编辑 named.conf.local（Zone 声明）
4. 保存时自动执行 named-checkconf 校验，通过后自动 rndc reload

服务控制

在「仪表盘」页面可控制 BIND 服务：

• 启动 - systemctl start named
• 停止 - systemctl stop named
• 重启 - systemctl restart named
• 重载配置 - rndc reload（不中断服务，热加载 zone 变更）

注意事项

1. 权限要求: Web 应用需要 root 权限运行（用于操作 BIND 配置文件和 systemctl 命令）
2. 端口冲突: 如果 53 端口被其他服务占用（如 dnsmasq），需先停掉对应服务
3. Zone 文件权限: zone 文件需要 bind:bind 所有权，Web UI 自动设置
4. Serial 自动递增: 每次添加/删除记录时，SOA Serial 自动递增（YYYYMMDDNN 格式）
5. 配置备份: 编辑配置文件时自动创建 .bak 备份

API 接口

方法	路径	说明
GET	/api/status	获取 BIND 服务状态（需登录）

License

MIT