poseidon-http-client

Primeros pasos

Mon, 01 Jan 0001 00:00:00 +0000

Primeros pasos#

poseidon-http-client es un cliente HTTP de bajo nivel para Go. Implementa HTTP/1.1, HTTP/2 y HTTP/3 desde cero — con su propio framing, HPACK, QPACK y stack QUIC — sin net/http y sin bibliotecas de protocolo de terceros. Está pensado para generadores de carga y herramientas que necesitan control directo sobre conexiones, streams y control de flujo.

Instalación#

Requiere Go 1.25 o superior.

go get github.com/lodgvideon/poseidon-http-client

El modelo de peticiones#

Las tres versiones del protocolo comparten la misma API. Se construye un cliente con un constructor y después se llama a Do con un contexto, una petición y un *client.Response que es propiedad del llamador:

HTTP/1.1

Mon, 01 Jan 0001 00:00:00 +0000

HTTP/1.1#

Use HTTP/1.1 cuando el servidor de destino no hable HTTP/2, o cuando quiera probar específicamente su ruta HTTP/1.1 y necesite impedir que la negociación ALPN promueva la conexión a h2.

HTTP/1.1 tiene el mismo conjunto de constructores que HTTP/2 y HTTP/3:

Constructor	Transporte	Forma
`NewH1Client(addr, dialer, opts...)`	`TransportH1SingleConn`	Una conexión, reconexión automática. Las peticiones se serializan.
`NewH1PoolClient(addr, dialer, pool, opts...)`	`TransportH1Pool`	Hasta `MaxConnsPerHost` conexiones. Ese número es la concurrencia de peticiones.
`NewManagedH1Client(resolver, dialer, opts...)`	`TransportH1Managed`	Descubrimiento de servicios con Resolver + Selector; un sub-pool HTTP/1.1 por dirección reparte la carga.

Forzar HTTP/1.1#

Dos cosas fijan el protocolo:

HTTP/2

Mon, 01 Jan 0001 00:00:00 +0000

HTTP/2#

El cliente HTTP/2 implementa RFC 7540 y HPACK (RFC 7541) desde cero — sin net/http, sin golang.org/x/net/http2. Tres constructores cubren las topologías habituales: una sola conexión, un pool por host, o un conjunto de backends gobernado por un resolver. Los tres devuelven un *client.Client con la misma API Do / DoStream.

Conexión única#

client.NewSingleConnClient mantiene una conexión y vuelve a marcar automáticamente cuando se cae. Este es examples/http2/main.go:

// Command http2-example issues a single HTTP/2 GET with the poseidon client.
// TransportSingleConn (the default) negotiates h2 over TLS and reuses one
// connection with automatic redial.
//
//	go run ./examples/http2
package main

import (
	"context"
	"crypto/tls"
	"fmt"
	"log"
	"time"

	"github.com/lodgvideon/poseidon-http-client/client"
	"github.com/lodgvideon/poseidon-http-client/conn"
)

func main() {
	c, err := client.NewSingleConnClient(
		"www.cloudflare.com:443",
		&conn.TLSDialer{Config: &tls.Config{
			ServerName: "www.cloudflare.com",
			NextProtos: []string{"h2"},
		}},
	)
	if err != nil {
		log.Fatalf("build client: %v", err)
	}
	defer func() { _ = c.Close() }()

	ctx, cancel := context.WithTimeout(context.Background(), 10*time.Second)
	defer cancel()

	// Response is caller-owned and reusable; Reset() clears it between requests.
	resp := &client.Response{}
	if err := c.Do(ctx, client.GET("/"), resp); err != nil {
		log.Fatalf("GET /: %v", err)
	}
	fmt.Printf("HTTP/2 %d — %d bytes\n", resp.Status, len(resp.Body))
}

Response pertenece al llamador: asígnalo una vez y llama a resp.Reset() entre peticiones. client.GET(path) es una forma abreviada; construye un client.Request{Method, Scheme, Authority, Path, BodyMode} directamente para tener control total.

HTTP/3

Mon, 01 Jan 0001 00:00:00 +0000

HTTP/3#

El cliente HTTP/3 (RFC 9114) funciona sobre una pila QUIC (RFC 9000/9001/9002) y un códec QPACK (RFC 9204) implementados en este repositorio — sin quic-go, sin cgo. Solo el handshake TLS 1.3 en sí proviene de la biblioteca estándar crypto/tls; la protección de paquetes, la recuperación de pérdidas, el control de congestión y el control de flujo son código de poseidon.

La API de peticiones es el mismo Do / DoStream que se usa con HTTP/2. Un client.Request y un client.Response no cambian entre transportes; pasar una prueba de carga de H2 a H3 es solo cambiar el constructor.

Características y ventajas

Mon, 01 Jan 0001 00:00:00 +0000

Características y ventajas#

Matriz de soporte#

Las tres versiones del protocolo comparten la misma API de peticiones: client.Do / client.DoStream con un client.Response reutilizable, propiedad del llamador. La compresión también es compartida: las respuestas se decodifican para gzip, deflate, br y zstd (el cliente anuncia accept-encoding: gzip, deflate, br, zstd), y Request.CompressBody comprime los cuerpos de las peticiones — véase Compresión más abajo. Lo que varía es cuánto del protocolo expone cada transporte.

Aviso legal

Mon, 01 Jan 0001 00:00:00 +0000

Aviso legal#

poseidon-http-client es software joven. Esta es su primera versión. Lea esta página antes de depender de él.

Sin garantía#

La biblioteca se distribuye bajo licencia MIT y se proporciona tal cual, sin garantía de ningún tipo. La usa bajo su propio riesgo. Consulte el archivo LICENSE para los términos exactos.

Código sensible a la seguridad, sin auditoría externa#

Esta biblioteca implementa desde cero protocolos sensibles a la seguridad: el transporte QUIC (RFC 9000/9001/9002), la protección de registros TLS 1.3 para QUIC, HPACK (RFC 7541) y QPACK (RFC 9204). No reutiliza net/http, quic-go ni ninguna otra implementación de protocolo consolidada en estas rutas.