jamesstevens/pdns-webui

PowerDNS WebUI镜像概述

该镜像提供PowerDNS的Web管理界面，包含NGINX HTTP转HTTPS代理和单页JavaScript应用。项目为独立开发维护，与PowerDNS.COM BV等第三方无关联，用于通过PowerDNS RestAPI浏览和编辑DNS数据。

核心功能

• 服务器连接：直接或通过代理访问PowerDNS服务器（支持HTTP/HTTPS）。
• 区域管理：添加、查看、删除、签名/取消签名区域，执行强制NOTIFY、rectify操作，下载RFC格式区域文件。
• 元数据管理：添加、编辑、删除元数据项及值，含客户端验证（如下拉选择限定值）。
• 记录管理：添加、编辑、删除RR/RR-Set，修改TTL，跨区域复制记录。
• TSIG密钥管理：添加、重新生成、删除密钥，一键复制名称/摘要。
• DNSSEC功能：签名/取消签名区域、密钥滚动（CSK/KSK/ZSK）、DS摘要复制、NSEC与NSEC3转换等。
• 搜索与统计：快速搜索DNS数据，查看服务器统计信息。
• 目录区域支持：维护bind-9.11目录区域（适用于RFC/XFR从服务器）。

使用场景

• 系统管理员管理PowerDNS主/从服务器的DNS数据。
• 快速处理DNS记录编辑、DNSSEC配置及密钥滚动。
• 通过代理或SSH隧道安全访问PowerDNS RestAPI。

配置说明

浏览器安全限制

• 若WebUI通过HTTPS加载，RestAPI必须使用HTTPS（可通过代理实现）。
• 需满足CORS合规：提供WebUI的服务器需在响应头中列出允许访问的其他服务器。

示例配置

PowerDNS配置（pdns.conf）

webserver=yes
webserver-address=127.1.0.1
webserver-allow-from=127.0.0.0/8
webserver-password=Dev-Key
api=yes
api-key=Dev-Key

Apache代理配置（VirtualHost）

<VirtualHost *:443>
    DocumentRoot /opt/websites/pdns/powerdns-webui/htdocs
    <Proxy http://127.1.0.1:8081/*> Allow from all </Proxy>
    <location /stats/>
        ProxyPass http://admin,Dev-Key@127.1.0.1:8081/
        ProxyPassReverse http://admin,Dev-Key@127.1.0.1:8081/
    </location>
    <location /api>
        Header add X-API-Key "Dev-Key"
        RequestHeader set X-API-Key "Dev-Key"
        ProxyPass http://127.1.0.1:8081/api
        ProxyPassReverse http://127.1.0.1:8081/api
    </location>
</VirtualHost>

Docker部署示例

bash
# 运行容器（映射本地8080端口到容器80端口）
docker run -d --name pdns-webui -p 8080:80 jamesstevens/pdns-webui

访问http://localhost:8080即可使用WebUI，需根据实际情况配置代理或直接连接PowerDNS RestAPI。

SSH隧道方法

1. 下载WebUI文件：curl -sS https://raw.githubusercontent.com/james-stevens/powerdns-webui/master/htdocs/index.html --output powerdns-webui.html
2. 打开文件：xdg-open powerdns-webui.html
3. 建立隧道：ssh user@myserver -L 8000:[::1]:8068 -N（调整端口和服务器地址）
4. 在WebUI输入[::1]:8000及API密钥连接。