# open_dnsdb

**Repository Path**: actionchen/open_dnsdb

## Basic Information

- **Project Name**: open_dnsdb
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-01-10
- **Last Updated**: 2022-01-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

![](https://img.shields.io/github/release/qunarcorp/open_dnsdb.svg)
![](https://img.shields.io/github/license/qunarcorp/open_dnsdb.svg)
![](https://img.shields.io/github/languages/code-size/qunarcorp/open_dnsdb.svg)
# OpenDnsdb

## 项目主页

OpenDnsdb 项目相关文档:  [文档链接](../../wikis/home)


## 简介

OpenDnsdb 是去哪儿网OPS团队开源的DNS管理系统，用于添加、修改、删除zones/records.
使用简单并可靠的方法管理View、ACL、网段等.
详尽的日志，便于审计.

OpenDnsdb并不是一个DNS服务器，而是一个对现有DNS服务器的管理系统，提供Web管理UI以及命令行工具等.

对OpenDnsdb的操作，会生成DNS配置文件并同步给DNS服务器。也就是说OpenDnsdb的故障或不可用并不会对DNS服务本身造成任何影响.

OpenDnsdb is an open source DNS management system for the OPS team. It is used to add, modify, and delete zones/records. Use simple and reliable methods to manage View, ACL, network segment, etc. Detailed logs for auditing.

OpenDnsdb is not a DNS server, but a management system for existing DNS servers, providing Web management UI and command line tools.

For OpenDnsdb operations, a DNS configuration file is generated and synchronized to the DNS server. That is to say, the failure or unavailability of OpenDnsdb does not affect the DNS service itself.


## 主要功能

* 支持 Bind 9.
* IP管理, 管理公司网段及ip，可以实现域名和ip的自动绑定
* 域名管理, 域名的增、删、改、查.
* View域名管理, view域名的增删改查、状态修改，view域名的迁移.
* 配置管理, 管理zone文件，线上配置与数据库配置同步，修改配置自动完成部署.
* 日志, 关键操作都有日志记录，并可通过页面进行查询，便于审查
* 支持RESTful API, 支持Webhook.
* 基于Python 3 开发, 支持Postgresql和SQLite.


## 应用结构

* docs/
	各种说明文档、手册, copyright/license等.

* dnsdb_fe/
	web ui

* tools/
	同步脚本, 各种工具.

* etc/
	开发、测试环境的配置文件, 配置模板等.

* dnsdb_command.py
	数据库初始脚本

* dnsdb/constant
 常量设置，用到的正则匹配规则


## 安装手册
* 环境 Python:3.6.8  pip:19.0.3

* 支持的浏览器: chrome, Firefox

* 安装virtualenv: `pip install virtualenv`

* 项目克隆

* 目录创建：`mkdir -p /var/log/open_dnsdb/`

    ```ini
    ; 日志目录配置: etc/beta/common.conf
    [log]
    log-dir = /var/log/open_dnsdb/
    ```

* 切换到项目目录: `cd open_dnsdb `

* 初始化项目python环境: 

    ```bash
    $ python tools/install_venv.py -p /usr/bin/python3.6
    # 命令行参数:
    # 	-p 使用的python解释器版本, 确保使用virtualenv创建虚拟环境是python3.6+
    #		如果确认virtualenv命令是用python3安装的, 这个参数可以省略
    ```

* 启用虚拟环境

    ```bash
     $ source .venv/bin/activate
     $ python -V 	# 确认python版本为3.6+
    ```

* 初始化数据库
    *  数据库配置: etc/beta/common.conf
    	```ini
    	[DB]
    	connection=sqlite:////usr/local/open_dnsdb/dnsdb.db
    	```
    *  touch /usr/local/open_dnsdb/dnsdb.db 新建数据文件 
    *  export FLASK_APP=dnsdb_command.py
    *  export FLASK_ENV=beta
    *  flask deploy (生成测试账号: test 密码:123456)

* 生成程序控制脚本: tools/with_venv.sh python setup.py install

* 安装supervisor用于管理python进程:
  * 安装: sudo pip install supervisor
        ```
        # python3版本supervisor安装
        pip install git+https://github.com/Supervisor/supervisor
        ```

  * 生成默认配置: echo_supervisord_conf > /etc/supervisord.conf

  * 修改配置文件 vim /etc/supervisord.conf
    ```ini
    [supervisord]
    childlogdir=/var/log/open_dnsdb         ;日志文件位置
    
    [include]
    files = /etc/supervisor/conf.d/*.conf
    ```

  * mkdir -p /etc/supervisor/conf.d

  * 添加openDnsdb项目配配置: 
    * dnsdb: cp etc/beta/supervisor-dnsdb.conf /etc/supervisor/conf.d/open-dnsdb.conf
    * updater(仅bind服务器需要): cp etc/beta/supervisor-updater.conf /etc/supervisor/conf.d/open-dnsdb-updater.conf

  * 启动: supervisord -c /etc/supervisord.conf

  * 查看是否启动成功: ps aux | grep supervisord

  * supervisorctl -c /etc/supervisord.conf

  

## ChangeLog

* v0.2 - 2019-03-21

   **添加**

   ​	添加ipv6支持(暂不支持ipv6反解)

   **修改**

   ​	升级python版本，支持python3.6+

## 感谢

感谢以下同学对项目修改提出的宝贵建议：

* [wss434631143](https://github.com/wss434631143)