powerdnsadmin/pda-legacy

PowerDNS-Admin

PowerDNS的高级Web管理界面，具备丰富的功能特性，用于简化和增强DNS服务器的管理流程。

核心功能与特性

• 提供正向和反向区域管理
• 区域模板功能
• 基于角色的用户访问控制
• 区域特定的访问权限控制
• 活动日志记录
• 认证方式：
  • 本地用户支持
  • SAML支持
  • LDAP支持：OpenLDAP / Active Directory
  • OAuth支持：Google / GitHub / Azure / OpenID
• 双因素认证支持（TOTP）
• PDNS服务配置与统计监控
• DynDNS 2协议支持
• 简化IPv6 PTR记录编辑
• 提供区域和记录管理等功能的API
• 完整的IDN/Punycode支持

使用场景与适用范围

适用于需要集中管理PowerDNS服务器的场景，包括：

• DNS服务器管理员进行区域配置与记录管理
• 企业环境中多用户协作管理DNS资源，通过角色权限控制访问范围
• 需要集成多种认证方式（如LDAP、OAuth）的组织
• 需通过API自动化DNS管理任务的系统集成
• 对DNS活动日志和审计有需求的合规场景

使用方法与配置说明

运行PowerDNS-Admin

可通过多种方式运行，最快的方式是使用Docker。如需直接在系统上安装，可参考https://github.com/PowerDNS-Admin/PowerDNS-Admin/blob/master/docs/wiki/%E3%80%82

Docker部署

以下两种Docker运行方式，快速启动推荐选项1，需自定义配置推荐选项2。

选项1：从Docker Hub运行

使用Docker Hub上的最新稳定版镜像，执行以下命令：

bash
$ docker run -d \
    -e SECRET_KEY='your-very-secret-key' \
    -v pda-data:/data \
    -p 9191:80 \
    powerdnsadmin/pda-legacy:latest

此命令创建名为pda-data的数据卷，用于持久化默认SQLite数据库及应用配置。

选项2：使用docker-compose

1. 配置更新
   编辑docker-compose.yml文件，更新SQLALCHEMY_DATABASE_URI中的数据库连接字符串。其他环境变量可参考https://github.com/PowerDNS-Admin/PowerDNS-Admin/blob/master/configs/docker_config.py#L5-L46%E3%80%82%E5%A6%82%E9%9C%80%E4%BD%BF%E7%94%A8Docker secrets功能，可在环境变量后添加_FILE并指向存储值的文件。
   务必将SECRET_KEY设置为长随机字符串（参考https://flask.palletsprojects.com/en/1.1.x/config/#SECRET_KEY%EF%BC%89%E3%80%82

2. 启动容器

   bash
   $ docker-compose up
   

启动后，通过浏览器访问http://localhost:9191即可使用PowerDNS-Admin。

截图

!https://github.com/PowerDNS-Admin/PowerDNS-Admin/raw/master/docs/screenshots/dashboard.png

贡献指南

详见https://github.com/PowerDNS-Admin/PowerDNS-Admin/blob/dev/docs/CONTRIBUTING.md%E3%80%82

许可证

本项目采用MIT许可证发布，详见https://github.com/PowerDNS-Admin/PowerDNS-Admin/blob/master/LICENSE%E3%80%82