Squid 2.4 Stable1
Configuration Manual
 

   
Previous
Table of Contents
Next

NETWORK OPTIONS


Tag Name

http_port

Usage

http_port port
Hostname: port
1.2.3.4 : port
Description

This tag name is used to specify the socket addresses where Squid will listen for HTTP client requests. Multiple socket addresses can be specified. There are three forms: port alone, hostname with port, and IP address with port. If hostname or IP address are specified, then Squid binds the socket to that specific address. This replaces the old ‘tcp_incoming_address’ option. Most likely, no need to bind to a specific address, so canuse the port number alone. If you are running Squid in accelerator mode, then you probably want to listen on port 80 also, or instead.

Default

http_port 3128

Example

Give the port number in which you want squid to listen to http client requests. Like...
http_port 8080
We can override the default port number by –a command line option.
#/usr/local/squid/bin/squid –a 8080
This will start squid with port 8080, which overrides the port number in squid.conf.
However this option cannot be used to override IP address

Caution

Before changing the port number, make sure no application in your box is running in the same port

Note

http_port can be used to specify the tcp_incoming_address through whichthe cache listens to requests from other remote servers. http_port can belisted multiple times.


Tag Name

icp_port

Usage

icp_port port

Description

Thisspecifies the port number from which Squid sends and receives ICP queriesto and from neighbor caches. To disable “0” is used.
ICP is a protocol used for communication among squid caches. ICP is primarily used within a cache hierarchy to locate specific objects in sibling caches. If a squid cache does not have a requested document, it sends an ICP query to its siblings, and the siblings respond with ICP replies indicating a ``HIT'' or a ``MISS.'' The cache then uses the replies to choose from which cache to resolve its own MISS. ICP is currently implemented on top of UDP. Squid also supports ICP via multicast.

Default

icp_port 3130

Example

The port number is given in which squid has to send and receive ICP queries from neighbor caches. Like...
icp_port 5050
May be overridden by –u command line option.
#/usr/local/squid/bin/squid –u 5050 This will start squid with port 5050, which overrides the port number in squid.conf

Caution

Before changing this port number, make sure no application in the box is running in the same port


Tag Name

htcp_port

Usage

htcp_port port

Description

Used to specify the port number through which Squid sends and receives ICP queries to and from neighbor caches. To disable “0” is used

Default

htcp_port 4827

Example

htcp_port 5089

Caution

To enable this option, “--enable-htcp” is used with the configure script


Tag Name

mcast_groups

Usage

mcast_groups IPAddress

Description


This tag specifies a list of multicast groups, which your server should join to receive multicasted ICP queries.

Multicast is essentially the ability to send one IP packet to multiple receivers. Multicast is often used for audio and video conferencing systems. If you are unsure about multicast, please read the Multicast chapter in the Squid FAQ (http://squid.nlanr.net/Squid/FAQ/).

This option is to be set only if you want to RECEIVE multicast queries.

ICP replies are always sent via unicast, so this option does not affect whether or not you will receivereplies from multicast group members.

Be sure you understand the difference between an ICP _query_ andan ICP _reply_.

Use cache_peer Directive for sending ICP queries.


Default

none
By default, Squid doesn't listen on any multicast groups

Example

mcast_groups 239.128.16.128 224.0.1.20

Caution

Should not use a multicast address, which is already in use by another group of caches. We should not set this option to SEND multicast ICP


Tag Name

tcp_outgoing_address

Usage

tcp_outgoing_address IPAddress

Description

     
It is used for connections made to remote servers. It is also used to communicate with other caches while using HTCP or CARP. Normally tcp_outgoing_address should not be specified. It is better to let the OS select a suitable address. There are some very specific network configurations where tcp_outgoing_address needs to be specified

Default

tcp_outgoing_address 255.255.255.255

Note

The tcp_incoming_address can be specified using http_port

Example

-

Default

-


Tag Name

udp_incoming_address

Usage

udp_incoming_address IPAddress

Description

It is used for the ICP socket receiving packets from other caches.

Default

udp_incoming_address 0.0.0.0

Caution

-


Tag Name

udp_outgoing_address

Usage

udp_outgoing_address IPAddress

Description

It is used for the ICP packets sent out to the caches.

Default

udp_outgoing_address 255.255.255.255

Caution

-