https://github.com/yeluolei/dnsmasq-ha-web

A high availability dnsmasq deployment with web UI for edit hosts file
https://github.com/yeluolei/dnsmasq-ha-web

dnsmasq

Last synced: 3 months ago
JSON representation

A high availability dnsmasq deployment with web UI for edit hosts file

• Host: GitHub
• URL: https://github.com/yeluolei/dnsmasq-ha-web
• Owner: yeluolei
• License: mit
• Created: 2021-06-25T13:47:56.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-07-10T04:05:17.000Z (over 3 years ago)
• Last Synced: 2024-06-20T23:54:39.741Z (5 months ago)
• Topics: dnsmasq
• Language: Vue
• Homepage:
• Size: 9.7 MB
• Stars: 5
• Watchers: 2
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-starred - yeluolei/dnsmasq-ha-web - A high availability dnsmasq deployment with web UI for edit hosts file (others)

README

        
# dnsmasq-ha-web

A high availability dnsmasq deployment with web UI for edit hosts file.

This is a common problem if you want to set up dns server all by yourselves.

This project contains two parts:

 1. web based edit tool for hosts file, it will save the hosts record in sqlite 3 data base and generate a hosts file at /etc/dnsmasq-ha-web/hosts

 2. a configuration based on lsyncd and rsync for remote hosts file synchronization, which make sure the hosts file for dnsmasq servers is on sync

You can either install the dnsmasq-ha-web server with a standalone instance or

install it with one of your dnsmasq instance. The script make sure there is no

conflict.

## Instalation

### dnsmasq server

1. Config no password sudo permission to remote server, because we need to restart dnsmasq remotely

       echo "ubuntu ALL=(ALL) NOPASSWD:ALL" | sudo EDITOR='tee -a' visudo

2. Install required packages

       sudo apt install dnsmasq rsync

3. Copy the dnsmasq config in `scripts/etc/dnsmasq.d/ha-web.conf` to `/etc/dnsmasq.d/ha-web.conf`

4. Copy the scripts from `scripts/local/bin/dnsmasq-rsync.sh` to `/local/bin/dnsmasq-rsync.sh`

5. Change the permission of the script file

       sudo chmod +x /local/bin/dnsmasq-rsync.sh

6. Create the dir to add hosts file

       sudo mkdir -p /etc/dnsmasq

       sudo touch /etc/dnsmasq/hosts

### dnsmasq-ha-web server

1. Install lsyncd and rsync

       sudo apt install -y lsyncd rsync

2. Generate ssh key access and upload to dns servers

       sudo mkdir -p /etc/lsyncd

       sudo ssh-keygen -t rsa -f /etc/lsyncd/id_rsa

       ssh-copy-id -i /etc/lsyncd/id_rsa.pub @

3. Copy the config file in `scripts/etc/lsyncd/lsyncd.conf.lua` to the destination `/etc/lsyncd/lsyncd.conf.lua`

4. Restart lsyncd service

       sudo service lsyncd restart

5. Copy the binary build in this repo to the destination `bin/dnsmasq-ha-web` -> `/usr/local/bin/dnsmasq-ha-web`

6. Copy the service config file in `scripts/etc/systemd/system/dnsmasq-ha-web.service` -> `/etc/systemd/system/dnsmasq-ha-web.service`

7. Start the service and check the status

       sudo systemctl daemon-reload

       sudo service dnsmasq-ha-web start

## Build

1. Build the web frontend

       cd frontend

       yarn install

       yarn build

2. Build the go application, you need gcc installed, since this application is based

on sqlite3 and the go-sqlite3 package need CGO enabled

       make build