Skip to content

Getting Started

Jump to bottom
KamalMac edited this page Apr 27, 2026 · 1 revision

Getting Started

فارسی: راهنمای شروع

What you need

Before opening KevinNet, you need three things:

1 — A VPS server outside Iran

Any Linux VPS with a public IP. Recommended providers: Hetzner, DigitalOcean, Vultr, Linode.

2 — A domain name

You need a domain (e.g. example.com) so you can create a subdomain that points to your server. The subdomain becomes your tunnel address.

3 — VPN server software installed

Choose one:

Engine Server guide What you get after setup
MasterDNS MasterDnsVPN repo Tunnel domain + 32-char encryption key
VayDNS VayDNS repo Tunnel domain + 64-char hex public key

DNS Setup (required for both engines)

Both MasterDNS and VayDNS act as authoritative DNS servers. You must delegate a subdomain to your VPS by creating two DNS records:

Record type Name Value
A ns Your server's IP address
NS v (or t for VayDNS) ns.yourdomain.com

Example with domain example.com and server IP 1.2.3.4:

ns.example.com  →  1.2.3.4         (A record)
v.example.com   →  ns.example.com  (NS record)

Your tunnel domain is then v.example.com.

Cloudflare users: The A record must be DNS only (grey cloud icon). Do not proxy it.

Tip: Short names (1–2 characters) leave more room for data in each DNS packet → better throughput.

DNS propagation takes up to 48 hours. If Phase 3 of the scan keeps failing, wait and try again.

Getting your key

MasterDNS — Encryption Key

After installing MasterDnsVPN on your server, the 32-character encryption key is shown in the terminal and saved in a file:

cat ~/MasterDnsVPN/encrypt_key.txt

It looks like: 4c8da843709463cab27f1234567890ab

VayDNS — Public Key

After generating keys on the VayDNS server:

cat server.pub

It looks like: 0a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b

This 64-character hex string is your VayDNS Public Key.

The public key is safe to share. The private key (server.key) must stay on the server.

Installing KevinNet

  1. Go to the Releases page
  2. Download the file for your platform
  3. macOS: run these commands after downloading: 
    chmod +x KevinNet_macOS_Universal
xattr -d com.apple.quarantine KevinNet_macOS_Universal
  4. Linux: chmod +x KevinNet_Linux_x64
  5. Windows: just double-click the .exe

First scan — step by step

  1. Open KevinNet
  2. Select MasterDNS or VayDNS at the top of the Scanner panel
  3. Enter your Country / Folder name (e.g. Iran)
  4. Enter your Tunnel Domain (e.g. v.example.com)
  5. Enter your Key
  6. Set scan options — see Scanner Tab for recommended values
  7. Click ▶ Start Scan
  8. When done, click 💾 Save to MasterDNS Profiles or 💾 Save to VayDNS Profiles
  9. Go to the relevant Profiles tab and click 🚀 Launch VPN
  10. Set your browser proxy to SOCKS5 127.0.0.1:18000 (MasterDNS) or SOCKS5 127.0.0.1:7000 (VayDNS)

Next steps

Clone this wiki locally