Squid is a full-featured caching proxy supporting popular network protocols like HTTP, HTTPS, FTP, and more. It can be used to improve the web server's performance by caching repeated requests, filter web traffic, and access geo-restricted content.
The squid package is included in the standard Ubuntu 20.04 repositories. To install it, run the following commands as sudo user:
sudo apt update
sudo apt install squid
Once the installation is completed, the Squid service will start automatically. To verify it, check the service status:
sudo systemctl status squid
The squid service can be configured by editing the /etc/squid/squid.conf file. The configuration file contains comments that describe what each configuration option does. You can also put your configuration settings in separate files, which can be included in the main configuration file using the “include” directive.
Before making any changes, it is recommended to back up the original configuration file:
sudo cp /etc/squid/squid.conf{,.orginal}
To start configuring your squid instance, open the file in your text editor:
sudo vi /etc/squid/squid.conf
By default, squid is set to listen on port 3128 on all network interfaces on the server.
If you want to change the port and set a listening interface, locate the line starting with http_port and specify the interface IP address and the new port. If no interface is specified Squid will listen on all interfaces.
Running Squid on all interfaces and on the default port should be fine for most users.
Squid allows you to control how the clients can access the web resources using Access Control Lists (ACLs). By default, access is permitted only from the localhost.
If all clients who use the proxy have a static IP address, the simplest option to restrict access to the proxy server is to create an ACL that will include the allowed IPs. Otherwise, you can set squid to use authentication.
Instead of adding the IP addresses in the main configuration file, create a new dedicated file that will hold the allowed IPs:
#/etc/squid/allowed_ips
192.168.33.1
# All other allowed IPs
Once done, open the main configuration file and create a new ACL named allowed_ips and allow access to that ACL using the http_access directive:
#/etc/squid/squid.conf
# ...
acl allowed_ips src "/etc/squid/allowed_ips.txt"
# ...
http_access allow localhost
http_access allow allowed_ips
# And finally deny all other access to this proxy
http_access deny all
The order of the http_access rules is important. Make sure you add the line before http_access deny all.
The http_access directive works in a similar way as the firewall rules. Squid reads the rules from top to bottom, and when a rule matches, the rules below are not processed.
Whenever you make changes to the configuration file, you need to restart the Squid service for the changes to take effect:
sudo systemctl restart squid
If restricting access based on IP doesn't work for your use case, you can configure squid to use a back-end to authenticate users. Squid supports Samba, LDAP, and HTTP basic auth.
In this guide, we'll use basic auth. It is a simple authentication method built into the HTTP protocol.
To generate a crypted password, use the openssl tool. The following command appends the USERNAME:PASSWORD pair to the /etc/squid/htpasswd file:
printf "USERNAME:$(openssl passwd -crypt PASSWORD)\n" | sudo tee -a /etc/squid/htpasswd
For example, to create a user “josh” with password “P@ssvv0rT”, you would run:
printf "josh:$(openssl passwd -crypt 'P@ssvv0rd')\n" | sudo tee -a /etc/squid/htpasswd
>josh:QMxVjdyPchJl6
The next step is to enable the HTTP basic authentication and include the file containing the user credentials to the squid configuration file.
Open the main configuration and add the following:
#/etc/squid/squid.conf
# ...
auth_param basic program /usr/lib/squid3/basic_ncsa_auth /etc/squid/htpasswd
auth_param basic realm proxy
acl authenticated proxy_auth REQUIRED
# ...
#http_access allow localnet
http_access allow localhost
http_access allow authenticated
# And finally deny all other access to this proxy
http_access deny all
The first three lines are creating a new ACL named authenticated, and the last "http_access allow" line is allowing access to authenticated users.
Restart the Squid service:
sudo systemctl restart squid
To open the Squid ports, enable the UFW ‘Squid' profile:
sudo ufw allow 'Squid'
In the upper right-hand corner, click on the hamburger icon ☰ to open Firefox's menu: click on the ⚙ Preferences link.
Scroll down to the Network Settings section and click on the Settings... button.
A new window will open.
Select the Manual proxy configuration radio button.
Enter your Squid server IP address in the HTTP Host field and 3128 in the Port field.
Select the Use this proxy server for all protocols checkbox.
Click on the OK button to save the settings.
At this point, your Firefox is configured, and you can browse the Internet through the Squid proxy. To verify it, open google.com, type “what is my ip” and you should see your Squid server IP address.
To revert back to the default settings, go to Network Settings, select the Use system proxy settings radio button and save the settings.
There are several plugins that can also help you to configure Firefox's proxy settings, such as FoxyProxy.