Zurück zu den Updates
New releaseSep 16, 2026

numa v0.23.1

Portabler DNS-Resolver in Rust — lokale .numa-Domains, Adblocking, Entwickler-Overrides

Teilen

Numa

CI crates.io License: MIT

DNS, das dir gehört. Überall, wo du hingehst. · numa.rs

Ein portabler DNS-Resolver in einer einzigen Binärdatei. Blockiere Werbung in jedem Netzwerk, benenne deine lokalen Dienste (frontend.numa), überschreibe jeden Hostnamen mit automatischer Rücknahme und versiegle optional jede ausgehende Abfrage mit ODoH (RFC 9230), sodass keine einzelne Partei sowohl sieht, wer du bist, als auch, wonach du gefragt hast. Alles läuft auf deinem Laptop, ohne Cloud-Konto oder Raspberry Pi.

Von Grund auf in Rust entwickelt, ohne DNS-Bibliotheken. Numa kann auch rekursiv mit DNSSEC-Validierung auflösen, DoT- und DoH-Clients bedienen und als öffentliches ODoH-Relay (numa relay) laufen.

Der Parser für das DNS-Wire-Protokoll ist handgeschrieben. Der meiste spätere Code wurde mit KI entworfen und von Hand überprüft.

Numa-Dashboard

Schnellstart

1. In Docker ausprobieren (nichts auf dem Host installiert)

docker run -d --name numa -p 127.0.0.1:5553:53/udp -p 127.0.0.1:5553:53/tcp \
  -p 127.0.0.1:5380:5380 ghcr.io/razvandimescu/numa
dig @127.0.0.1 -p 5553 example.com
docker exec numa numa token            # API token for the dashboard login

Öffne http://localhost:5380 und melde dich mit einem beliebigen Benutzernamen und diesem Token an. Port 5553 umgeht alles, was auf dem Host bereits Port 53 belegt. numa.numa löst hier nicht auf, da der Host Numa nicht für DNS verwendet. Räume mit docker rm -f numa auf.

2. Im Vordergrund ausführen (System-DNS unberührt)

Hole die Binärdatei:

# macOS
brew install razvandimescu/tap/numa

# Linux
curl -fsSL https://raw.githubusercontent.com/razvandimescu/numa/main/install.sh | sh

# Arch Linux
pacman -S numa

# Windows: download from GitHub Releases
# All platforms
cargo install numa

# Nix
nix profile install github:razvandimescu/numa

Unter Linux durchsucht sudo weder ~/.cargo/bin, ~/.nix-profile/bin noch Linuxbrew. Wenn sich numa in einem dieser Verzeichnisse befindet, verwenden Sie sudo "$(command -v numa)", wo auf dieser Seite sudo numa steht.

sudo numa                              # Ctrl-C to stop (port 53 requires root/admin)

Testen Sie es mit dig @127.0.0.1 example.com (@127.0.0.2 unter Windows). Das Dashboard ist unter http://localhost:5380 erreichbar. Standardmäßig können auch andere Geräte in Ihrem Netzwerk Numa abfragen. Um dies einzuschränken, setzen Sie [server] allow_from auf die Netzwerke, denen Sie vertrauen.

3. Als System-DNS einrichten

PlattformInstallierenAktualisierenDeinstallieren
macOSsudo numa installBinary aktualisieren, dann sudo numa installsudo numa uninstall
Linuxsudo numa installBinary aktualisieren, dann sudo "$(command -v numa)" installsudo numa uninstall
Windowsnuma install (Administrator) + Neustartdas neue numa.exe install ausführen (Administrator)numa uninstall (Administrator) + Neustart

install registriert einen Dienst, richtet das System-DNS auf Numa aus und vertraut dessen lokaler CA. uninstall macht alle drei Schritte rückgängig. Um die Installation zu prüfen, öffnen Sie http://numa.numa. Wenn das Dashboard lädt, ist Numa Ihr System-DNS.

Aktualisieren Sie das Binary auf die Weise, wie Sie es installiert haben (brew upgrade, cargo install numa oder install.sh erneut ausführen). Ein erneutes Ausführen von install startet den Dienst mit dem neuen Binary neu und behält Token und CA bei.

Unter Linux konfiguriert install systemd-resolved mit einer Drop-in-Datei neu. uninstall entfernt sie. Beenden Sie vor der Installation jeden anderen Prozess, der Port 53 belegt (dnsmasq, einschließlich des von NetworkManager).

Anmelden

Über Loopback (localhost, 127.0.0.1, numa.numa) benötigen Dashboard und API keine Anmeldung. Von jeder anderen Adresse aus, einschließlich Docker-Port-Mapping und der LAN-Adresse dieses Rechners, wird das API-Token verlangt. Numa erstellt das Token beim ersten Start. Geben Sie es mit sudo numa token aus (eine Administrator-Shell unter Windows). Melden Sie sich mit einem beliebigen Benutzernamen und diesem Token an. Um ein eigenes Token festzulegen, verwenden Sie [server] api_token oder NUMA_API_TOKEN.

Jede Spur entfernen

uninstall stellt DNS wieder her, behält aber das Datenverzeichnis, sodass eine Neuinstallation dasselbe Token und dieselbe CA behält. Um alles zu entfernen, führen Sie zuerst uninstall aus und löschen dann:

PlattformZurückbleibend
macOSdas Binary, /usr/local/var/numa, /usr/local/var/log/numa.log
Linuxdas Binary und jede Kopie unter /usr/local/bin/numa, /var/lib/numa
Windowsdas Binary, %PROGRAMDATA%\numa
iPhonedas Profil „Numa DNS" (Einstellungen → Allgemein → VPN & Geräteverwaltung)

Löschen Sie außerdem ~/.config/numa, falls Sie eine Benutzerkonfiguration erstellt haben. Wenn Sie [server] data_dir gesetzt haben, löschen Sie auch diesen Pfad.

Wie es sich vergleicht

Pi-holeAdGuard HomeUnboundNuma
Lokaler Dienst-Proxy + automatisches TLSNeinNeinNein.numa-Domains, HTTPS, WebSocket
LAN-DiensterkennungNeinNeinNeinmDNS (numa lan on)
Overrides mit automatischem ZurücksetzenNeinNeinNeinREST-API, skriptfähig
Rekursiver ResolverNeinNeinJaJa
DNSSEC-ValidierungJaVerlässt sich auf UpstreamJaJa (rekursiver Modus)
WerbeblockierungJaJaNeinJa (Hagezi Pro als Standard, eigene Listen)
Regeln pro ClientGruppenJaViews / TagsNach CIDR ([[client_policy]]), nur Konfigurationsdatei
Web-Admin-OberflächeVollständigVollständigNeinDashboard
Verschlüsselter UpstreamBenötigt cloudflaredDoH, DoT, DoQ, DNSCryptDoTDoH, DoT, ODoH
Verschlüsselte Clients (DoT-Listener)Benötigt stunnel-SidecarJaJaJa (RFC 7858)
DoH-Server-EndpunktNeinJaJaJa (RFC 8484)
Parallele Upstream-Abfragendnsmasq all-serversParalleler ModusNeinRequest Hedging (UDP, DoH, DoT)
Serve-stale + PrefetchNeinOptimistischer CacheJa (RFC 8767, Prefetch)Ja (RFC 8767, Prefetch)
Bedingte WeiterleitungJaJaJaJa (Regeln pro Suffix)
ReifeAusgereiftAusgereiftAusgereiftNeu

Was Numa nicht tut. Kein DHCP, kein Clustering, keine Konfigurationssynchronisierung zwischen Instanzen. Die meisten Einstellungen befinden sich in der Konfigurationsdatei, nicht im Dashboard.

Konfiguration

Die Einstellungen befinden sich in einer einzigen TOML-Datei. numa config path gibt aus, welche Datei Ihre Installation verwendet. numa config edit öffnet sie. Führen Sie nach einer Änderung sudo numa service restart aus. numa -c FILE führt Numa oder diese Befehle mit einer von Ihnen gewählten Datei aus. numa.toml dokumentiert jede Option inline.

Unter Windows lauscht Numa auf 127.0.0.2:53, da der DNS-Client-Dienst (Dnscache) 127.0.0.1:53 belegt. Behalte 127.0.0.2 bei, wenn du bind_addr bearbeitest.

Lokale Dienste

Benenne deine Dev-Dienste, statt dir Portnummern merken zu müssen:

curl -X POST localhost:5380/services -H 'Content-Type: application/json' \
  -d '{"name":"frontend","target_port":5173}'

Kategorien