How To: Configure Squid Proxy Server


To configure squid for simple proxying without caching anything.

Use Cases

  1. When you want to have control on what people browse on your lan.
  2. When number of machine is more than the number of IP addresses you can afford to buy.
  3. When you want to help this holy world in saving some IPV4 addresses 😛


  1. You have a machine connected directly to internet that you are going to use as a proxy server for other machines on your network.
  2. The machines on your network are using as private address space. You can use anyone/multiple address spaces of the available but for this howto we assume as the local network.
  3. The local IP address of the machine which will run squid proxy server is You can have any IP, but for this howto we assume this.

How to proceed

First of all ensure that you have squid installed. After installing squid, you need to set access control in squid configuration file which resides in /etc/squid by default. Open /etc/squid/squid.conf and add/edit following lines according to your preferences. Few lines already exist in the configuration file, you can add the rest.

# The port on which squid will listen for requests
http_port 8080
# If 'cgi-bin' or '?' is in query, squid should not check with neighbours'/parents' cache
# and should go to target web-server.
hierarchy_stoplist cgi-bin ?
# If url contains 'cgi-bin' or '?', then it must not be cached
acl QUERY urlpath_regex cgi-bin \?
cache deny QUERY
acl apache rep_header Server ^Apache
broken_vary_encoding allow apache
# Absolute path to squid access log.
access_log /var/log/squid/access.log squid
refresh_pattern ^ftp:           1440    20%     10080
refresh_pattern ^gopher:        1440    0%      1440
refresh_pattern .               0       20%     4320
# Access control list to control every IP address
acl all src
# Access control list for source machine in LAN
acl lan_src src
# Access control list for destination machine in LAN
acl lan_dst dst
# Access control list to manage squid cache
acl manager proto cache_object
# Access control list to define IP address allowed for source localhost
acl localhost src
# Access control list to define IP addresses allowed for localhost as destination
acl to_localhost dst
# Access control list to define Safe ports that should be allowed by default
acl SSL_ports port 443 563 1863 5190 5222 5050 6667
acl Safe_ports port 80          # http
acl Safe_ports port 21          # ftp
acl Safe_ports port 443         # https
acl Safe_ports port 70          # gopher
acl Safe_ports port 210         # wais
acl Safe_ports port 1025-65535  # unregistered ports
acl Safe_ports port 280         # http-mgmt
acl Safe_ports port 488         # gss-http
acl Safe_ports port 591         # filemaker
acl Safe_ports port 777         # multiling http
# Allow cache management only from localhost
http_access allow manager localhost
# Deny cache management from remote hosts
http_access deny manager
# Deny http access via all the ports which are not listed as safe
http_access deny !Safe_ports
# Deny all connections via all ports which are not listed as safe
http_access deny CONNECT !SSL_ports
# Allow http access from localhost
http_access allow localhost
# Allow http access from machines on LAN
http_access allow lan_src
http_access deny all
http_reply_access allow all
icp_access allow all
# Deny caching for everyone so that there is not caching at all
cache deny all
coredump_dir /var/spool/squid
# Never allow direct connection to machines on the internet
prefer_direct off
never_direct allow all
# Allow direct connetion if the destination machine is on LAN
always_direct allow lan_dst
# Delete this line if you don't have /etc/hosts file
hosts_file /etc/hosts
# Allow AIM connections
# Delete the following 9 lines if you don't want people to connect to AIM
acl AIM_ports port 5190 9898 6667
acl AIM_domains dstdomain
acl AIM_domains dstdomain
acl AIM_hosts dstdomain
acl AIM_nets dst
acl AIM_methods method CONNECT
http_access allow AIM_methods AIM_ports AIM_nets
http_access allow AIM_methods AIM_ports AIM_hosts
http_access allow AIM_methods AIM_ports AIM_domains
# Allow connections to Yahoo Messenger
# Delete the following 6 lines if you don't want people to connect to Yahoo Messenger
acl YIM_ports port 5050
acl YIM_domains dstdomain
acl YIM_hosts dstdomain
acl YIM_methods method CONNECT
http_access allow YIM_methods YIM_ports YIM_hosts
http_access allow YIM_methods YIM_ports YIM_domains
# Allow connections to Google Talk
# Delete the following 6 lines if you don't want people to connect to Google Talk
acl GTALK_ports port 5222 5050
acl GTALK_domains dstdomain
acl GTALK_hosts dstdomain
acl GTALK_methods method CONNECT
http_access allow GTALK_methods GTALK_ports GTALK_hosts
http_access allow GTALK_methods GTALK_ports GTALK_domains
# Allow connections to MSN
# Delete the following 6 lines if you don't want people to connect to Google Talk
acl MSN_ports port 1863 443 1503
acl MSN_domains dstdomain
acl MSN_hosts dstdomain
acl MSN_nets dst
acl MSN_methods method CONNECT
http_access allow MSN_methods MSN_ports MSN_hosts

Now, start the squid proxy server as

service squid start

Also, if you want squid to be started every time you boot the machine, execute the following command

chkconfig --level 345 squid on

You have a squid proxy server running now. You can ask clients to configure there browsers to use as a proxy server with 8080 as proxy port. Command line utilities like elinks, lynx, yum, wget etc. can be asked to use proxy by exporting http_proxy variable as below. Users can also add these lines to ~/.bashrc file to avoid exporting every-time.

export http_proxy=''
export ftp_proxy=''

I highly recommend the book “Squid Proxy Server 3.1: Beginner’s Guide (Paperback)” for further reading.


85 thoughts on “How To: Configure Squid Proxy Server

  1. Hi ,
    i have configured squid proxy server with two NIC in fedora 12.
    Network configuration scenario:
    Router-> proxy server-> switch -> clients(LAN)
    Router =

    Porxy server:



    proxy ip address=
    port number= 8080

    # Firewall configuration written by system-config-firewall
    # Manual customization of this file is not recommended.
    :INPUT ACCEPT [0:0]
    :OUTPUT ACCEPT [0:0]
    :RH-Firewall-1-INPUT – [0:0]
    -A INPUT -j RH-Firewall-1-INPUT
    -A FORWARD -j RH-Firewall-1-INPUT
    -A INPUT -p icmp -j ACCEPT
    -A INPUT -i lo -j ACCEPT
    -A INPUT -m state –state NEW -m tcp -p tcp –dport 22 -j ACCEPT
    -A INPUT -j REJECT –reject-with icmp-host-prohibited
    -A FORWARD -j REJECT –reject-with icmp-host-prohibited
    -A RH-Firewall-1-INPUT -m state –state NEW,ESTABLISHED,RELATED -m tcp -p tcp –dport 8080 -j ACCEPT

    my problem is that i cannot open websites from Client. Did I miss something or wrong config? any idea?

  2. How can I use a Proxy server to connect other people world wide with my internet connection on my ubuntu lucid 10.04 server.

  3. hello,

    My requirment is to use squid proxy for wireless sensor nodes, here squid should collect data from wireless sensor nodes and store it in cache and provide it to external internet world when requested, how do i do it???
    I want to setup this configuration on blackfin BF537 STAMP BOARD… HOW TO DO THIS ANY HELP WILL BE GREATLY APPRICIATED


  4. how do i access messenger service (e.g msn and yahoo messenger) using squid server. i have running squid on my server, but the messengers cannot run on my clints.

  5. i want to know about squid proxy installation in fedora 12 , also squid is working in 02 lan cards ? well may be it is 01 external for internet and 02 for internal network , through which i give my clients internet but what is the configuration and installation ? can anyone send me pleaseeeeeeeeeee ?

  6. Dear all,

    solution required for (104) connection reset by peer .
    kindly note we are using squid 2.5 stable1


  7. Hello,
    I have configured in my network fedora 10 with squid proxy. I have configured url as well as content filtering in my squid. I have created two users one is sysadmin and another user student. In the client host if you open the browser it will ask the user name and password to login and surf the net. If you login into the student user you are not able to access the url filtering as well as content filtering access controls but in the same host you will login as sysadmin you can get all the access.
    I am going to configure as a time based internet access for the student user.
    How to configure this if any one has already configured this please give your configuration for the above said.


  8. dear ,
    i have restricted some websites as company policy but my owner and general manager wants to access those blocked websites , how can it possible ? please i am in very bad condition at the moments.

    m.usman khalid

  9. well if anyone know about my users access (limited) and high management(full) access and also if i block any website then the blocked website open on my high management pc kindly please if anyone have solution then give me or e-mail me i am waiting for your replies friends


  10. dear sir how to configuration VNC Server in linux and windos pc to linux pc how to desktop maneges….

    reply me its urgent.

  11. Dear sir,

    I want to know about installation of audio streaming server in linux fedora or Debian. If any one knows please tell me step by step in details. & how do you configure Audio streaming server…
    Reply me its urgent………

  12. i have configured squid on server 2003 and squid is running well. but clients pc can browse internet with out configuring proxy server on i want to stop acess internet on users pc. how to do this ?????

  13. Thanks for ones marvelous posting! I seriously enjoyed reading it, you might be a great author.I will remember to bookmark your blog and will often come back later on. I want to encourage you continue your great job, have a nice evening!
    I absolutely love your blog and find a lot of your post’s to be precisely what I’m looking for. Does one offer guest writers to write content to suit your needs? I wouldn’t mind producing a post or elaborating on a lot of the subjects you write in relation to here. Again, awesome site!

  14. liked ur post..btw!
    I am using RHEL 6, squid 3:
    my isp is :8080 , proxy settings are required to connect to internet
    my internal network is
    clients are unable to connect to internet through squid
    i have tried using http_port 8080 and 3128
    and tried looking out at forums but no luck
    any solution or advice will be appreciated.!

  15. pls, i have install proxy but is not access to network, sent me step by step proxy-fedora, linux 6.0 ver

  16. Hello

    We are using redhat linux proxy server in my office .we have configured the Airtel Internet public ip in internal either net port and private ip configured in external lan .but public ips only is ping in server system and private ips not ping server system.
    if any body knows to resolve the problem .kindly help us .

  17. I have successful installed squid on fedora linux (SQUID 2.6 STABLE12) and working fine on the server itself using the proxy. However, my clients running windows ( win 7 and win xp) can’t browse using the proxy. The server is on the same network as the clients and they could even ping one another.

    In fact, the clients show ‘the connection has timed out’ instead of ‘Access denied’ which clearly shows it does not see the server at all.

    Initially I thought this has to do with the expoler but even mozilla can’t connect to the proxy on the clients machine.

    I would be glad if someone can help me on this

    Below are the few commented configuration on my squid: (these configs allows the server to browse): My network, Proxy server

    # The port on which squid will listen for requests
    http_port 3128

    acl our_networks src
    http_access allow our_networks

    http_access allow localhost

    http_rely_access allow all

    icp_access allow all

    visible_hostname infinityproxy

    1. I later realised the issue had to do with the firewall setting on the proxy server itself. The 8080 ports allowed on the squid and any other ports ( https, ftp, ssh, etc) also need to be enable on the firewall.

      The squid is working perfectly now and all the windows systems are connecting to the internet through the server.
      Thank you all.


Comments are closed.