Namespace dei moduli

I moduli guest di Caddy sono caricati genericamente come tipi interface{} o any. Affinché i moduli host possano utilizzarli, i moduli guest caricati vengono solitamente sottoposti a type-assertion verso un tipo noto. Questa pagina descrive la mappatura dai namespace dei moduli ai tipi Go per tutti i moduli standard.

La documentazione per i namespace dei moduli non standard può essere trovata con la documentazione del modulo host che li definisce.

Namespace Tipo interfaccia atteso Descrizione Note
caddy.App App Caddy
admin.api caddy.AdminRouter

caddy.AdminHandler
Registra rotte HTTP per admin

Middleware handler HTTP
caddy.config_loaders caddy.ConfigLoader Carica una configurazione ⚠️ Sperimentale
caddy.fs fs.FS File system virtuale ⚠️ Sperimentale
caddy.listeners caddy.ListenerWrapper Avvolge i listener di rete
caddy.logging.encoders zapcore.Encoder Encoder voci di log
caddy.logging.encoders.filter logging.LogFieldFilter Filtro campi di log
caddy.logging.writers caddy.WriterOpener Writer di log
caddy.storage caddy.StorageConverter Backend di storage
dns.providers certmagic.DNSProvider Solutore sfida DNS
events.handlers caddyevents.Handler Handler di eventi ⚠️ Sperimentale
http.authentication.hashes caddyauth.Comparer

caddyauth.Hasher
Comparatori password

Hasher password
http.authentication.providers caddyauth.Authenticator Provider autenticazione HTTP
http.encoders encode.Encoding

encode.Encoder
Crea un encoder (compressione)

Codifica un flusso di dati
http.handlers caddyhttp.MiddlewareHandler Handler HTTP
http.ip_sources caddyhttp.IPRangeSource Intervalli IP per proxy fidati
http.matchers caddyhttp.RequestMatcher

caddyhttp.RequestMatcherWithError

caddyhttp.CELLibraryProducer
Matcher di richiesta (usa WithError al suo posto)

Matcher di richiesta con errore short-circuit

Supporto per espressioni CEL
⚠️ Deprecato



(Opzionale)
http.precompressed encode.Precompressed Mappature precompresse supportate
http.reverse_proxy.circuit_breakers reverseproxy.CircuitBreaker Circuit breaker reverse proxy
http.reverse_proxy.selection_policies reverseproxy.Selector Policy di selezione bilanciamento del carico
http.reverse_proxy.transport http.RoundTripper Trasporti reverse proxy HTTP
http.reverse_proxy.upstreams reverseproxy.UpstreamSource Sorgente upstream dinamica ⚠️ Sperimentale
tls.ca_pool.source caddytls.CA Sorgente di certificati root fidati
tls.certificates caddytls.CertificateLoader Sorgente certificati TLS
tls.client_auth caddytls.ClientCertificateVerifier Verifica certificati client
tls.ech.publishers caddytls.ECHPublisher Pubblica configurazioni Encrypted ClientHello (ECH) ⚠️ Sperimentale
tls.get_certificate certmagic.Manager Gestore certificati TLS ⚠️ Sperimentale
tls.handshake_match caddytls.ConnectionMatcher Matcher connessione TLS
tls.issuance certmagic.Issuer Emittente certificati TLS
tls.leaf_cert_loader caddytls.LeafCertificateLoader Carica certificati foglia fidati
tls.permission caddytls.OnDemandPermission Se ottenere un certificato per un dominio ⚠️ Sperimentale
tls.stek caddytls.STEKProvider Sorgente chiave session ticket TLS
tls.context caddytls.HandshakeContext Intercetta contesto GetCertificate ⚠️ Sperimentale

I namespace contrassegnati come "Sperimentale" sono soggetti a modifiche. (Sviluppate con essi così da poterne finalizzare le interfacce!)