Paano Ayusin ang DNS sa WireGuard: 3 Problema
May tunnel pero walang name resolution, tumatagas ang DNS sa local router, o nao-overwrite ang setting ng resolver. Alamin ang 3 failure mode at tamang fix.
Bakit nasisira ang DNS sa sandaling umandar ang WireGuard tunnel
Nabibigo ang DNS over WireGuard sa tatlong paraan, at may sariling solusyon ang bawat isa. Maaaring walang anumang name na ma-resolve, o nari-resolve ang mga name pero lumalabas sa machine mo ang mga query at hindi dumadaan sa tunnel, o ino-overwrite ng sariling resolver manager ng client ang setting ilang segundo matapos umandar ang interface. Halos hindi kailanman ang tunnel ang problema. Ang problema ay ang isang linyang nagsasabi sa client kung aling resolver ang gagamitin, pati ang routing na tumutukoy kung paano bibiyahe ang mga packet papunta sa resolver na iyon.
Ang WireGuard ay naglilipat ng IP packets at walang alam tungkol sa DNS (domain name system, ang serbisyong nagsasalin ng mga name gaya ng example.com tungo sa mga IP address). Ang linyang DNS = sa client [Interface] block ay hindi setting ng WireGuard. Binabasa ito ng wg-quick, ang shell wrapper na nagpapagana sa interface, at pagkatapos ay ine-edit ng wg-quick ang resolver configuration ng client habang aktibo ang tunnel at ibinabalik ito sa wg-quick down. Kaya ang bawat problemang nasa ibaba ay routing problem o wg-quick problem, at hindi kailanman cryptography problem. Kung hindi pa nagagawa ang tunnel mismo, magsimula sa sarili mong WireGuard VPN na naka-host sa sarili mong VPS at bumalik sa page na ito pagkatapos.
Tiyaking maayos ang tunnel bago mo galawin ang DNS.
sudo wg show
ping -c 3 10.8.0.1
ping -c 3 1.1.1.1Dapat ilista ng wg show ang peer na may kamakailang latest handshake, at dapat parehong makatanggap ng sagot ang dalawang ping. Kung nag-timeout ang ping 1.1.1.1, malamang forwarding o NAT (network address translation) problem ito at hindi DNS problem, kaya walang maitutulong ang anumang resolver config. Ang firewall na nagda-drop ng ICMP ay nagdudulot din ng parehong timeout, kaya kumpirmahin gamit ang curl -sI https://1.1.1.1 bago ka magsimulang magbago ng forwarding rules. Kung may sagot ang mga ping pero bumabagsak ang throughput kapag nagsimula ang aktuwal na traffic, hiwalay na fault ito, at halos palaging MTU ang sanhi ng mabagal na WireGuard sa halip na anumang tinatalakay sa page na ito. Sa bawat halimbawa rito, ginagamit ang 10.8.0.0/24 bilang tunnel subnet at ang 10.8.0.1 bilang tunnel address ng server. Palitan ang mga ito ng sarili mong value.
Unang failure: walang nare-resolve dahil hindi sumasagot ang resolver
Tiyak ang sintomas. Gumagana ang ping 1.1.1.1, at ibinabalik ng curl https://example.com ang sumusunod:
curl: (6) Could not resolve host: example.comDirektang tanungin ang tunnel resolver mula sa client. Ang dig ay kasama sa dnsutils package sa Ubuntu at Debian.
dig +short @1.1.1.1 example.com
dig +short @10.8.0.1 example.comNagbabalik ng address ang unang command. Pinatutunayan nito na nakakarating ang mga packet sa internet sa pamamagitan ng tunnel. Walang ibinabalik ang ikalawang command at nagpi-print ito ng ;; communication timed out; no servers could be reached. Iyan ang buong diagnosis: nakaturo ang client mo sa 10.8.0.1, at hindi sumasagot ang 10.8.0.1 sa UDP port 53.
Dalawang dahilan ang maaaring magdulot nito. Maaaring walang tumatakbong resolver sa server, o maaaring dini-drop ng server firewall ang query bago ito makarating. Suriin ang dalawang ito sa server.
sudo ss -ulnp | grep ':53'
sudo nft list rulesetAng resolver na tumatakbo at wastong naka-bind ay nagpapakita ng linyang may 10.8.0.1:53 o 0.0.0.0:53. Sa Ubuntu, karaniwang nakalilito ang 127.0.0.53:53. Ito ang systemd-resolved stub listener, na nagba-bind sa loopback address at sadyang hindi naaabot mula sa ibang machine. Kapag itinuro ang VPN client sa server na ang tanging resolver ay ang stub na ito, eksaktong ganitong timeout ang lilitaw.
Ang solusyon ay isang resolver na nakikinig sa tunnel address, kasama ang isang firewall rule na nagpapahintulot sa mga peer na maabot ito.
sudo apt update && sudo apt install -y unbound
printf 'server:\n interface: 10.8.0.1\n access-control: 10.8.0.0/24 allow\n' \
| sudo tee /etc/unbound/unbound.conf.d/wireguard.conf
sudo systemctl restart unbound
sudo ss -ulnp | grep '10.8.0.1:53'Pagkatapos, buksan ang port para sa tunnel traffic lamang. Sa nftables, idagdag ang dalawang linyang ito sa input chain sa /etc/nftables.conf at i-reload gamit ang sudo systemctl reload nftables.
udp dport 53 iifname "wg0" accept
tcp dport 53 iifname "wg0" acceptSa ufw, pareho ang ginagawa ng sudo ufw allow in on wg0 to any port 53. Huwag kailanman buksan ang port 53 sa public internet. Natutuklasan ng mga scanner ang open recursive resolver sa loob ng ilang araw at ginagamit ito para palakihin ang denial-of-service attacks. Mapapansin ng provider mo ang traffic na iyon bago mo pa ito mapansin.
Ulitin ang dig +short @10.8.0.1 example.com mula sa client. Ang address sa output ay nangangahulugang gumagana ang resolver path, kaya kailangan na lamang itong gamitin ng client. Idagdag ang line sa [Interface] block ng client at i-restart ang interface gamit ang sudo wg-quick down wg0 && sudo wg-quick up wg0.
[Interface]
PrivateKey = <client private key>
Address = 10.8.0.2/32
DNS = 10.8.0.1Ikalawang problema: DNS leaks dahil hindi nire-route ng split tunnel ang resolver
Mas malala ito dahil mukhang gumagana ang lahat. Nare-resolve ang mga pangalan, naglo-load ang mga page, at dumadaan nang cleartext ang mga query sa local network na ayaw mong pagkatiwalaan.
Dalawang configuration ang nagdudulot nito. Ang una ay client na may AllowedIPs = 0.0.0.0/0, ::/0 at walang DNS = line. Ini-install ng wg-quick ang default route sa sarili nitong routing table at nagdaragdag ng rule gamit ang suppress_prefixlength 0. Sinasadya nitong panatilihing aktibo ang mas specific na local route para maabot pa rin ng machine ang printer nito. Ang resolver na natutuhan ng client sa DHCP, karaniwang ang router sa 192.168.1.1, ay tumutugma sa isa sa mga local route na iyon. Dumadaan sa tunnel ang traffic mo. Tumatanggap pa rin ang local network ng buong listahan ng mga pangalan na hinahanap mo.
Ang ikalawa ay split tunnel: AllowedIPs = 10.8.0.0/24 na may DNS = 9.9.9.9. Dahil wala sa AllowedIPs ang 9.9.9.9, walang route ang client papunta rito sa pamamagitan ng tunnel. Kaya lumalabas ang query sa local link, gaya ng unang kaso.
Patunayan kung aling resolver ang aktuwal na sumasagot. Ang whoami.akamai.net ay public test name na sumasagot gamit ang IP address ng recursive resolver na nagpadala ng query, kaya maikukumpara mo ang sagot nito sa public address ng server mo.
resolvectl status
dig +short whoami.akamai.net
sudo tcpdump -ni any -c 10 port 53Nagpi-print ang resolvectl status ng isang block para sa bawat link. Kung ipinapakita pa rin ng block para sa ethernet o wireless link mo ang Current DNS Server: 192.168.1.1 habang walang ipinapakita ang block na wg0, iyon ang leak. Kinukumpirma ito ng dig +short whoami.akamai.net mula sa malayong panig kapag ibinalik nito ang home broadband address mo sa halip na address ng server mo. Ang tcpdump line ang ebidensiyang nagtatapos sa pagtatalo: sa healthy na output, lahat ng port 53 packet na lumalabas sa machine ay nasa wg0. Sa may leak, nasa wlan0 o enp3s0 ang mga ito. Ang mga packet sa lo papunta o mula sa 127.0.0.53 ay traffic ng application papunta sa local systemd-resolved stub, kaya hindi iyon leak.
Dalawa ang bahagi ng fix at parehong kailangan. Itakda ang DNS sa address na nasa loob ng tunnel, at tiyaking nasa loob ng AllowedIPs ang address na iyon.
[Interface]
Address = 10.8.0.2/32
DNS = 10.8.0.1
[Peer]
PublicKey = <server public key>
Endpoint = vpn.example.com:51820
AllowedIPs = 10.8.0.0/24, 10.20.0.0/16Nasa loob ng 10.8.0.0/24 ang 10.8.0.1, kaya naka-encrypt ang query at ipinapadala sa server. Kung gagamit ka pa rin ng public resolver sa split tunnel, idagdag ito bilang host route: AllowedIPs = 10.8.0.0/24, 9.9.9.9/32. Dadaan sa tunnel ang mga packet, pero makikita pa rin ng local network na pinili mo ang provider na iyon batay sa mga naunang session. Iniiwasan ng sarili mong resolver ang isyung ito.
Ang resolver assignment ay isa sa mga kapansin-pansing pagkakaiba ng hand-built WireGuard at isang coordinated mesh. Bahagi ito ng tradeoff sa WireGuard kumpara sa Tailscale. Sa pagpapatakbo ng sarili mong self-hosted Headscale control server, makukuha mo ang coordination na iyon nang hindi ipinagkakatiwala sa third party ang key material mo. Kung iyan ang nakababahala sa iyo, tandaan na hindi kailanman hinahawakan ng Tailscale ang mga key na nag-e-encrypt ng traffic mo. Ang mas mahalagang tanong ay kung ano ang maaaring maidagdag sa network mo ng isang compromised coordination server o ninakaw na identity account.
Kabiguan 3: nag-aagawan ang resolvconf at systemd-resolved sa mga Linux client
Awtomatikong ina-apply ng mga client na macOS, Windows, iOS, at Android ang DNS = sa pamamagitan ng official app at bihira itong magdulot ng problema. Sa Linux nagiging mahirap ito dahil isang shell script ang nag-a-apply ng setting at kailangang alamin kung alin sa ilang resolver manager ang ginagamit mo.
Madaling mapansin ang unang kabiguan. Humihinto ang sudo wg-quick up wg0 na may ganito:
resolvconf: command not foundTumatawag ang wg-quick sa resolvconf, pero hindi naka-install ang binary na iyon. Sa Debian 12 at Ubuntu 24.04 o mas bago, kasama sa systemd-resolved package ang resolvconf command na kumokonekta sa systemd-resolved. I-install ang package, pagkatapos ay muling i-up ang interface. Walang hiwalay na package para rito ang Ubuntu 22.04. Doon, ikaw mismo ang gumawa ng compatibility link gamit ang sudo ln -s /usr/bin/resolvectl /usr/local/bin/resolvconf at laktawan ang install line.
sudo apt install -y systemd-resolved
sudo systemctl restart systemd-resolved
sudo wg-quick down wg0 && sudo wg-quick up wg0
resolvectl status wg0Tahimik ang ikalawang kabiguan, at ito ang maaaring kumain ng isang buong gabi. Umaangat ang interface, ipinapakita nang tama ng resolvectl status wg0 ang DNS Servers: 10.8.0.1, pero sa lumang resolver pa rin napupunta ang mga lookup. Hindi binabalewala ng systemd-resolved ang wg0. Ang pangalan na hindi tumutugma sa anumang routing domain ay ipinapadala sa DNS server ng bawat link na itinuturing na default route. Ang link na may DNS server pero walang route-only domain ay itinuturing na default route bilang default. Kaya sabay na ipinapadala ang query sa 10.8.0.1 at sa router ng wireless link, at ang unang matagumpay na sagot ang ginagamit. Isang hop lang ang layo ng router at karaniwan itong unang sumasagot. Sa alinmang paraan, nakalabas na ang query nang walang encryption. Ang mga pangalan sa ilalim ng sariling search domain ng wireless link, gaya ng lan, ay ipinapadala lamang sa link na iyon dahil inuuna ang pinakatukoy na routing domain.
Kapag ina-apply ng wg-quick ang DNS = sa pamamagitan ng sariling resolvconf wrapper ng systemd, humihingi na ito ng catch-all routing domain. Kaya karaniwang lumilitaw ang kabiguang ito kapag ibang resolvconf implementation o network manager ang nag-apply ng setting. Kapag tahasan itong itinakda, mawawala ang panghuhula.
Itakda ang resolver at i-claim ang catch-all routing domain sa iisang hakbang. Nag-e-expand ang %i sa pangalan ng interface, kaya gumagana ang block na ito nang walang pagbabago sa anumang interface.
[Interface]
Address = 10.8.0.2/32
PostUp = resolvectl dns %i 10.8.0.1; resolvectl domain %i ~.
PostDown = resolvectl revert %iTanggalin ang linyang DNS = kapag ginagamit mo ang PostUp sa ganitong paraan. Kung hindi, dalawang mechanism ang nagsusulat sa resolver state at isa lamang sa mga ito ang naglilinis pagkatapos. Mahalaga ang ~. argument: ginagawa nitong route-only domain para sa bawat pangalan ang wg0. Dahil dito, hindi na ipinapadala ng systemd-resolved sa ibang link ang mga pangalan na walang mas espesipikong domain na tumutugma. Ang mga pangalan sa ilalim ng sariling domain ng ibang link, gaya ng lan, ay ipinapadala pa rin sa link na iyon. Karaniwan, ito ang gusto para sa mga local host. I-verify ito.
resolvectl status wg0Dapat naglalaman ang maayos na output ng DNS Servers: 10.8.0.1 at DNS Domain: ~.. Kung nawawala ang ~., hindi naisagawa ang resolvectl domain na bahagi at muling nakikipag-unahan ang wg0 sa ibang mga link. Huwag gamitin ang default route flag bilang pagsusuri. Binabasa nito ang yes, o +DefaultRoute sa linyang Protocols depende sa bersiyon ng systemd, kahit wala ang ~.. Default route pa rin kasi ang link na walang route-only domain.
May isa pang kasong dapat tukuyin. Kung ang /etc/resolv.conf ay regular na file sa halip na symlink papunta sa /run/systemd/resolve/stub-resolv.conf, ibang component ang may kontrol dito, karaniwan ay NetworkManager o container runtime. Patakbuhin ang ls -l /etc/resolv.conf bago magsiyasat ng iba, dahil aalisin ng tool na muling sumusulat sa file na iyon sa bawat pagbabago sa network ang ginawa mong setting sa pinakahindi angkop na oras.
Ang upgrade: sarili mong filtering resolver sa loob ng tunnel
Kapag maaasahan nang dumadaan sa tunnel ang mga query, nagiging control point ang resolver sa kabilang dulo. Kapag nagpatakbo ka roon ng AdGuard Home, magkakaroon ang bawat nakakonektang device ng blocklist filtering at query log, nang walang client software at per-device configuration. Ang official install script, na sinuri noong October 2026, ay isang linya.
curl -s -S -L https://raw.githubusercontent.com/AdguardTeam/AdGuardHome/master/scripts/install.sh | sh -s -- -vNakikinig ang setup wizard sa port 3000 sa unang pag-run. I-access ito sa tunnel gamit ang http://10.8.0.1:3000 sa halip na buksan sa publiko ang port na iyon, at itakda sa wizard ang DNS listen address at admin listen address sa 10.8.0.1. Kung ginagamit pa rin ng unbound mula sa unang failure ang parehong address, ihinto muna ito gamit ang sudo systemctl disable --now unbound, dahil mag-aagawan ang dalawa sa UDP port 53 sa iisang address at lalabas ang AdGuard Home na may listen udp 10.8.0.1:53: bind: address already in use.
Walang kailangang baguhin sa client configs kung nakatakda na ang mga ito sa DNS = 10.8.0.1. Ipapakita na ngayon ng query log ang bawat lookup na nakararating dito mula sa bawat peer, maliban kung ibubukod mo ang isang client sa logging. Isa itong tunay na desisyon tungkol sa privacy, hindi libreng pakinabang: inililipat mo ang tiwala mula sa internet provider mo papunta sa sarili mo, at ikaw ang kailangang magpanatiling patched sa server na iyon. Kailangang maayos muna ang mga pangunahing security measure sa isang server na exposed sa internet, at saklaw ng unang sampung minuto sa bagong VPS ang mga ito.
FAQ
Bakit kumokonekta ang WireGuard tunnel pero hindi nagre-resolve ang mga pangalan?
Nagdadala ng mga packet ang tunnel at hindi ito humahawak ng mga pangalan, kaya ang gumaganang tunnel na may sirang lookup ay nangangahulugang hindi sumasagot ang resolver na itinuro mo. Mag-test gamit ang dig +short @10.8.0.1 example.com mula sa client. Ang reply na communication timed out ay nangangahulugang walang resolver na nakikinig sa tunnel address na iyon, kadalasan dahil ang systemd-resolved stub ay nagbi-bind lamang sa 127.0.0.53, o bina-block ng server firewall ang UDP port 53 na dumarating sa wg0. Ayusin muna ang listener, pagkatapos ay buksan lamang ang port para sa wg0.
Paano ko susuriin kung nagle-leak ang DNS ko sa WireGuard?
Patakbuhin ang sudo tcpdump -ni any -c 10 port 53 sa client at obserbahan ang interface column habang nagba-browse ka. Dapat nasa wg0 ang bawat packet na umaalis sa machine; ang mga packet sa lo na papunta o galing sa 127.0.0.53 ay ang local systemd-resolved stub at normal lamang. Kung lumilitaw ang mga ito sa wireless o ethernet interface mo, lumalabas ang mga query nang naka-cleartext. Nagbibigay ang dig +short whoami.akamai.net ng ikalawang pagsusuri, dahil sumasagot ito gamit ang public address ng recursive resolver na nagsagawa ng query, kaya kinukumpirma ng sagot na hindi address ng server mo ang leak.
Kailangan ko ba ang DNS = line kung split tunnel ang gamit ko?
Oo, at dapat nasa loob din ng AllowedIPs ang resolver address; kung hindi, walang route ang client papunta rito. Sa AllowedIPs = 10.8.0.0/24, sakop ang resolver sa 10.8.0.1 at naka-encrypt ang query. Hindi sakop ang public resolver gaya ng 9.9.9.9, kaya lumalabas ang query sa local link kahit tama ang hitsura ng DNS line.
Bakit ipinapakita ng resolvectl ang tamang server pero sa iba pa rin napupunta ang mga lookup?
Ipinapadala ng systemd-resolved ang pangalan na walang katugmang routing domain sa lahat ng default-route link nang sabay-sabay, kabilang ang wg0, at ibinabalik nito ang unang matagumpay na sagot, na karaniwang galing sa local router. Idagdag ang PostUp = resolvectl dns %i 10.8.0.1; resolvectl domain %i ~. sa [Interface] block ng client at alisin ang DNS = line. Dapat i-report ng resolvectl status wg0 ang DNS Domain: ~. pagkatapos nito, at ang bawat pangalan na hindi inaangkin ng ibang link gamit ang mas partikular na domain ay mapupunta lamang sa wg0.
Aling client ang dapat kong ayusin muna kapag marami ang sira?
Ayusin muna ang isang Linux client, dahil ito ang tanging platform na malinaw na nagpapakita ng mekanismo. Sinasabi ng resolvectl status at tcpdump kung aling resolver ang sumagot at kung aling interface ang nagdala ng packet. Ginagamit ng phone at desktop apps ang parehong mga value ng DNS at AllowedIPs nang walang nakikitang plumbing, kaya kapag tama na ang Linux client, kinokopya mo na lamang ang configuration na napatunayan mo na.