docker-squid

Docker Squid container based on Alpine Linux.

Automated builds of the image are available on:

• DockerHub:
  • b4tman/squid
• Github:
  • ghcr.io/b4tman/squid
  • ghcr.io/b4tman/squid-armhf
  • ghcr.io/b4tman/squid-ssl-bump

Quick Start

Just launch container:

docker run -p 3128:3128 b4tman/squid

or use docker-compose:

wget https://raw.githubusercontent.com/b4tman/docker-squid/master/docker-compose.yml
docker-compose up

Configuration

By default, the image now includes a local network allow-list (/etc/squid/conf.d/localnet.conf) so clients from RFC1918/RFC4193 ranges can connect without mounting an extra ACL file.

The image also includes apache2-utils, so you can generate and manage htpasswd files directly in the container for basic authentication setups.

Environment variables:

• SQUID_CONFIG_FILE: Specify the configuration file for squid. Defaults to /etc/squid/squid.conf.
• TZ: Override the container timezone (for example, Europe/Berlin).

You can configure Squid in multiple ways:

• Replace the main configuration file by overriding SQUID_CONFIG_FILE.
• Add configuration snippets to /etc/squid/conf.d: all *.conf files from this directory are included at the beginning of the default configuration.
• Add configuration snippets to /etc/squid/conf.d.tail: all *.conf files from this directory are included at the end of the default configuration.

Example:

docker run -p 3128:3128 \
	--env='SQUID_CONFIG_FILE=/etc/squid/my-squid.conf' \
	--volume=/srv/docker/squid/squid.conf:/etc/squid/my-squid.conf:ro \
	b4tman/squid

This will start a squid container with your config file /srv/docker/squid/squid.conf.