模組命名空間
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 工作階段票證金鑰來源 |
標記為「實驗性功能」的命名空間可能會變更。（請使用它們進行開發，以便我們可以最終確定它們的介面！）