Node.js · Demos

http-proxy

donly/demo/http-proxy es un proxy inverso y servidor de pruebas configurado con un archivo DON. Usa Bun.serve(), así que necesita Bun, y sirve de ejemplo de un lenguaje de configuración propio construido sobre donly. No está pensado para producción.

server {
  host "0.0.0.0"
  port 8080
  http1 true
  http2 false
  http3 false

  header "X-Powered-By" "donly-demo-proxy"

  route GET /api/health {
    respond 200 "OK"
  }

  route /app {
    proxy_pass "http://localhost:3000"
    header "X-Forwarded-Host" "example.com"
  }
}
import { serve } from "donly/demo/http-proxy";

const server = await serve("./my-donly-server-file.donly");
// o con una URL: serve(new URL("./my.donly", import.meta.url))

server.servers; // Bun.Server[], uno por bloque server
await server.stop(); // deja de vigilar el archivo y detiene los servidores

Esquema

Validación con lint

Cada lectura del archivo se valida con donly/lint contra el esquema (proxyLintRules, exportado desde el mismo módulo). Un error rechaza el archivo: al inicio serve() lanza una excepción y, tras una edición, los servidores siguen con la configuración anterior. Un warning o info se imprime pero el archivo se aplica.

Recarga en caliente

  1. Al cambiar el archivo se vuelve a leer y a validar.
  2. Con errores, se registran y los servidores siguen sirviendo la última configuración válida.
  3. Si solo cambiaron route o header, se aplica con server.reload(), sin cortar conexiones.
  4. Si cambió host, port, http1/2/3 o ssl, ese servidor se reinicia.
  5. Si cambió la cantidad de bloques server, se reinician todos.