VinylDNS 镜像文档

镜像概述

VinylDNS是一个与供应商无关的前端，用于跨DNS系统管理自助式DNS。该平台提供细粒度访问控制、所有变更的审计记录、自助式用户界面、基于REST的安全API，以及与Ansible、Terraform等基础设施自动化工具的集成。它设计用于与现有DNS基础设施集成，并提供可扩展性以适应特定部署需求。

核心功能与特性

• 跨DNS系统管理：支持在多个DNS系统间统一管理自助式DNS
• 细粒度访问控制：精确控制用户对DNS资源的操作权限
• 变更审计：记录所有DNS变更操作，确保可追溯性
• 自助用户界面：提供直观的用户界面，支持自助式DNS管理
• REST API：提供安全的RESTful API，便于集成和自动化
• 基础设施集成：与Ansible、Terraform等自动化工具无缝集成
• 可扩展性：支持通过插件扩展功能，适应特定部署需求

使用场景与适用范围

• 企业级DNS管理平台，需要统一管理多个DNS系统
• 需实现DNS自助服务的组织，减少运维团队负担
• 要求严格审计DNS变更的合规场景
• 需要通过API或自动化工具管理DNS的 DevOps 流程
• 希望扩展现有DNS基础设施功能的环境

快速启动

如需立即体验VinylDNS，可参考GitHub快速启动指南，部署本地API实例、Web客户端和预加载测试区域的bind9 DNS服务器。

详细配置说明

vinyldns/portal 镜像配置

portal镜像默认配置用于本地docker compose环境。生产环境部署需通过以下设置进行适当配置。

卷挂载

• /opt/docker/lib_extra：放置应用启动时需加载到类路径的额外JAR文件，用于添加专有或非标准构建的"插件"，该目录下所有JAR文件将被添加到类路径
• /opt/docker/conf/application.conf：用于覆盖默认配置设置
• /opt/docker/conf/application.ini：用于传递额外JVM选项
• /opt/docker/conf/trustStore.jks：自定义信任库文件，需在/opt/docker/conf/application.ini中设置-Djavax.net.ssl.trustStore=/opt/docker/conf/trustStore.jks

自定义LDAP配置

/opt/docker/conf/application.conf中包含portal.test_login = true开关，默认启用，开发者可使用用户名testuser和密码testpassword登录门户。自定义LDAP设置需在/opt/docker/conf/application.conf中配置。

配置自定义Java信任库

如需添加自定义Java信任库（如用于LDAP证书），操作步骤如下：

1. 将信任库文件添加到/opt/docker/conf/trustStore.jks
2. 在/opt/docker/conf/application.ini中添加JVM参数：-Djavax.net.ssl.trustStore=/opt/docker/conf/trustStore.jks

额外JVM参数

可在/opt/docker/conf/application.ini中添加额外JVM参数，以自定义JVM运行环境。

许可证

VinylDNS源代码采用Apache-2.0许可证授权；查看许可证信息了解此镜像中包含的软件许可详情。

与所有Docker镜像一样，本镜像可能还包含其他软件，这些软件可能采用其他许可证（如基础发行版中的Bash等，以及主要软件的任何直接或间接依赖项）。