模块命名空间
Caddy 访客模块以泛型 interface{} 或 any 类型加载。为了使宿主模块能够使用它们，加载的访客模块通常首先被类型断言为已知类型。此页面描述了所有标准模块从模块命名空间到 Go 类型的映射。
非标准模块命名空间的文档可以在定义它们的主机模块的文档中找到。
| 命名空间 | 期望的接口类型 | 描述 | 注释 |
|---|---|---|---|
caddy.App |
Caddy 应用 | ||
| admin.api | caddy.AdminRoutercaddy.AdminHandler |
为管理员注册 HTTP 路由 HTTP 处理程序中间件 |
|
| caddy.config_loaders | caddy.ConfigLoader |
加载配置 | ⚠️ 实验性 |
| caddy.fs | fs.FS |
虚拟文件系统 | ⚠️ 实验性 |
| caddy.listeners | caddy.ListenerWrapper |
包装网络监听器 | |
| caddy.logging.encoders | zapcore.Encoder |
日志条目编码器 | |
| caddy.logging.encoders.filter | logging.LogFieldFilter |
日志字段过滤器 | |
| caddy.logging.writers | caddy.WriterOpener |
日志写入器 | |
| caddy.storage | caddy.StorageConverter |
存储后端 | |
| dns.providers | certmagic.DNSProvider |
DNS 挑战求解器 | |
| events.handlers | caddyevents.Handler |
事件处理程序 | ⚠️ 实验性 |
| http.authentication.hashes | caddyauth.Comparercaddyauth.Hasher |
密码比较器 密码哈希器 |
|
| http.authentication.providers | caddyauth.Authenticator |
HTTP 身份验证提供程序 | |
| http.encoders | encode.Encodingencode.Encoder |
创建编码器（压缩） 编码数据流 |
|
| http.handlers | caddyhttp.MiddlewareHandler |
HTTP 处理程序 | |
| http.ip_sources | caddyhttp.IPRangeSource |
受信任代理的 IP 范围 | |
| http.matchers | caddyhttp.RequestMatchercaddyhttp.CELLibraryProducer |
HTTP 请求匹配器 支持 CEL 表达式 |
（可选） |
| http.precompressed | encode.Precompressed |
支持的预压缩映射 | |
| http.reverse_proxy.circuit_breakers | reverseproxy.CircuitBreaker |
反向代理断路器 | |
| http.reverse_proxy.selection_policies | reverseproxy.Selector |
负载均衡选择策略 | |
| http.reverse_proxy.transport | http.RoundTripper |
HTTP 反向代理传输 | |
| http.reverse_proxy.upstreams | reverseproxy.UpstreamSource |
动态上游源 | ⚠️ 实验性 |
| tls.ca_pool.source | caddytls.CA |
受信任根证书的来源 | |
| tls.certificates | caddytls.CertificateLoader |
TLS 证书来源 | |
| tls.client_auth | caddytls.ClientCertificateVerifier |
验证客户端证书 | |
| tls.ech.publishers | caddytls.ECHPublisher |
发布加密的客户端问候 (ECH) 配置 | ⚠️ 实验性 |
| tls.get_certificate | certmagic.Manager |
TLS 证书管理器 | ⚠️ 实验性 |
| tls.handshake_match | caddytls.ConnectionMatcher |
TLS 连接匹配器 | |
| tls.issuance | certmagic.Issuer |
TLS 证书颁发者 | |
| tls.leaf_cert_loader | caddytls.LeafCertificateLoader |
加载受信任的叶证书 | |
| tls.permission | caddytls.OnDemandPermission |
是否为域获取证书 | ⚠️ 实验性 |
| tls.stek | caddytls.STEKProvider |
TLS 会话票证密钥源 |
标记为“实验性”的命名空间可能会更改。（请使用它们进行开发，以便我们最终确定它们的接口！）