Public | Automated Build

Last pushed: a year ago
Short Description
Apache Traffic Server, forward proxy with caching capabilties.
Full Description

Supported tags and respective Dockerfile links

What is Apache Traffic Server

The Apache Traffic Server (ATS) is a modular, high-performance reverse proxy and forward proxy server, generally comparable to Nginx and Squid.
It's used in production to serve more than 30 billion objects per day on sites like the Yahoo! homepage, and Yahoo! Sports, Mail and Finance.


An alternative is Squid which is simpler to configure but doesn't support ws://.

Usage example

$ docker run -d -p 8080:8080 wernight/trafficserver

You may run traffic_ctl command inside that container to configure it at runtime, or
mount /usr/local/etc/trafficserver/records.config
(there are also other configuration files).

See Traffic Server Manual for configuration optionas
(by default is should have default settings with some comments).

To diagnose issues, you'll find logs under /usr/local/var/log/trafficserver/.

Forward proxy

For example to set it up as a
forward proxy
create and mount records.config with:

CONFIG proxy.config.url_remap.remap_required INT 0
CONFIG proxy.config.reverse_proxy.enabled INT 0


To require authentication add to records.config:

CONFIG proxy.config.url_remap.remap_required INT 1
CONFIG proxy.config.http.doc_in_cache_skip_dns INT 0

... and to remap.config something like:

map \
    @pparam=--auth-transform=redirect @pparam=--auth-host= @pparam=--auth-port=9000


... and have a server listening on to handle authorization.
For example an Nginx with a configuration like:

server {
    listen 9000;
    server_name  _;
    location / {
        auth_basic 'ALC';
        # A file created with htpasswd.
        auth_basic_user_file /var/run/secrets/proxy-passwd/passwd;
        # Just return 200 for authenticated users.
        try_files /index.html =200;

Alternatively, you can compile a plugin like basic_auth.c available also on GitHub.

Client-side usage

Then use it for example like:

$ curl --proxy http://localhost:8080


Suggestions are welcome on our GitHub issue tracker.

Docker Pull Command
Source Repository