pouya6672/masterdnsvpn repository overview

⁠MasterDnsVPN Docker Image

Containerized version of MasterDnsVPN Server Original project by masterking32 (respectfully acknowledged)

⁠⚠️ Overview

This Docker image runs the MasterDnsVPN server in a containerized environment and supports multi-architecture builds.

It automatically:

• Downloads the correct binary for your architecture
• Boots a default configuration if none exists
• Injects your domain on first startup
• Stores persistent data in /data

⁠🖥 Supported Architectures

• linux/amd64
• linux/arm/v5
• linux/arm/v7
• linux/arm64/v8
• linux/mips64le

⁠🚀 Quick Start

⁠1. Run container

docker run -d \
  --name masterdnsvpn \
  --restart unless-stopped \
  -e DOMAIN=v.example.com \
  -v $(pwd)/data:/data \
  -p 53:53/tcp \
  -p 53:53/udp \
  pouya6672/masterdnsvpn:latest

⁠🧪 Example with docker-compose

services:
  masterdnsvpn:
    image: pouya6672/masterdnsvpn:latest
    restart: unless-stopped
    environment:
      - DOMAIN=v.example.com
    volumes:
      - ./data:/data
    ports:
      - "53:53/tcp"
      - "53:53/udp"

⁠⚙️ Required Environment Variables

⁠📁 Persistent Data

Stored in /data:

• server_config.toml
• encrypt_key.txt

You can mount it as volume:

-v ./data:/data

⁠🧠 First Run Behavior

If /data/server_config.toml does not exist:

1. Downloads default config from upstream:

   https://github.com/masterking32/MasterDnsVPN/blob/main/server_config.toml.simple
   

   Copy

2. Renames it to server_config.toml

3. Injects:

   DOMAIN = ["your-domain"]
   

   Copy

4. Generates encryption key automatically

⁠🔧 MikroTik / RouterOS Usage

For MikroTik containers:

• Use latest v7 MikroTik RouterOS
• Destination NAT port UDP/TCP 53 to your container
• Full MikroTik container setup: https://help.mikrotik.com/docs/spaces/ROS/pages/84901929/Container⁠

Example:

/container mounts
add dst=/data list=MasterDnsVPN src=/containers/mounts/MasterDnsVPN

/container envs
add key=DOMAIN list=MasterDnsVPN value=v.example.com

/container add check-certificate=no dns=1.1.1.1 envlists=MasterDnsVPN hostname=MasterDnsVPN interface=MasterDnsVPN layer-dir="" mountlists=MasterDnsVPN name=MasterDnsVPN remote-image=pouya6672/masterdns:latest root-dir=/containers/data/MasterDnsVPN start-on-bo
ot=yes

⁠📌 Notes

• DNS port 53 is required (UDP/TCP)
• Do NOT run another DNS service on the same host
• Designed for production use but still lightweight
• No systemd or host modifications required

⁠❤️ Credits

This project is based on:

👉 MasterDnsVPN by masterking32 https://github.com/masterking32/MasterDnsVPN⁠

All credit for the original VPN/DNS engine goes to the original author. This containerization layer only simplifies deployment and multi-platform distribution.