Souin Table of Contents

Souin reverse-proxy cache
Configuration
2.1. Required configuration
2.1.1. Souin as plugin
2.1.2. Souin out-of-the-box
2.2. Optional configuration
APIs
3.1. Prometheus API
3.2. Souin API
3.3. Security API
Diagrams
4.1. Sequence diagram
Cache systems
GraphQL
Examples
7.1. Træfik container
Plugins
8.1. Caddy module
8.1. Chi middleware
8.3. Echo middleware
8.4. Gin middleware
8.5. Skipper filter
8.6. Træfik plugin
8.7. Tyk plugin
8.8. Webgo middleware
8.9. Prestashop plugin
8.10. Wordpress plugin
Credits

Souin HTTP cache

Project description

Souin is a new HTTP cache system suitable for every reverse-proxy. It can be either placed on top of your current reverse-proxy whether it's Apache, Nginx or as plugin in your favorite reverse-proxy like Træfik, Caddy or Tyk.
Since it's written in go, it can be deployed on any server and thanks to the docker integration, it will be easy to install on top of a Swarm, or a kubernetes instance.
It's RFC compatible, supporting Vary, request coalescing, stale cache-control and other specifications related to the RFC-7234.
It also supports the Cache-Status HTTP response header and the YKey group such as Varnish.

Disclaimer

If you need redis or other custom cache providers, you have to use the fully-featured version. You can read the documentation, on the fully-featured branch to understand the specific parts.

Configuration

The configuration file is store at /anywhere/configuration.yml. You can supply your own as long as you use one of the minimal configurations below.

Required configuration

Souin as plugin

default_cache: # Required
  ttl: 10s # Default TTL

Souin out-of-the-box

default_cache: # Required
  ttl: 10s # Default TTL
reverse_proxy_url: 'http://traefik' # If it's in the same network you can use http://your-service, otherwise just use https://yourdomain.com

Key	Description	Value example
`default_cache.ttl`	Duration to cache request (in seconds)	10

Besides, it's highly recommended to set default_cache.default_cache_control (see it below) to avoid undesired caching for responses without Cache-Control header.

Optional configuration

# /anywhere/configuration.yml
api:
  basepath: /souin-api # Default route basepath for every additional APIs to avoid conflicts with existing routes
  prometheus: # Prometheus exposed metrics
    basepath: /anything-for-prometheus-metrics # Change the prometheus endpoint basepath
  souin: # Souin listing keys and cache management
    basepath: /anything-for-souin # Change the souin endpoint basepath
cdn: # If Souin is set after a CDN fill these informations
  api_key: XXXX # Your provider API key if mandatory
  provider: fastly # The provider placed before Souin (e.g. fastly, cloudflare, akamai, varnish)
  strategy: soft # The strategy to purge the CDN cache based on tags (e.g. soft, hard)
  dynamic: true # If true, you'll be able to add custom keys than the ones defined under the surrogate_keys key
default_cache:
  allowed_http_verbs: # Allowed HTTP verbs to cache (default GET, HEAD).
    - GET
    - POST
    - HEAD
  distributed: true # Use Olric distributed storage
  headers: # Default headers concatenated in stored keys
    - Authorization
  olric: # If distributed is set to true, you'll have to define the olric section
    url: 'olric:3320' # Olric server
  regex:
    exclude: 'ARegexHere' # Regex to exclude from cache
  stale: 1000s # Stale duration
  ttl: 1000s # Default TTL
  default_cache_control: no-store # Set default value for Cache-Control response header if not set by upstream
log_level: INFO # Logs verbosity [ DEBUG, INFO, WARN, ERROR, DPANIC, PANIC, FATAL ], case do not matter
ssl_providers: # The {providers}.json to use
  - traefik
urls:
  'https:\/\/domain.com\/first-.+': # First regex route configuration
    ttl: 1000s # Override default TTL
  'https:\/\/domain.com\/second-route': # Second regex route configuration
    ttl: 10s # Override default TTL
    headers: # Override default headers
    - Authorization
  'https?:\/\/mysubdomain\.domain\.com': # Third regex route configuration
    ttl: 50s # Override default TTL
    headers: # Override default headers
    - Authorization
    - 'Content-Type'
    default_cache_control: public, max-age=86400 # Override default default Cache-Control
ykeys:
  The_First_Test:
    headers:
      Content-Type: '.+'
  The_Second_Test:
    url: 'the/second/.+'
  The_Third_Test:
  The_Fourth_Test:
surrogate_keys:
  The_First_Test:
    headers:
      Content-Type: '.+'
  The_Second_Test:
    url: 'the/second/.+'
  The_Third_Test:
  The_Fourth_Test:

Key	Description	Value example
`api`	The cache-handler API cache management
`api.basepath`	BasePath for all APIs to avoid conflicts	`/your-non-conflicting-route` `(default: /souin-api)`
`api.{api}.enable`	(DEPRECATED) Enable the API with related routes	`true` `(default: true if you define the api name, false then)`
`api.{api}.security`	(DEPRECATED) Enable the JWT Authentication token verification	`true` `(default: false)`
`api.security.secret`	(DEPRECATED) JWT secret key	`Any_charCanW0rk123`
`api.security.users`	(DEPRECATED) Array of authorized users with username x password combo	`- username: admin` `password: admin`
`api.souin.security`	Enable JWT validation to access the resource	`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	`akamai` `fastly` `souin`
`cdn.api_key`	The api key used to access to the provider	`XXXX`
`cdn.dynamic`	Enable the dynamic keys returned by your backend application	`true` `(default: false)`
`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.allowed_http_verbs`	The HTTP verbs to support cache	`- GET` `- POST` `(default: GET, HEAD)`
`default_cache.badger`	Configure the Badger cache storage
`default_cache.badger.path`	Configure Badger with a file	`/anywhere/badger_configuration.json`
`default_cache.badger.configuration`	Configure Badger directly in the Caddyfile or your JSON caddy configuration	See the Badger configuration for the options
`default_cache.headers`	List of headers to include to the cache	`- Authorization` `- Content-Type` `- X-Additional-Header`
`default_cache.olric`	Configure the Olric cache storage
`default_cache.olric.path`	Configure Olric with a file	`/anywhere/olric_configuration.json`
`default_cache.olric.configuration`	Configure Olric directly in the Caddyfile or your JSON caddy configuration	See the Olric configuration for the options
`default_cache.port.{web,tls}`	The device's local HTTP/TLS port that Souin should be listening on	Respectively `80` and `443`
`default_cache.regex.exclude`	The regex used to prevent paths being cached	`^[A-z]+.*$`
`default_cache.stale`	The stale duration	`25m`
`default_cache.ttl`	The TTL duration	`120s`
`default_cache.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`
`log_level`	The log level	`One of DEBUG, INFO, WARN, ERROR, DPANIC, PANIC, FATAL it's case insensitive`
`reverse_proxy_url`	The reverse-proxy's instance URL (Apache, Nginx, Træfik...)	- `http://yourservice` (Container way) `http://localhost:81` (Local way) `http://yourdomain.com:81` (Network way)
`ssl_providers`	List of your providers handling certificates	`- traefik` `- nginx` `- apache`
`urls.{your url or regex}`	List of your custom configuration depending each URL or regex	'https://yourdomain.com'
`urls.{your url or regex}.ttl`	Override the default TTL if defined	`90s` `10m`
`urls.{your url or regex}.default_cache_control`	Override the default default `Cache-Control` if defined	`public, max-age=86400`
`urls.{your url or regex}.headers`	Override the default headers if defined	`- Authorization` `- 'Content-Type'`
`surrogate_keys.{key name}.headers`	Headers that should match to be part of the surrogate key group	`Authorization: ey.+` `Content-Type: json`
`surrogate_keys.{key name}.headers.{header name}`	Header name that should be present a match the regex to be part of the surrogate key group	`Content-Type: json`
`surrogate_keys.{key name}.url`	Url that should match to be part of the surrogate key group	`.+`
`ykeys.{key name}.headers`	(DEPRECATED) Headers that should match to be part of the ykey group	`Authorization: ey.+` `Content-Type: json`
`ykeys.{key name}.headers.{header name}`	(DEPRECATED) Header name that should be present a match the regex to be part of the ykey group	`Content-Type: json`
`ykeys.{key name}.url`	(DEPRECATED) Url that should match to be part of the ykey group	`.+`

APIs

All endpoints are accessible through the api.basepath configuration line or by default through /souin-api to avoid named route conflicts. Be sure to define an unused route to not break your existing application.

Prometheus API

Prometheus API expose some metrics about the cache.
The base path for the prometheus API is /metrics. Not supported inside Træfik because the deny the unsafe library usage inside plugins

Method	Endpoint	Description
`GET`	`/`	Expose the different keys listed below.

Key	Definition
`souin_request_counter`	Count the incoming requests
`souin_no_cached_response_counter`	Count the uncacheable responses
`souin_cached_response_counter`	Count the cacheable responses
`souin_avg_response_time`	Average response time

Souin API

Souin API allow users to manage the cache.
The base path for the souin API is /souin.
The Souin API supports the invalidation by surrogate keys such as Fastly which will replace the Varnish system. You can read the doc about this system. This system is able to invalidate by tags your cloud provider cache. Actually it supports Akamai and Fastly but in a near future some other providers would be implemented like Cloudflare or Varnish.

Method	Endpoint	Description
`GET`	`/`	List stored keys cache
`PURGE`	`/{id or regexp}`	Purge selected item(s) depending. The parameter can be either a specific key or a regexp
`PURGE`	`/?ykey={key}`	Purge selected item(s) corresponding to the target ykey such as Varnish (deprecated)

Security API

Security API allows users to protect other APIs with JWT authentication.
The base path for the security API is /authentication.

Method	Endpoint	Body	Headers	Description
`POST`	`/login`	`{"username":"admin", "password":"admin"}`	`['Content-Type' => 'json']`	Try to login, it returns a response which contains the cookie name `souin-authorization-token` with the JWT if succeed
`POST`	`/refresh`	`-`	`['Content-Type' => 'json', 'Cookie' => 'souin-authorization-token=the-token']`	Refreshes the token, replaces the old with a new one

Diagrams

Sequence diagram

See the sequence diagram for the minimal version below

Cache systems

Supported providers

Badger
Olric

The cache system sits on top of three providers at the moment. It provides an in-memory, redis and Olric cache systems because setting, getting, updating and deleting keys in these providers is as easy as it gets.
In order to do that, the Olric provider need to be either on the same network as the Souin instance when using docker-compose or over the internet, then it will use by default in-memory to avoid network latency as much as possible. Souin will return at first the in-memory response when it gives a non-empty response, then the olric one followed by the redis one with same condition, or fallback to the reverse proxy otherwise. Since v1.4.2, Souin supports Olric to handle distributed cache.

GraphQL

This feature is currently in beta.
Souin can partially cache your GraphQL requests. It automatically handles the data retrieval and omit the caching for the mutations.
However, it will invalidate whole cache keys with a body when you send a mutation request due to the inability to read and understand automatically which cached endpoint should be deleted.
You can enable the GraphQL support with the default_cache.allowed_http_verbs key to define the list of supported HTTP verbs like GET, POST, DELETE.

default_cache:
  allowed_http_verbs:
    - GET
    - POST
    - HEAD

Cache invalidation

The cache invalidation is built for CRUD requests, if you're doing a GET HTTP request, it will serve the cached response when it exists, otherwise the reverse-proxy response will be served.
If you're doing a POST, PUT, PATCH or DELETE HTTP request, the related cache GET request, and the list endpoint will be dropped.
It also supports invalidation via Souin API to invalidate the cache programmatically.

Examples

Træfik container

Træfik is a modern reverse-proxy which helps you to manage full container architecture projects.

# your-traefik-instance/docker-compose.yml
version: '3.7'

x-networks: &networks
  networks:
    - your_network

services:
  traefik:
    image: traefik:v2.5.6
    command: --providers.docker
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - /anywhere/traefik.json:/acme.json
    <<: *networks

  # your other services here...

networks:
  your_network:
    external: true

# your-souin-instance/docker-compose.yml
version: '3.7'

x-networks: &networks
  networks:
    - your_network

services:
  souin:
    image: darkweak/souin:latest
    ports:
      - 80:80
      - 443:443
    environment:
      GOPATH: /app
    volumes:
      - /anywhere/traefik.json:/ssl/traefik.json
      - /anywhere/configuration.yml:/configuration/configuration.yml
    <<: *networks

networks:
  your_network:
    external: true

Plugins

Caddy module

To use Souin as caddy module, you can refer to the Caddy module integration folder to discover how to configure it.
The related Caddyfile can be found here.
Then you just have to run the following command:

xcaddy build --with github.com/darkweak/souin/plugins/caddy

There is the fully configuration below

{
    order cache before rewrite
    log {
        level debug
    }
    cache {
        allowed_http_verbs GET POST PATCH
        api {
            basepath /some-basepath
            prometheus {
                security
            }
            souin {
                security
            }
        }
        badger {
            path the_path_to_a_file.json
        }
        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
        }
        headers Content-Type Authorization
        log_level debug
        olric {
            url url_to_your_cluster:3320
            path the_path_to_a_file.yaml
            configuration {
                # Your badger configuration here
            }
        }
        regex {
            exclude /test2.*
        }
        stale 200s
        ttl 1000s
        default_cache_control no-store
    }
}

:4443
respond "Hello World!"

@match path /test1*
@match2 path /test2*
@matchdefault path /default
@souin-api path /souin-api*

cache @match {
    ttl 5s
    badger {
        path /tmp/badger/first-match
        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>
            EncryptionKey <Duration>
            BypassLockGuard <bool>
            ChecksumVerificationMode <int>
            DetectConflicts <bool>
            NamespaceOffset <int>
        }
    }
}

cache @match2 {
    ttl 50s
    badger {
        path /tmp/badger/second-match
        configuration {
            ValueDir match2
            ValueLogFileSize 16777216
            MemTableSize 4194304
            ValueThreshold 524288
            BypassLockGuard true
        }
    }
    headers Authorization
    default_cache_control "public, max-age=86400"
}

cache @matchdefault {
    ttl 5s
    badger {
        path /tmp/badger/default-match
        configuration {
            ValueDir default
            ValueLogFileSize 16777216
            MemTableSize 4194304
            ValueThreshold 524288
            BypassLockGuard true
        }
    }
}

cache @souin-api {}

Chi middleware

To use Souin as chi middleware, you can refer to the Chi middleware integration folder to discover how to configure it.
You just have to define a new chi router and tell to the instance to use the Handle method like below:

import (
	"net/http"

	cache "github.com/darkweak/souin/plugins/chi"
	"github.com/go-chi/chi/v5"
)

func main(){

    // ...
	router := chi.NewRouter()
	httpcache := cache.NewHTTPCache(cache.DevDefaultConfiguration)
	router.Use(httpcache.Handle)
	router.Get("/*", defaultHandler)
    // ...

}

Echo middleware

To use Souin as echo middleware, you can refer to the Echo plugin integration folder to discover how to configure it.
You just have to define a new echo router and tell to the instance to use the process method like below:

import (
	"net/http"

	souin_echo "github.com/darkweak/souin/plugins/echo"
	"github.com/labstack/echo/v4"
)

func main(){

    // ...
	e := echo.New()
	s := souin_echo.New(souin_echo.DefaultConfiguration)
	e.Use(s.Process)
    // ...

}

Gin middleware

To use Souin as gin middleware, you can refer to the Gin plugin integration folder to discover how to configure it.
You just have to define a new gin router and tell to the instance to use the process method like below:

import (
	"net/http"

	souin_gin "github.com/darkweak/souin/plugins/gin"
	"github.com/gin-gonic/gin"
)

func main(){

    // ...
	r := gin.New()
	s := souin_gin.New(souin_gin.DefaultConfiguration)
	r.Use(s.Process())
    // ...

}

Skipper filter

To use Souin as skipper filter, you can refer to the Skipper plugin integration folder to discover how to configure it.
You just have to add to your Skipper instance the Souin filter like below:

package main

import (
	souin_skipper "github.com/darkweak/souin/plugins/skipper"
	"github.com/zalando/skipper"
	"github.com/zalando/skipper/filters"
)

func main() {
	skipper.Run(skipper.Options{
		Address:       ":9090",
		RoutesFile:    "example.yaml",
		CustomFilters: []filters.Spec{souin_skipper.NewSouinFilter()}},
	)
}

After that you will be able to declare the httpcache filter in your eskip file.

hello: Path("/hello") 
  -> httpcache(`{"api":{"basepath":"/souin-api","security":{"secret":"your_secret_key","enable":true,"users":[{"username":"user1","password":"test"}]},"souin":{"security":true,"enable":true}},"default_cache":{"headers":["Authorization"],"regex":{"exclude":"ARegexHere"},"ttl":"10s","stale":"10s"},"log_level":"INFO"}`)
  -> "https://www.example.org"

Træfik plugin

To use Souin as Træfik plugin, you can refer to the pilot documentation and the Træfik plugin integration folder to discover how to configure it.
You have to declare the experimental block in your traefik static configuration file. Keep in mind Træfik run their own interpreter and they often break any dependances (such as the yaml.v3 support).

# anywhere/traefik.yml
experimental:
  plugins:
    souin:
      moduleName: github.com/darkweak/souin
      version: v1.6.5

After that you can declare either the whole configuration at once in the middleware block or by service. See the examples below.

# anywhere/dynamic-configuration
http:
  routers:
    whoami:
      middlewares:
        - http-cache
      service: whoami
      rule: Host(`domain.com`)
  middlewares:
    http-cache:
      plugin:
        souin-plugin:
          api:
            prometheus: {}
            souin: {}
          default_cache:
            headers:
              - Authorization
              - Content-Type
            regex:
              exclude: '/test_exclude.*'
            ttl: 5s
            default_cache_control: no-store
          log_level: debug
          urls:
            'domain.com/testing':
              ttl: 5s
              headers:
                - Authorization
            'mysubdomain.domain.com':
              ttl: 50s
              headers:
                - Authorization
                - 'Content-Type'
              default_cache_control: public, max-age=86400
          ykeys:
            The_First_Test:
              headers:
                Content-Type: '.+'
            The_Second_Test:
              url: 'the/second/.+'
            The_Third_Test:
            The_Fourth_Test:
          surrogate_keys:
            The_First_Test:
              headers:
                Content-Type: '.+'
            The_Second_Test:
              url: 'the/second/.+'
            The_Third_Test:
            The_Fourth_Test:

# anywhere/docker-compose.yml
services:
#...
  whoami:
    image: traefik/whoami
    labels:
      # other labels...
      - traefik.http.routers.whoami.middlewares=http-cache
      - traefik.http.middlewares.http-cache.plugin.souin-plugin.api.souin
      - traefik.http.middlewares.http-cache.plugin.souin-plugin.default_cache.headers=Authorization,Content-Type
      - traefik.http.middlewares.http-cache.plugin.souin-plugin.default_cache.ttl=10s
      - traefik.http.middlewares.http-cache.plugin.souin-plugin.log_level=debug

Tyk plugin

To use Souin as a Tyk plugin, you can refer to the Tyk plugin integration folder to discover how to configure it.
You have to define the use of Souin as post and response custom middleware. You can compile your own Souin integration using the Makefile and the docker-compose inside the tyk integration directory and place your generated souin-plugin.so file inside your middleware directory.

{
  "name":"httpbin.org",
  "api_id":"3",
  "org_id":"3",
  "use_keyless": true,
  "version_data": {
    "not_versioned": true,
    "versions": {
      "Default": {
        "name": "Default",
        "use_extended_paths": true
      }
    }
  },
  "custom_middleware": {
    "pre": [],
    "post": [
      {
        "name": "SouinRequestHandler",
        "path": "/opt/tyk-gateway/middleware/souin-plugin.so"
      }
    ],
    "post_key_auth": [],
    "auth_check": {
      "name": "",
      "path": "",
      "require_session": false
    },
    "response": [
      {
        "name": "SouinResponseHandler",
        "path": "/opt/tyk-gateway/middleware/souin-plugin.so"
      }
    ],
    "driver": "goplugin",
    "id_extractor": {
      "extract_from": "",
      "extract_with": "",
      "extractor_config": {}
    }
  },
  "proxy":{
    "listen_path":"/httpbin/",
    "target_url":"http://httpbin.org/",
    "strip_listen_path":true
  },
  "active":true,
  "souin": {
    "api": {
      "souin": {
        "enable": true
      }
    },
    "default_cache": {
      "ttl": "5s",
      "default_cache_control": "no-store"
    }
  }
}

Webgo middleware

To use Souin as webgo middleware, you can refer to the Webgo middleware integration folder to discover how to configure it.
You just have to define a new webgo router and tell to the instance to use the process method like below:

import (
	"net/http"

	"github.com/bnkamalesh/webgo/v6"
	cache "github.com/darkweak/souin/plugins/webgo"
)

func main(){

    // ...
	httpcache := cache.NewHTTPCache(cache.DevDefaultConfiguration)
	router.Use(httpcache.Middleware)
    // ...

}

Prestashop plugin

A repository called prestashop-souin has been started by lucmichalski. You can manage your Souin instance through the admin panel UI.

Wordpress plugin

A repository called wordpress-souin to be able to manage your Souin instance through the admin panel UI.

Credits

Thanks to these users for contributing or helping this project in any way

Name		Name	Last commit message	Last commit date
Latest commit History 92 Commits
.github/workflows		.github/workflows
api		api
cache		cache
configuration		configuration
configurationtypes		configurationtypes
context		context
default		default
docs		docs
errors		errors
gatling		gatling
helpers		helpers
olric		olric
plugins		plugins
rfc		rfc
tests		tests
.gitignore		.gitignore
.goreleaser.yml		.goreleaser.yml
.traefik.yml		.traefik.yml
Dockerfile-dev		Dockerfile-dev
Dockerfile-prod		Dockerfile-prod
Makefile		Makefile
README.md		README.md
docker-compose.yml.dev		docker-compose.yml.dev
docker-compose.yml.prod		docker-compose.yml.prod
docker-compose.yml.test		docker-compose.yml.test
go.mod		go.mod
go.sum		go.sum
main.go		main.go

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Souin Table of Contents

Souin HTTP cache

Project description

Disclaimer

Configuration

Required configuration

Souin as plugin

Souin out-of-the-box

Optional configuration

APIs

Prometheus API

Souin API

Security API

Diagrams

Sequence diagram

Cache systems

GraphQL

Cache invalidation

Examples

Træfik container

Plugins

Caddy module

Chi middleware

Echo middleware

Gin middleware

Skipper filter

Træfik plugin

Tyk plugin

Webgo middleware

Prestashop plugin

Wordpress plugin

Credits

About

Releases

Packages

Languages

juraganfilmmovie/souin

Folders and files

Latest commit

History

Repository files navigation

Souin Table of Contents

Souin HTTP cache

Project description

Disclaimer

Configuration

Required configuration

Souin as plugin

Souin out-of-the-box

Optional configuration

APIs

Prometheus API

Souin API

Security API

Diagrams

Sequence diagram

Cache systems

GraphQL

Cache invalidation

Examples

Træfik container

Plugins

Caddy module

Chi middleware

Echo middleware

Gin middleware

Skipper filter

Træfik plugin

Tyk plugin

Webgo middleware

Prestashop plugin

Wordpress plugin

Credits

About

Resources

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages