.. Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements. See the NOTICE file distributed with this work for additional information regarding copyright ownership. The ASF licenses this file to you under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License. .. include:: ../../common.defs .. _admin-plugins: Plugins ******* .. toctree:: :maxdepth: 2 Overview ======== One of the key features of |ATS| is its modularity. Features that aren't needed in the core simply aren't there. This helps to provide an additional guarantee that our core can remain fast by concentrating on the things that we always provide: caching and proxying. All other functionality can be moved into plugins and by offering a consistent C API, everyone can implement their own functionality, without having to touch the core. Stable plugins ============== Plugins that are considered stable are installed by default in |TS| releases. .. toctree:: :hidden: AWS S3 Authentication AuthProxy Background Fetch Cache Key Manipulation Cache Promotion Policies Cache Range Requests Combo Handler Configuration Remap Cookie Remap ESI Escalate Compress Generator Header Rewrite Health Checks Lua Regex Remap Regex Revalidate Remap Purge Stats over HTTP TCPInfo XDebug :doc:`AuthProxy ` Delegates the authorization decision of a request to an external HTTP service. :doc:`AWS S3 Authentication ` Support for Amazon S3 authentication features. :doc:`Background Fetch ` Proactively fetch content from Origin in a way that it will fill the object into cache. :doc:`Cache Key and Parent Selection URL Manipulation ` Allows some common cache key or parent selection URL manipulations based on various HTTP request elements. :doc:`Cache Promotion Policies ` Allows for control over which assets should be written to cache, or not. :doc:`Cache Range Requests ` Cache ranges by adding the range request header to the cache key. :doc:`Combo Handler ` Provides an intelligent way to combine multiple URLs into a single URL, and have Apache Traffic Server combine the components into one response. :doc:`Configuration Remap ` Override configuration directives on a per-rule basis. :doc:`ESI ` Implements the Edge Side Includes (ESI) specification. :doc:`Escalate ` Escalate: when the origin returns specific status codes, retry the request at a secondary origin (failover/fail-action) :doc:`Generator ` Generate arbitrary response data. :doc:`Compress ` Compress or deflate cache responses. .. sidebar: Formerly "gzip". :doc:`Header Rewrite ` Modify requests and responses based on incoming and outgoing headers and other transaction attributes. :doc:`Health Checks ` Define service health check links. :doc:`Lua ` Allows plugins to be written in Lua instead of C code. :doc:`Regex Remap ` Configure remapping rules using regular expressions. :doc:`Regex Revalidate ` Configurable rules for forcing cache object revalidations using regular expressions. :doc:`Stats over HTTP ` Provide an HTTP interface to all |TS| statistics. :doc:`TCPInfo ` Log TCP metrics at various points of the HTTP processing pipeline. :doc:`XDebug ` Allows HTTP clients to debug the operation of the Traffic Server cache using the X-Debug header. Experimental plugins ==================== Plugins that are considered experimental are located in the `plugins/experimental `_ directory of the |TS| source tree. Experimental plugins can be compiled by passing the `--enable-experimental-plugins` option to `configure`:: $ autoconf -i $ ./configure --enable-experimental-plugins $ make .. toctree:: :hidden: Access Control Cache Fill Certifier Cert Reporting Tool Collapsed-Forwarding GeoIP ACL FQ Pacing Header Frequency Hook Trace ICAP JA3 Fingerprint Maxmind ACL Memcache Memory Profile Metalink Money Trace MP4 Multiplexer MySQL Remap Rate Limit Signed URLs Slice SSL Headers SSL Session Reuse System Statistics Traffic Dump WebP Transform Prefetch :doc:`Access Control ` Access control plugin that handles various access control use-cases. :doc:`Certifier ` Manages and/or generates certificates for incoming HTTPS requests. :doc:`Cert Reporting Tool ` Examines and logs information on loaded certificates. :doc:`Collapsed-Forwarding ` Allows to Collapse multiple Concurrent requests by downloading once from the Origin and serving all clients in parallel. :doc:`FQ Pacing ` FQ Pacing: Rate Limit TCP connections using Linux's Fair Queuing queue discipline :doc:`GeoIP ACL ` Deny or allow requests based on the source IP geo-location. :doc:`Header Frequency ` Count the frequency of headers. :doc:`ICAP ` Pass response data to external server for further processing using the ICAP protocol. :doc:`JA3 Fingerprint ` Calculates JA3 Fingerprints for incoming SSL traffic. :doc:`MaxMind ACL ` ACL based on the maxmind geo databases (GeoIP2 mmdb and libmaxminddb) :doc:`Memcache ` Implements the memcache protocol for cache contents. :doc:`Metalink ` Implements the Metalink download description format in order to try not to download the same file twice. :doc:`Money Trace ` Allows Trafficserver to participate in a distributed tracing system based upon the Comcast Money library. :doc:`MP4 ` MP4 streaming media. :doc:`Multiplexer ` Multiplex inbound requests to multiple upstream destinations. This is useful for requests that are beacons or other metric gathering requests, to report to multiple upstreams. Alternatively this can be used to do A/B testing by sending a duplicated slice of inbound production traffic to experimental upstreams. :doc:`MySQL Remap ` Allows dynamic remaps from a MySQL database. :doc:`Prefetch ` Pre-fetch objects based on the requested URL path pattern. :doc:`Rate Limit ` Simple transaction rate limiting. :doc:`Remap Purge ` This remap plugin allows the administrator to easily setup remotely controlled ``PURGE`` for the content of an entire remap rule. :doc:`Signed URLs ` Adds support for verifying URL signatures for incoming requests to either deny or redirect access. :doc:`Slice ` Slice full file or range based requests into deterministic chunks, allowing large files to be spread across multiple cache stripes. Allows arbitrary range requests to be satisfied by stitching these chunks together. :doc:`SSL Session Reuse ` Coordinates Session ID and ticket based TLS session resumption between a group of ATS machines. :doc:`SSL Headers ` Populate request headers with SSL session information. :doc:`System Stats ` Inserts system statistics in to the stats list :doc:`Traffic Dump ` Dumps traffic data into a JSON format file which can be used to replay traffic. :doc:`WebP Transform ` Converts jpeg and png images to webp format.