devns

Dominio local https://<nombre>.test sin puerto para macOS.

devns add webui 8080
# ✓ https://webui.test → 127.0.0.1:8080 (caddy admin load HTTP 200)

Una CLI que lo prepara todo: dnsmasq (comodín *.test → 127.0.0.1), Caddy (único titular de los puertos 80/443, HTTPS automático vía CA interna), y un bridge DoH local opcional para que los navegadores con Secure DNS puedan seguir abriendo dominios .test.

¿Por qué es necesario?

Related MCP server: DDEV MCP Server

Instalación

Requiere: macOS + uv + Homebrew.

git clone https://github.com/apiep/devns && cd devns
uv tool install --editable .
devns init          # sekali saja — minta sudo interaktif 2-3x
devns doh install   # opsional: bridge DoH utk browser secure-DNS

devns init prepara:

1. brew install dnsmasq caddy si aún no existen

2. /etc/resolver/test → macOS enruta el TLD .test a 127.0.0.1

3. Bloque address=/.test/127.0.0.1 en dnsmasq.conf + servicio root en :53

4. Caddyfile principal (import ~/.config/devns/sites/*.caddy) + servicio root 80/443

5. CA interna de Caddy al almacén de confianza del sistema (sudo caddy trust)

6. Bridge DoH (dnsproxy de AdGuard — binario de descarga automática según SO/arquitectura)

En el día a día sin sudo en absoluto: add/rm/ls/open/doctor/doh/log.

Uso

devns add pueue 7337          # daftarkan domain + reload Caddy + cek port
devns add api 3000 --open     # sekalian buka browser
devns ls                      # ● https://pueue.test → 127.0.0.1:7337
devns open pueue              # buka di browser default
devns rm pueue                # hapus (konfirmasi; -y skip)
devns doctor                  # kesehatan: resolver/DNS/Caddy/HTTPS/DoH

devns doh install             # bridge DoH (LaunchAgent user-level)
devns doh status
devns doh log -f              # ikuti log dnsproxy live

Navegadores con Secure DNS

Después de devns doh install, configura Secure DNS en Custom: https://dns.test:8443/dns-query. Las consultas .test se responden localmente; todas las demás se reenvían cifradas al upstream DoH que elijas (por defecto OpenDNS).

Arquitectura

Browser ──DoH──> dns.test:8443 (dnsproxy, launchd io.devns.doh)
                   ├─ [/test/] ──> dnsmasq :53 ──> 127.0.0.1
                   └─ lainnya  ──> https://doh.opendns.com/dns-query

Browser ──HTTPS──> Caddy :443 ──reverse_proxy──> 127.0.0.1:<port-app>
        ──HTTP───> Caddy :80  ──308──> HTTPS
                     cert: Caddy Local Authority (tls internal), per-hostname on-demand

• Registry: ~/.config/devns/registry.yaml = única fuente de verdad

• Site files: ~/.config/devns/sites/<nombre>.caddy (artefactos generados; la plantilla usa flush_interval -1 para que SSE no se almacene en búfer)

• Recarga diaria: endpoint de administración de Caddy localhost:2019 con cabecera Content-Type: text/caddyfile

Servidor MCP

devns incluye un servidor MCP stdio sin dependencias adicionales:

hermes mcp add devns --command devns-mcp    # Hermes Agent
# atau konfigurasi MCP client lain (Claude Desktop dsb) dengan command "devns-mcp"

Tools: list_domains, add_domain, remove_domain, check_health, doh_status.

Skill para agentes de IA

Este repositorio incluye una skill portátil en skills/devns/SKILL.md (formato agentskills.io / Claude skills). Cópiala o haz un symlink al directorio de skills de tu agente.

Notas de diseño (lecciones reales)

• El comodín *.test es rechazado por los verificadores modernos — Chrome y curl rechazan un certificado comodín que se adhiere directamente al TLD aunque el SAN sea válido según RFC. Por eso el certificado se crea por hostname bajo demanda con la CA interna de Caddy.

• El puerto 5353 ya lo usa mDNSResponder (Bonjour) → el bridge DoH usa 5335.

• /etc/resolver/test hace que la resolución se cuelgue (no que falle rápido) cuando dnsmasq está caído — es señal de que el resolver está activo, no un bug.

Licencia

MIT