MasterDnsVPN: DNS 터널로 네트워크 차단을 우회하는 오픈소스 도구

# Linux x86_64
wget https://github.com/masterking32/MasterDnsVPN/releases/latest/download/masterdnsvpn-linux-amd64
chmod +x masterdnsvpn-linux-amd64
sudo mv masterdnsvpn-linux-amd64 /usr/local/bin/masterdnsvpn

# macOS (Apple Silicon)
wget https://github.com/masterking32/MasterDnsVPN/releases/latest/download/masterdnsvpn-darwin-arm64
chmod +x masterdnsvpn-darwin-arm64
sudo mv masterdnsvpn-darwin-arm64 /usr/local/bin/masterdnsvpn

# 저장소 클론
git clone https://github.com/masterking32/MasterDnsVPN.git
cd MasterDnsVPN

# 서버 측 컴파일
go build -o masterdnsvpn-server ./cmd/server

# 클라이언트 측 컴파일
go build -o masterdnsvpn-client ./cmd/client

# 이미지 풀
docker pull masterking32/masterdnsvpn

# 서버 실행
docker run -d \
  --name masterdnsvpn-server \
  -p 53:53/udp \
  -v $(pwd)/config:/etc/masterdnsvpn \
  masterking32/masterdnsvpn server --config /etc/masterdnsvpn/config.yaml

# 서버 측 설정 예시
server:
  listen_addr: "0.0.0.0:53"    # UDP 53 포트 리스닝 (DNS 표준 포트)
  protocol: "udp"               # UDP 프로토콜 사용

  # 암호화 설정
  encryption:
    method: "aes-256-gcm"       # 암호화 알고리즘: aes-256-gcm / chacha20-poly1305 / xor
    password: "your-strong-password-here"  # ⚠️ 강력한 비밀번호로 변경하세요

  # 업스트림 DNS 리졸버 (정상 DNS 요청 포워딩용)
  upstream_dns:
    - "8.8.8.8:53"
    - "1.1.1.1:53"

  # 로그 설정
  log_level: "info"             # debug / info / warn / error
  log_file: "/var/log/masterdnsvpn.log"

sudo masterdnsvpn server --config config.yaml

# systemd 서비스 파일 생성
sudo tee /etc/systemd/system/masterdnsvpn.service << EOF
[Unit]
Description=MasterDnsVPN Server
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/masterdnsvpn server --config /etc/masterdnsvpn/config.yaml
Restart=always
RestartSec=10
User=root

[Install]
WantedBy=multi-user.target
EOF

# 서비스 시작
sudo systemctl daemon-reload
sudo systemctl enable masterdnsvpn
sudo systemctl start masterdnsvpn

# 상태 확인
sudo systemctl status masterdnsvpn

# 클라이언트 설정 예시
client:
  # 로컬 SOCKS5 프록시 리스닝 주소
  socks5_listen: "127.0.0.1:1080"

  # DNS 터널 서버 주소 (VPS IP 또는 도메인)
  server_addr: "your-vps-ip:53"

  # 암호화 설정 (서버와 일치해야 함)
  encryption:
    method: "aes-256-gcm"
    password: "your-strong-password-here"

  # DNS 리졸버 목록 (터널 트래픽 전송용)
  resolvers:
    - "8.8.8.8:53"
    - "8.8.4.4:53"
    - "1.1.1.1:53"
    - "1.0.0.1:53"

  # 고급 설정
  advanced:
    # MTU 설정 (작은 MTU 네트워크에서는 값을 낮춤)
    mtu: 1400

    # 패킷 복제 배수 (1=복제 안 함, 2=각 패킷을 두 번 전송, 신뢰성 향상 but 트래픽 증가)
    duplication_factor: 1

    # 헬스체크 간격 (초)
    health_check_interval: 30

    # 로드밸런싱 모드: latency / loss / round_robin / weighted
    load_balance_mode: "latency"

  # 로컬 DNS 캐시 (선택 사항, DNS 하이재킹 위험 감소)
  local_dns:
    enabled: true
    listen_addr: "127.0.0.1:5353"
    cache_ttl: 300  # 캐시 TTL (초)

masterdnsvpn client --config client_config.yaml

# curl로 SOCKS5 프록시 경유 접속
curl --socks5 127.0.0.1:1080 https://www.google.com

# proxychains 사용 (Linux)
proxychains curl https://www.google.com

# 다양한 로드밸런싱 모드 설정 예시
advanced:
  # 모드 1: 지연 시간 기반 (기본값, 대부분 시나리오에 적합)
  load_balance_mode: "latency"

  # 모드 2: 패킷 손실률 기반 (높은 패킷 손실 네트워크에 적합)
  # load_balance_mode: "loss"

  # 모드 3: 라운드 로빈 (간단한 균등 분배)
  # load_balance_mode: "round_robin"

  # 모드 4: 가중치 (수동으로 가중치 지정)
  # load_balance_mode: "weighted"
  # resolver_weights:
  #   "8.8.8.8:53": 10
  #   "1.1.1.1:53": 5
  #   "9.9.9.9:53": 8

advanced:
  # 복제 배수: 1=복제 안 함, 2=각 패킷을 두 번 전송, 3=세 번 전송
  duplication_factor: 2

  # 선택적 복제: 중요한 제어 패킷만 복제 (트래픽 절약)
  selective_duplication: true

local_dns:
  enabled: true
  listen_addr: "127.0.0.1:5353"
  cache_ttl: 300          # 5분 캐시
  max_cache_size: 10000   # 최대 10,000개 레코드 캐시

  # SOCKS5를 통한 DNS 해석 (하이재킹 추가 방지)
  resolve_via_socks5: true

# Linux (systemd-resolved)
sudo tee /etc/systemd/resolved.conf.d/masterdnsvpn.conf << EOF
[Resolve]
DNS=127.0.0.1:5353
FallbackDNS=8.8.8.8
EOF
sudo systemctl restart systemd-resolved

# macOS
sudo networksetup -setdnsservers Wi-Fi 127.0.0.1

# 서버 측 설정: TCP 포워딩 활성화
server:
  tcp_forwarding:
    enabled: true
    rules:
      - listen_addr: "127.0.0.1:8388"    # 로컬 리스닝 포트
        target_addr: "shadowsocks-server:8388"  # 포워딩 대상

# 1. 서버가 정상 작동 중인지 확인
sudo systemctl status masterdnsvpn
sudo tail -f /var/log/masterdnsvpn.log

# 2. UDP 53 포트가 열려 있는지 확인
sudo ss -ulnp | grep 53

# 3. 방화벽 규칙 확인
sudo iptables -L INPUT -n | grep 53
# firewalld 사용 시
sudo firewall-cmd --list-ports | grep 53/udp

# 4. 클라이언트에서 DNS 연결성 테스트
dig @your-vps-ip google.com
nslookup google.com your-vps-ip

# 5. 암호화 비밀번호가 일치하는지 확인
# 클라이언트와 서버의 config.yaml에서 password 필드가 완전히 동일한지 확인

# UDP 53 포트 개방 (Ubuntu/Debian)
sudo ufw allow 53/udp

# UDP 53 포트 개방 (CentOS/RHEL with firewalld)
sudo firewall-cmd --permanent --add-port=53/udp
sudo firewall-cmd --reload

# 클라우드 서버 사용 시 보안 그룹에서도 UDP 53을 개방해야 함

# 해결법 1: 더 많은 DNS 리졸버 추가
resolvers:
  - "8.8.8.8:53"
  - "8.8.4.4:53"
  - "1.1.1.1:53"
  - "1.0.0.1:53"
  - "9.9.9.9:53"       # Quad9
  - "208.67.222.222:53" # OpenDNS

# 해결법 2: MTU 조정 (작은 MTU 네트워크용)
advanced:
  mtu: 1200  # 기본 1400에서 낮춤

# 해결법 3: 패킷 복제 활성화
advanced:
  duplication_factor: 2

# 해결법 4: 로드밸런싱 모드 전환
advanced:
  load_balance_mode: "loss"  # 패킷 손실이 심할 경우

# 로컬 DNS 활성화 및 SOCKS5를 통한 해석
local_dns:
  enabled: true
  listen_addr: "127.0.0.1:5353"
  resolve_via_socks5: true  # 핵심! DNS 쿼리도 터널을 통과하도록
  cache_ttl: 600

# 그리고 시스템 DNS를 127.0.0.1:5353으로 설정

# Termux에서 설치
pkg install golang git
git clone https://github.com/masterking32/MasterDnsVPN.git
cd MasterDnsVPN
go build -o masterdnsvpn ./cmd/client

# 구성 파일 생성 및 실행
./masterdnsvpn client --config client_config.yaml

# Android WiFi 설정에서 SOCKS5 프록시 구성
# 프록시 호스트: 127.0.0.1, 포트: 1080