Transparent Cacheing Web Proxy
This Dockerfile builds an Alpine Linux container using Squid configured to work in transparent mode as a small and fast caching web proxy.
If you build a lot of containers, you might be spending a lot of time waiting for packages to download. Using Squid to cache downloads automatically saves time and bandwidth and it is totally transparent to you.
This docker image is available as a trusted build on the docker index, so there's no setup required. Using this image for the first time will start a download. Further runs will be immediate, as the image will be cached locally.
The recommended way to run this container looks like this:
docker run -d --name squid --net host --privileged riddopic/squid
Next on your docker host you will need to setup an IPtables rule to transparently route all HTTP requests through the proxy running in the container:
iptables -t nat -A PREROUTING -p tcp --dport 80 -j REDIRECT --to 3129 iptables -t nat -D PREROUTING -p tcp --dport 80 -j REDIRECT --to 3129
Inspecting the container
If you would like to have a look around or check the logs you can connect to the container using docker exec:
docker exec -it squid /bin/ash
The container can be tuned using environment variables.
<td>Squid has a maximum object cache size. Often when caching system packages vs standard web content it is valuable to increase this size. Use the <tt>-e MAX_CACHE_OBJECT=1024</tt> to set the max object size (in MB).</td>
<td>The squid disk cache size can be tuned. use <tt>-e DISK_CACHE_SIZE=5000</tt> to set the disk cache size (in MB).</td>
<td>The contents of <tt>squid.conf</tt> will only be what's defined in <tt>SQUID_DIRECTIVES</tt> giving the user full control of squid.</td>
<td>This will append any contents of the environment variable to <tt>squid.conf</tt>. It is expected that you will use multi-line block quote for the contents.</td>
When the container is terminated the cache is lost. To prevent this and maintain a persistent cache you can use a mounted volume. The cache location is
/var/cache/squid so if you mount that as a volume you can get persistent caching. Use
-v /home/user/squid_cache:/var/cache/squid in your command line to enable persistent caching.
Author:: Stefano Harding <email@example.com> Copyright: 2014-2015, Stefano Harding Licensed 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.