Squid_ The Definitive Guide - Duane Wessels [196]
Default
No default
Example
visible_hostname my.host.name
Related
unique_hostname, hostname_aliases, announce_period
Name
unique_hostname
Synopsis
If you have a cluster of caches talking to each other and sharing a single visible_hostname value, you must use this directive to give each a unique name. Squid uses the unique name in HTTP Via headers to detect forwarding loops (see Section 10.2).
Syntax
unique_hostname hostname
Default
No default
Example
unique_hostname cache1.host.name
Related
visible_hostname, hostname_aliases
Name
hostname_aliases
Synopsis
You may find yourself in a situation where more than one hostname resolves to Squid's IP address. For example, both sv.us.ircache.net and sv.cache.nlanr.net resolve to 192.203.230.19. If you have neighbors, they may send requests for certain Squid-specific internal URLs, as in the case of Cache Digests. These URLs might contain either hostname. You must use this directive to tell Squid that it is known by names other than its visible_hostname.
Syntax
hostname_aliases hostname ...
Default
No default
Example
hostname_aliases this.host.name that.host.name
Related
visible_hostname, unique_hostname
Name
announce_period
Synopsis
Squid's announcement feature allows Squid administrators to find nearby caches that might be interested in joining a cache hierarchy. When you enable this directive, Squid periodically sends a small announcement message to a central server. By default, the announcement message contains five fields:
The IP address and hostname that sent the announcement
The Squid version
The hostname Squid uses internally—either your hostname if Squid can figure it out or the value of the visible_hostname directive
The value of the cache_mgr directive
The date and time of the announcement
Setting announce_period to 0 disables the announcement feature.
Syntax
announce_period time-specification
Default
announce_period 0
Example
announce_period 4 hours
Related
announce_host, announce_file, announce_port
Name
announce_host
Synopsis
This is the host setup to receive Squid's announcement messages. The default value, tracker.ircache.net is the only server I know about. You can search the tracker.ircache.net database by visiting http://www.ircache.net/Tracker/.
Note that if you set cache_mgr, your email address may be available to random people. On more than one occasion I have seen commercial caching vendors target Squid users by collecting their email addresses from this database.
Syntax
announce_host hostname
Default
announce_host tracker.ircache.net
Example
announce_host some.host.name
Related
announce_period, announce_file, announce_port
Name
announce_file
Synopsis
You can customize your cache announcement message by setting this directive to a file containing additional information. For example, you can include information about your upstream service provider, telephone number, other caches that you peer with, etc.
Announcement messages are sent via UDP, so this file shouldn't be too large. Some systems can't send or receive UDP messages larger than 9 KB. Furthermore, larger messages are more likely to be dropped before reaching their destination.
Syntax
announce_file pathname
Default
No default
Example
announce_file /usr/local/squid/etc/announce.txt
Related
announce_period, announce_host, announce_port
Name
announce_port
Synopsis
This is the UDP port number to which the announcement messages are sent.
Syntax
announce_port port-number
Default
announce_port 3131
Example
announce_port 1234
Related
announce_period, announce_host, announce_file
Name
httpd_accel_host
Synopsis
This directive enables HTTP server acceleration (see Chapter 15) and HTTP interception (see Chapter 9). When Squid is configured for server acceleration, this directive specifies the hostname or IP address of the backend server. When used in an interception configuration, you should probably use the keyword