Voltar às atualizações
New releaseSep 16, 2026

numa v0.23.1

Resolvedor de DNS portátil em Rust — domínios locais .numa, bloqueio de anúncios, sobreposições para desenvolvedores

Compartilhar

Numa

CI crates.io License: MIT

DNS que é seu. Em qualquer lugar que você vá. · numa.rs

Um resolvedor DNS portátil em um único binário. Bloqueie anúncios em qualquer rede, dê nome aos seus serviços locais (frontend.numa), sobrescreva qualquer hostname com reversão automática e, opcionalmente, sele cada consulta de saída com ODoH (RFC 9230), para que nenhuma parte isolada veja tanto quem você é quanto o que você perguntou. Tudo roda no seu laptop, sem conta na nuvem ou Raspberry Pi necessário.

Construído do zero em Rust, sem bibliotecas DNS. O Numa também pode resolver recursivamente com validação DNSSEC, atender clientes DoT e DoH, e rodar como um relay ODoH público (numa relay).

O parser do protocolo de rede DNS é escrito à mão. A maior parte do código posterior foi elaborada com IA e revisada manualmente.

Numa dashboard

Início Rápido

1. Experimente no Docker (nada instalado no host)

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

Abra http://localhost:5380 e faça login com qualquer nome de usuário e esse token. A porta 5553 evita o que já estiver ocupando a porta 53 no host. numa.numa não resolve aqui, porque o host não usa o Numa para DNS. Faça a limpeza com docker rm -f numa.

2. Executar em primeiro plano (DNS do sistema intacto)

Obtenha o binário:

# 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

No Linux, o sudo não procura em ~/.cargo/bin, ~/.nix-profile/bin ou Linuxbrew. Se o numa estiver em um desses diretórios, use sudo "$(command -v numa)" onde esta página indica sudo numa.

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

Teste com dig @127.0.0.1 example.com (@127.0.0.2 no Windows). O dashboard fica em http://localhost:5380. Por padrão, outros dispositivos na sua rede também podem consultar o Numa. Para limitar isso, defina [server] allow_from para as redes em que você confia.

3. Definir como DNS do sistema

PlataformaInstalarAtualizarDesinstalar
macOSsudo numa installatualize o binário e depois sudo numa installsudo numa uninstall
Linuxsudo numa installatualize o binário e depois sudo "$(command -v numa)" installsudo numa uninstall
Windowsnuma install (admin) + reiniciarexecute o novo numa.exe install (admin)numa uninstall (admin) + reiniciar

install registra um serviço, aponta o DNS do sistema para o Numa e confia na sua CA local. uninstall reverte os três. Para verificar a instalação, abra http://numa.numa. Se o dashboard carregar, o Numa é o DNS do seu sistema.

Atualize o binário da mesma forma que o instalou (brew upgrade, cargo install numa ou execute novamente o install.sh). Executar install novamente reinicia o serviço com o novo binário e mantém o token e a CA.

No Linux, install reconfigura o systemd-resolved com um arquivo drop-in. uninstall o remove. Pare qualquer outro processo que ocupe a porta 53 (dnsmasq, incluindo o do NetworkManager) antes de instalar.

Fazendo login

Via loopback (localhost, 127.0.0.1, numa.numa), o dashboard e a API não exigem login. De qualquer outro endereço, incluindo o mapeamento de portas do Docker e o endereço LAN desta máquina, eles pedem o token da API. O Numa cria o token na primeira inicialização. Imprima-o com sudo numa token (um shell de administrador no Windows). Faça login com qualquer nome de usuário e esse token. Para definir seu próprio token, use [server] api_token ou NUMA_API_TOKEN.

Removendo todos os vestígios

uninstall restaura o DNS mas mantém o diretório de dados, então uma reinstalação mantém o mesmo token e CA. Para remover tudo, execute uninstall primeiro e depois exclua:

PlataformaO que fica para trás
macOSo binário, /usr/local/var/numa, /usr/local/var/log/numa.log
Linuxo binário e qualquer cópia em /usr/local/bin/numa, /var/lib/numa
Windowso binário, %PROGRAMDATA%\numa
iPhoneo perfil "Numa DNS" (Ajustes → Geral → VPN e Gerenciamento de Dispositivos)

Exclua também ~/.config/numa se você criou uma configuração de usuário. Se você definiu [server] data_dir, exclua esse caminho também.

Como se Compara

Pi-holeAdGuard HomeUnboundNuma
Proxy de serviço local + TLS automáticoNãoNãoNãoDomínios .numa, HTTPS, WebSocket
Descoberta de serviços na LANNãoNãoNãomDNS (numa lan on)
Substituições com reversão automáticaNãoNãoNãoAPI REST, programável
Resolvedor recursivoNãoNãoSimSim
Validação DNSSECSimDepende do upstreamSimSim (modo recursivo)
Bloqueio de anúnciosSimSimNãoSim (Hagezi Pro por padrão, listas personalizadas)
Regras por clienteGruposSimViews / tagsPor CIDR ([[client_policy]]), somente arquivo de configuração
Interface web de administraçãoCompletaCompletaNãoDashboard
Upstream criptografadoPrecisa de cloudflaredDoH, DoT, DoQ, DNSCryptDoTDoH, DoT, ODoH
Clientes criptografados (listener DoT)Precisa de sidecar stunnelSimSimSim (RFC 7858)
Endpoint de servidor DoHNãoSimSimSim (RFC 8484)
Consultas paralelas ao upstreamdnsmasq all-serversModo paraleloNãoRequest hedging (UDP, DoH, DoT)
Serve-stale + prefetchNãoCache otimistaSim (RFC 8767, prefetch)Sim (RFC 8767, prefetch)
Encaminhamento condicionalSimSimSimSim (regras por sufixo)
MaturidadeMaduroMaduroMaduroNovo

O que o Numa não faz. Sem DHCP, sem clustering, sem sincronização de configuração entre instâncias. A maioria das configurações fica no arquivo de configuração, não no dashboard.

Configuração

As configurações ficam em um único arquivo TOML. numa config path imprime qual arquivo sua instalação usa. numa config edit o abre. Após uma alteração, execute sudo numa service restart. numa -c FILE executa o Numa, ou esses comandos, em um arquivo de sua escolha. numa.toml documenta cada opção inline.

No Windows, o Numa escuta em 127.0.0.2:53, porque o serviço DNS Client (Dnscache) é proprietário de 127.0.0.1:53. Mantenha 127.0.0.2 quando editar bind_addr.

Serviços Locais

Dê nomes aos seus serviços de desenvolvimento em vez de memorizar números de porta:

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

Assim que o Numa for o DNS do seu sistema (numa install), https://frontend.numa funciona no seu navegador, com um certificado válido e passthrough de WebSocket para HMR. Sem mkcert, sem nginx, sem /etc/hosts.

Categorias