Skip to content

quick-start.md

Latest commit

 

History

History
154 lines (117 loc) · 3.03 KB

quick-start.md

File metadata and controls

154 lines (117 loc) · 3.03 KB

Quick Start Guide - Xbox DNS Bypass with DoH

Overview

Two setup options:

  1. DNS over HTTPS (DoH) - Encrypted DNS, bypasses ISP filtering (requires domain)
  2. Standard DNS - Simple DNS bypass (no domain needed)

Option 1: DoH Setup (Recommended)

Requirements:

  • ✅ VPS outside Russia
  • ✅ Domain name (can be free from Freenom)
  • ✅ 10 minutes

Step 1: Point Domain to VPS

Create DNS A record:

Type: A
Name: @ (or dns, or whatever)
Value: YOUR_VPS_IP
TTL: 3600

Step 2: Upload & Run Script

# Upload to VPS
scp install-doh-server.sh root@YOUR_VPS_IP:/root/

# SSH and install
ssh root@YOUR_VPS_IP
chmod +x install-doh-server.sh
sudo ./install-doh-server.sh your-domain.com

Step 3: Configure Devices

Xbox (Standard DNS):

  • Settings → Network → DNS Settings → Manual
  • Primary: YOUR_VPS_IP

Windows (DoH):

# PowerShell as Admin
Add-DnsClientDohServerAddress -ServerAddress "YOUR_VPS_IP" -DohTemplate "https://your-domain.com/dns-query"

Android (DoH):

  • Settings → Private DNS → your-domain.com

Chrome/Firefox (DoH):

  • Settings → DNS over HTTPS → https://your-domain.com/dns-query

Step 4: Test

./test-doh.sh your-domain.com

Option 2: Standard DNS Setup

Requirements:

  • ✅ VPS outside Russia
  • ✅ 5 minutes

Step 1: Upload & Run

scp install-dns-server.sh root@YOUR_VPS_IP:/root/
ssh root@YOUR_VPS_IP
chmod +x install-dns-server.sh
sudo ./install-dns-server.sh

Step 2: Configure Xbox

  • Settings → Network → DNS Settings → Manual
  • Primary DNS: YOUR_VPS_IP
  • Secondary DNS: YOUR_VPS_IP

Step 3: Test

./test-dns.sh YOUR_VPS_IP

Which Option to Choose?

Choose DoH if:

  • ✅ Your ISP blocks DNS queries
  • ✅ You want maximum privacy
  • ✅ You can get a domain (even free)
  • ✅ You have other devices (PC, phone) to protect

Choose Standard DNS if:

  • ✅ You only need Xbox bypass
  • ✅ You don't want to deal with domains
  • ✅ Your ISP doesn't block DNS (yet)
  • ✅ You want simplest setup

Free Resources

Free Domains:

  • Freenom: .tk, .ml, .ga, .cf, .gq (FREE)
  • DuckDNS: subdomain.duckdns.org (FREE)

Free/Cheap VPS:

  • Oracle Cloud: FREE forever (1-2 VMs)
  • Hetzner: €4.15/month
  • Contabo: €3.99/month

Troubleshooting

Can't Connect

# On VPS, check status
sudo systemctl status unbound

# Check firewall
sudo ufw status

# View logs
sudo journalctl -u unbound -n 50

Slow Performance

# Monitor performance
./monitor-dns.sh

# Choose closer VPS location

DoH Not Working

# Check certificate
sudo certbot certificates

# Check DoH service
sudo systemctl status doh-server

Next Steps

  1. ✅ Test Xbox Live connection
  2. ✅ Configure other devices
  3. ✅ Set up monitoring: ./monitor-dns.sh
  4. ✅ Read doh-setup.md for advanced config

Support

See detailed guides:

  • README.md - Overview
  • doh-setup.md - DoH configuration
  • advanced-setup.md - Optimization & troubleshooting

Enjoy unrestricted Xbox gaming! 🎮