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
-
server: una instancia que escucha; puede haber varias.-
host(opcional,"0.0.0.0"por defecto) yport(obligatorio, de 0 a 65535; 0 deja que el sistema elija). -
http1(por defectotrue),http2yhttp3(por defectofalse). HTTP/2 y HTTP/3 requieren TLS. Bun no soporta HTTP/3, así que conhttp3 truese sirve HTTP/2 y se imprime una advertencia. -
ssl { cert <ruta> key <ruta> }(opcional). Con HTTP/2 o HTTP/3 y sinsslse usa un certificado de desarrollo incluido: no lo uses en producción. -
header nombre valor: agrega un encabezado de respuesta a todas las rutas. Se puede repetir. -
route [método] ruta { ... }: sin método coincide con cualquiera. Dentro debe haber exactamente uno derespondoproxy_pass.
-
-
respond estado cuerpo: responde de inmediato. -
proxy_pass url: reenvía método, encabezados y cuerpo a la URL, añadiendo la parte de la ruta posterior a la de laroute. -
header nombre valordentro de unarouteagrega un encabezado solo para esa ruta.
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
- Al cambiar el archivo se vuelve a leer y a validar.
- Con errores, se registran y los servidores siguen sirviendo la última configuración válida.
-
Si solo cambiaron
routeoheader, se aplica conserver.reload(), sin cortar conexiones. -
Si cambió
host,port,http1/2/3ossl, ese servidor se reinicia. -
Si cambió la cantidad de bloques
server, se reinician todos.