mirror of
https://github.com/b4tman/docker-squid.git
synced 2026-03-12 07:23:46 +00:00
59 lines
2.1 KiB
Markdown
59 lines
2.1 KiB
Markdown
|
|
|
|
# docker-squid
|
|
|
|
Docker Squid container based on Alpine Linux.
|
|
|
|
Automated builds of the image are available on:
|
|
|
|
- DockerHub:
|
|
- [b4tman/squid](https://hub.docker.com/r/b4tman/squid)
|
|
- Github:
|
|
- [ghcr.io/b4tman/squid](https://github.com/users/b4tman/packages/container/package/squid)
|
|
- [ghcr.io/b4tman/squid-armhf](https://github.com/users/b4tman/packages/container/package/squid-armhf)
|
|
- [ghcr.io/b4tman/squid-ssl-bump](https://github.com/users/b4tman/packages/container/package/squid-ssl-bump)
|
|
|
|
# Quick Start
|
|
|
|
Just launch container:
|
|
|
|
```bash
|
|
docker run -p 3128:3128 b4tman/squid
|
|
```
|
|
|
|
or use [docker-compose](https://docs.docker.com/compose/):
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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`.
|