caddyserver/cache-handler
caddyserver/cache-handler — dự án mã nguồn mở — đang có 394 sao GitHub. Distributed HTTP caching module for Caddy
Tóm tắt dựng từ metadata GitHub của chính dự án — chưa có bài review TopGit. Trang sẽ tự động cập nhật khi bài review đầy đủ được xuất bản.
TopGit viết bài đầy đủ cho repo có nhiều sao nhất và được yêu cầu nhiều nhất. Trang này là snapshot trong thời gian chờ — xem README gốc ở tab READ ME.
Snapshot
Cộng tác viên hàng đầu
Xem cộng tác viên hàng đầu
Caddy Module: http.handlers.cache
This is a distributed HTTP cache module for Caddy based on Souin cache.
[!WARNING] Since
v1.7.0Souin (the development repository that cache-handler is based on) implements only one storage. If you need a specific storage you have to take it from the storages repository and add it either in your code, during the build otherwise.
(e.g. with otter using caddy) You have to build your caddy module with the desired storagexcaddy build --with github.com/caddyserver/cache-handler --with github.com/darkweak/storages/otter/caddyand configure otter in your Caddyfile/JSON configuration file.
See the documentation about the storages.
Features
- RFC 7234 compliant HTTP Cache.
- Sets the
Cache-StatusHTTP Response Header - REST API to purge the cache and list stored resources.
- ESI tags processing (using the go-esi package).
- Builtin support for distributed cache.
Minimal Configuration
Using the minimal configuration the responses will be cached for 120s
{
cache
}
example.com {
cache
reverse_proxy your-app:8080
}
Global Option Syntax
Here are all the available options for the global options
{
log {
level debug
}
cache {
allowed_http_verbs GET POST PATCH
api {
basepath /some-basepath
prometheus
souin {
basepath /souin-changed-endpoint-path
}
}
badger {
path the_path_to_a_file.json
}
cache_keys {
.*\.css {
disable_body
disable_host
disable_method
disable_query
headers X-Token Authorization
hide
}
}
cache_name Another
cdn {
api_key XXXX
dynamic
email [email protected]
hostname domain.com
network your_network
provider fastly
strategy soft
service_id 123456_id
zone_id anywhere_zone
}
etcd {
configuration {
# Your etcd configuration here
}
}
key {
disable_body
disable_host
disable_method
headers Content-Type Authorization
}
log_level debug
mode bypass
nuts {
path /path/to/the/storage
}
olric {
url url_to_your_cluster:3320
path the_path_to_a_file.yaml
configuration {
# Your olric configuration here
}
}
regex {
exclude /test2.*
}
stale 200s
ttl 1000s
default_cache_control no-store
}
}
:4443
respond "Hello World!"
Cache directive Syntax
Here are all the available options for the directive options
@match path /path
handle @match {
cache {
cache_name ChangeName
cache_keys {
(host1|host2).*\.css {
disable_body
disable_host
disable_method
disable_query
headers X-Token Authorization
}
}
cdn {
api_key XXXX
dynamic
email [email protected]
hostname domain.com
network your_network
provider fastly
strategy soft
service_id 123456_id
zone_id anywhere_zone
}
key {
disable_body
disable_host
disable_method
disable_query
headers Content-Type Authorization
}
log_level debug
regex {
exclude /test2.*
}
stale 200s
ttl 1000s
default_cache_control no-store
}
}
Provider Syntax
Badger
The badger provider must have either the path or the configuration directive.
badger-path.com {
cache {
badger {
path /tmp/badger/first-match
}
}
}
badger-configuration.com {
cache {
badger {
configuration {
# Required value
ValueDir <string>
# Optional
SyncWrites <bool>
NumVersionsToKeep <int>
ReadOnly <bool>
Compression <int>
InMemory <bool>
MetricsEnabled <bool>
MemTableSize <int>
BaseTableSize <int>
BaseLevelSize <int>
LevelSizeMultiplier <int>
TableSizeMultiplier <int>
MaxLevels <int>
VLogPercentile <float>
ValueThreshold <int>
NumMemtables <int>
BlockSize <int>
BloomFalsePositive <float>
BlockCacheSize <int>
IndexCacheSize <int>
NumLevelZeroTables <int>
NumLevelZeroTablesStall <int>
ValueLogFileSize <int>
ValueLogMaxEntries <int>
NumCompactors <int>
CompactL0OnClose <bool>
LmaxCompaction <bool>
ZSTDCompressionLevel <int>
VerifyValueChecksum <bool>
EncryptionKey <string>
EncryptionKeyRotationDuration <Duration>
BypassLockGuard <bool>
ChecksumVerificationMode <int>
DetectConflicts <bool>
NamespaceOffset <int>
}
}
}
}
Etcd
The etcd provider must have the configuration directive.
etcd-configuration.com {
cache {
etcd {
configuration {
Endpoints etcd1:2379 etcd2:2379 etcd3:2379
AutoSyncInterval 1s
DialTimeout 1s
DialKeepAliveTime 1s
DialKeepAliveTimeout 1s
MaxCallSendMsgSize 10000000
MaxCallRecvMsgSize 10000000
Username john
Password doe
RejectOldCluster false
PermitWithoutStream false
}
}
}
}
NutsDB
The nutsdb provider must have either the path or the configuration directive.
nuts-path.com {
cache {
nuts {
path /tmp/nuts-path
}
}
}
nuts-configuration.com {
cache {
nuts {
configuration {
Dir /tmp/nuts-configuration
EntryIdxMode 1
RWMode 0
SegmentSize 1024
NodeNum 42
SyncEnable true
StartFileLoadingMode 1
}
}
}
}
Olric
The olric provider must have either the url directive to work as client mode.
olric-url.com {
cache {
olric {
url olric:3320
}
}
}
The olric provider must have either the path or the configuration directive to work as embedded mode.
olric-path.com {
cache {
olric {
path /path/to/olricd.yml
}
}
}
olric-configuration.com {
cache {
nuts {
configuration {
Dir /tmp/nuts-configuration
EntryIdxMode 1
RWMode 0
SegmentSize 1024
NodeNum 42
SyncEnable true
StartFileLoadingMode 1
}
}
}
}
Redis
The redis provider must have either the URL or the configuration directive.
redis-url.com {
cache {
redis {
url 127.0.0.1:6379
}
}
}
redis-configuration.com {
cache {
redis {
configuration {
Network my-network
Addr 127.0.0.1:6379
Username user
Password password
DB 1
MaxRetries 1
MinRetryBackoff 5s
MaxRetryBackoff 5s
DialTimeout 5s
ReadTimeout 5s
WriteTimeout 5s
PoolFIFO true
PoolSize 99999
PoolTimeout 10s
MinIdleConns 100
MaxIdleConns 100
ConnMaxIdleTime 5s
ConnMaxLifetime 5s
}
}
}
}
You can also use the configuration. Refer to the Souin docs or rueidis client options to define your config as key value.
What does these directives mean?
| Key | Description | Value example |
|---|---|---|
allowed_http_verbs | The HTTP verbs allowed to be cached | GET POST PATCH(default: GET HEAD) |
allowed_additional_status_codes | The additional HTTP status codes allowed to be cached | 202 400 |
api | The cache-handler API cache management | |
api.basepath | BasePath for all APIs to avoid conflicts | /your-non-conflict-route(default: /souin-api) |
api.prometheus | Enable the Prometheus metrics | |
api.souin.basepath | Souin API basepath | /another-souin-api-route(default: /souin) |
badger | Configure the Badger cache storage | |
badger.path | Configure Badger with a file | /anywhere/badger_configuration.json |
badger.configuration | Configure Badger directly in the Caddyfile or your JSON caddy configuration | See the Badger configuration for the options |
cache_name | Override the cache name to use in the Cache-Status response header | Another Caddy Cache-Handler Souin |
cache_keys | Define the key generation rules for each URI matching the key regexp | |
cache_keys.{your regexp} | Regexp that the URI should match to override the key generation | .+\.css |
cache_keys.{your regexp} | Regexp that the URI should match to override the key generation | .+\.css |
cache_keys.{your regexp}.disable_body | Disable the body part in the key matching the regexp (GraphQL context) | true(default: false) |
cache_keys.{your regexp}.disable_host | Disable the host part in the key matching the regexp | true(default: false) |
cache_keys.{your regexp}.disable_method | Disable the method part in the key matching the regexp | true(default: false) |
cache_keys.{your regexp}.disable_query | Disable the query string part in the key matching the regexp | true(default: false) |
cache_keys.{your regexp}.headers | Add headers to the key matching the regexp | Authorization Content-Type X-Additional-Header |
cache_keys.{your regexp}.hide | Prevent the key from being exposed in the Cache-Status HTTP response header | true(default: false) |
cdn | The CDN management, if you use any cdn to proxy your requests Souin will handle that | |
cdn.provider | The provider placed before Souin | akamaifastlysouin |
cdn.api_key | The api key used to access to the provider | XXXX |
cdn.dynamic | Enable the dynamic keys returned by your backend application | (default: true) |
cdn.email | The api key used to access to the provider if required, depending the provider | XXXX |
cdn.hostname | The hostname if required, depending the provider | domain.com |
cdn.network | The network if required, depending the provider | your_network |
cdn.strategy | The strategy to use to purge the cdn cache, soft will keep the content as a stale resource | hard(default: soft) |
cdn.service_id | The service id if required, depending the provider | 123456_id |
cdn.zone_id | The zone id if required, depending the provider | anywhere_zone |
default_cache_control | Set the default value of Cache-Control response header if not set by upstream (Souin treats empty Cache-Control as public if omitted) | no-store |
key | Override the key generation with the ability to disable unecessary parts | |
key.disable_body | Disable the body part in the key (GraphQL context) | true(default: false) |
key.disable_host | Disable the host part in the key | true(default: false) |
key.disable_method | Disable the method part in the key | true(default: false) |
key.disable_query | Disable the query string part in the key | true(default: false) |
key.disable_scheme | Disable the scheme string part in the key | true(default: false) |
key.disable_vary | Disable the varied headers part in the key | true(default: false) |
key.hash | Hash the key before store it in the storage to get smaller keys | true(default: false) |
key.headers | Add headers to the key matching the regexp | Authorization Content-Type X-Additional-Header |
key.hide | Prevent the key from being exposed in the Cache-Status HTTP response header | true(default: false) |
key.template | Use caddy templates to create the key (when this option is enabled, disable_* directives are skipped) | KEY-{http.request.uri.path}-{http.request.uri.query} |
max_cacheable_body_bytes | Set the maximum size (in bytes) for a response body to be cached (unlimited if omited) | 1048576 (1MB) |
mode | Bypass the RFC respect | One of bypass bypass_request bypass_response strict (default strict) |
nuts | Configure the Nuts cache storage | |
nuts.path | Set the Nuts file path storage | /anywhere/nuts/storage |
nuts.configuration | Configure Nuts directly in the Caddyfile or your JSON caddy configuration | See the Nuts configuration for the options |
etcd | Configure the Etcd cache storage | |
etcd.configuration | Configure Etcd directly in the Caddyfile or your JSON caddy configuration | See the Etcd configuration for the options |
olric | Configure the Olric cache storage | |
olric.path | Configure Olric with a file | /anywhere/olric_configuration.json |
olric.configuration | Configure Olric directly in the Caddyfile or your JSON caddy configuration | See the Olric configuration for the options |
otter | Configure the Otter cache storage | |
otter.configuration | Configure Otter directly in the Caddyfile or your JSON caddy configuration | |
otter.configuration.size | Set the size of the pool in Otter | 999999 (default 10000) |
redis | Configure the Redis cache storage | |
redis.url | Set the Redis url storage | localhost:6379 |
redis.configuration | Configure Redis directly in the Caddyfile or your JSON caddy configuration | See the Nuts configuration for the options |
regex.exclude | The regex used to prevent paths being cached | ^[A-z]+.*$ |
stale | The stale duration | 25m |
storers | Storers chain to fallback if a previous one is unreachable or don't have the resource | otter nuts badger redis |
timeout | The timeout configuration | |
timeout.backend | The timeout duration to consider the backend as unreachable | 10s |
timeout.cache | The timeout duration to consider the cache provider as unreachable | 10ms |
ttl | The TTL duration | 120s |
log_level | The log level | One of DEBUG, INFO, WARN, ERROR, DPANIC, PANIC, FATAL it's case insensitive |
Other resources
You can find an example for the Caddyfile or the JSON file.
See the Souin configuration for the full configuration, and its associated Caddyfile
Development and Stable Versions
The Souin repository serves as the development version, where new features are introduced and tested. Once these features have been thoroughly stabilized, they are integrated into the cache-handler repository through a dependency update. This ensures that cache-handler remains the stable and reliable version for production use.
Repo liên quan
Master programming by recreating your favorite technologies from scratch.
A curated meta-list of curated lists organized by technology domain. The repository acts as a directory pointing to hundreds of specialized awesome lists covering programming languages, platforms, frameworks, and tooling. All content is community-contributed under the CC0 public domain dedication.
Public APIs is a community-curated GitHub repository listing free, publicly accessible APIs across a wide range of categories, with auth type, HTTPS, and CORS noted for each entry. It's a browsable reference, not a library to install.
freeCodeCamp is a free, self-paced curriculum for learning to code, published as open source at freeCodeCamp/freeCodeCamp. It's a 501(c)(3) nonprofit funded by donor support, structured around six certifications in its Full-Stack Developer Curriculum, each gated by required projects instead of open-book quizzes. The repository also carries beta language certifications for developers, interview-prep resources, and the code that runs the live freecodecamp.org platform.
Trả lời nhanh
caddyserver/cache-handler có bao nhiêu sao?
caddyserver/cache-handler có 394 sao GitHub — tải lại trang để xem số mới nhất, hoặc xem trực tiếp github.com/caddyserver/cache-handler. TopGit phản chiếu số sao của GitHub nhưng không cam kết đến từng phút.
caddyserver/cache-handler có phải mã nguồn mở không?
Có — caddyserver/cache-handler phát hành theo license Apache-2.0, nghĩa là mã nguồn mở để đọc, fork và (tùy license) tái sử dụng. Mã: github.com/caddyserver/cache-handler.
caddyserver/cache-handler có website riêng không?
TopGit chưa ghi nhận URL trang chủ cho caddyserver/cache-handler. Phần README ở tab phía trên thường có link demo, hoặc xem mô tả GitHub của repo.
caddyserver/cache-handler là gì?
caddyserver/cache-handler (caddyserver/cache-handler) là dự án Go trên GitHub. Theo mô tả gốc: Distributed HTTP caching module for Caddy
Đọc thêm về caddyserver/cache-handler ở đâu?
Trang TopGit này là một snapshot — tab "Readme" hiển thị nguyên văn README của repo (đã bỏ link, giữ ảnh). Repo GitHub ở github.com/caddyserver/cache-handler là nguồn chính thức.
Đọc đầy đủ README ở tab phía trên.
Chưa chắc cache-handler có hợp với bạn?
Để ChatGPT, Claude hoặc Perplexity tìm hiểu giúp — bấm bên dưới và xem AI nói gì về cache-handler.