После того, как вы скачали, откомпилировали и установили Squid (см. файл INSTALL в корневой директории исходников), вам необходимо отредактировать файл squid.conf. Ниже приведен список параметров, которые вам *необходимо* изменить, т.к. по умолчанию им не присвоены какие-либо значения. Другие переменные пока не трогайте. Мы предполагаем, что вы установили Squid в /usr/local/squid, как указано по умолчанию.
Раскоментируйте и отредактируйте следующие строки в файле /usr/local/squid/etc/squid.conf:
Если у вас есть родительский кеш, укажите его здесь. Администраторы родительского кеша обычно дают вам необходимые инструкции. Но вы всегда должы спрашивать разрешения перед тем, как добавить родительский кеш.
Укажите здесь кол-во памяти (имеется ввиду ОЗУ) выделенной под кеширование. Предупреждение: реально Squid использует больше, чем указанное здесь значение. Золотое правило: если вы имеете N мегабайт свободной памяти, которую можете отдать под Squid, укажите здесь значение N/3.
cache_dir /usr/local/squid/var/cache 100 16 256
Укажите здесь (первое число, в данном случае - 100) кол-во дискового пространства, отведенного под кеш (в мегабайтах).
Списки контроля доступа. Это важно, т.к. предотвращает нелегальное использование ваших сетевых ресурсов кем-либо. Чтобы попасть в ACL для разрешенных хостов (allowed_hosts), используйте ваш адрес сети (к примеру 192.168.10.0) и маску вашей сети (к примеру 255.255.255.0):
acl manager proto cache_object acl localhost src 127.0.0.1/255.255.255.255 acl all src 0.0.0.0/0.0.0.0 acl allowed_hosts src 192.168.10.0/255.255.255.0
http_access deny manager all http_access allow allowed_hosts http_access deny all
icp_access allow allowed_hosts icp_access deny all
miss_access allow allowed_hosts miss_access deny all
Укажите здесь адрес e-mail человека, отвечающего за работу прокси:
Если вы должны запускать Squid из под root, найдите безопасного пользователя и группу от которых он будет запускаться после загрузки системы (обычно "nobody" и "nogroup"). Не используйте "root" по соображениям безопасности.
Имя хоста, представляющего кеш.
После редактирования под ваши нужды файла squid.conf, запустите Squid из командной строки ДВАЖДЫ, вот так:
Проверьте ваш cache.log (/usr/local/squid/var/logs/cache.log), чтобы убедиться, что все в порядке. Появление предупреждения "WARNING: Cannot write to swap directory" абсолютно нормально для первого запуска Squid.
Как только Squid создаст все необходимые файлы (на некоторых системах это может занять до нескольких минут), проверьте его работоспособность при помощи echoping или обычного Web-клиента. По умолчанию ваш Squid будет запущен на порту 3128. См. Squid FAQ для более подробной информации.
Как только вам удалось заставить работать Squid из командной строки, можете указать вашему Unix запускать Squid во время загрузки системы (в основном это зависит от того, какой Unix вы используете, в большинстве случаев вам потребуется внести изменения в файл типа /etc/rc_something).
Эта инструкция по быстрому запуску написана Stephane Bortzmeyer и Duane Wessels.
4. Squid – Администрирование (установка, настройка и использование)
4.1. Назначение
Представляет собой HTTP, FTP, gopher, SSL и WAIS (убрано в 2.6) proxy, кеширующий запросы. Также кеширует DNS. Один процесс на всех, неблокированный ввод/вывод, держит часто используемые объекты в виртуальной памяти. Бесплатен (GPL). Основан на проекте Harvest. Поддерживает иерархию или сеть серверов (ICP/UDP - Internet Cache Protocol, HTCP/TCP, multicast). Откуда брать объект определяется так (в упрощенном виде): послать ICP/HTCP/multicast запросы ко всем подходящим соседям; подождать определенное время; загрузить с первого соседа, пославшего HIT; иначе загрузить с первого отца, ответившего MISS; иначе загрузить с первоисточника. Предусмотрены различные методы оптимизации для выбора наиболее быстрого источника.
Делается различие между частными и общими объектами. Кешируются только общие объекты. Только метод GET дает общие объекты. Объекты, попавшие в стоп-лист есть частные объекты. Если запрос содержит аутентификационную информацию или ответ типа "401 Unauthorized" - это частный объект.
cache digest - очень компактная форма представления какие объекты имеются в кеше. Кеши могут обмениваться этой информацией с соседями, чтобы избежать необходимости делать ICP-запросы. В качестве ключей объектов используется MD5.
Текущая стабильная версия: Squid 2.6-STABLE12; готовится к выходу 3.0 (отличия 2.6.STABLE12 от 2.5.STABLE14, 2.5.STABLE14 от 2.5.STABLE6, 2.5.STABLE6 от 2.4, 2.4 от 2.3, 2.3 от 2.2).
4.2. Установка
Squid 2.6.STABLE12, Linux CentOS 4.4 (головной для филиала) Squid 2.5.STABLE6, Linux CentOS 4.0/4.4 (без излишеств) Squid 2.5-PRE6, Linux RedHat 7.2 (transparent, балансировка нагрузки, антибаннер) Squid 2.3-STABLE4, Linux RedHat 7.0 (два сервера: распасовщик и антибаннер) Squid 2.3-STABLE2, Linux RedHat 6.2 (transparent proxy) Squid 2.3-STABLE1, Linux RedHat 6.0 (распасовочный) Squid 2.2-STABLE4, Linux RedHat 6.0, из rpm Squid 2.2-STABLE2, Solaris 2.5, Sparc
--enable-storeio="список-методов-хранения" (ufs - unix file system; aufs - async unix file system; diskd - отдельные процессы для асинхронного доступа к файлам; null - не хранить данные на диске; coss - файловая система COSS)
--enable-icmp (измерять путь до каждого HTTP-сервера при запросах с помощью ICMP, используется для оптимизации выбора сервера или соседа)
--enable-htcp (HTCP - вариант ICP по TCP, синхронизация кеша с соседями)
--enable-forw-via-db (включить поддержку БД Forw/Via для оптимизации выбора сервера или соседа)
--enable-cache-digests (использовать Cache Digests для оптимизации выбора сервера или соседа)
--enable-carp (включить балансировку с помощью CARP - Cache Array Routing Protocol; в новых версиях его надо наоборот отключать: --disable-carp)
--disable-wccp (не включать поддержку протокола WCCP - Web Cache Coordination Protocol - позволяет Cisco IOS автоматически распознавать падение сервера)
--enable-gnuregex (вместо regex, плохо работающего в старых Linux)
--enable-poll (можно использовать poll, epoll или select; poll быстрее, но не на всех платформах работает; обычно выбор делается автоматически, но если вы умнее configure, то можете это проверить)
--disable-poll
--enable-select
--disable-select
--enable-select-simple (использовать только простое подмножество select)
--enable-epoll
--disable-epoll
--disable-http-violations (игнорировать все строки в конфигурации, которые нарушают стандарты HTTP)
--enable-ipf-transparent (разрешить поддержку transparent proxy для систем, использующих IP-Filter - в ядре Linux 2.2 и без этого хорошо)
--enable-pf-transparent (разрешить поддержку transparent proxy для систем, использующих PF network address redirection)
--enable-linux-netfilter (transparent proxy для ядра Linux 2.4)
--enable-large-cache-files (позволяет хранить в кеше файлы размером более 2GB; при этом меняется формат хранения; 2.6)
--disable-ident-lookups (ident в современном мире - вещь бесполезная)
--disable-internal-dns (вместо внутренних запросов использовать внешние процессы dnsserver; рекомендуется для версий до 2.4)
--enable-truncate (обнулять файлы вместо их удаления: быстрее, но требует много inode; были проблемы, когда переполнялась таблица inode; наверное, параметр minimum_object_size из-за этого появился; не рекомендуется для асинхронного ввода/вывода)
--disable-unlinkd (запретить использование внешних процессов для удаления файлов)
--enable-underscores (позволять подчеркивания в именах хостов, надеясь что резолвер их не обрежет; в 2.6 заменён директивой squid.conf)
--enable-heap-replacement (использовать улучшенные алгоритмы замещения кеша вместо стандартного LRU, в версиях Squid до 2.4; в новых версиях рекомендуется использовать --enable-removal-policies)
--enable-removal-policies="lru,heap" (улучшенные алгоритмы замещения кеша вместо стандартного LRU, в версиях Squid 2.4 и выше)
--enable-dlmalloc (своя библиотека malloc, не быстрая но без memore leak)
--enable-ssl (включить поддержку работы в качестве шлюза SSL с помощью OpenSSL)
--enable-auth="список методов аутентификации" (по умолчанию только basic; вместе со squid поставляются: basic, digest, ntlm, negotiate; имеется множество дополнительных ключей, позволяющих настраивать отдельные методы аутентификации:
--enable-basic-auth-helpers="список программ для аутентификации basic" (в комплекте имеются: getpwnam, LDAP, MSNT (обращается к NT серверу), mswin_sspi (только под MS Windows NT?), multi-domain-NTLM, NCSA, PAM, SASL, SMB, YP)
--enable-ntlm-auth-helpers="список программ для аутентификации ntlm" (в комплекте имеются: fakeauth (проверяет только синтаксис запроса), mswin_sspi (только под MS Windows NT?), no_check (проверяет только синтаксис запроса), SMB (обращается к контроллеру домена)
--enable-digest-auth-helpers="список программ для аутентификации digest" (в комплекте имеются: password, ldap)
--enable-negotiate-auth-helpers="список программ для аутентификации negotiate" (в комплекте имеются: mswin_sspi (только под MS Windows NT?))
--enable-external-acl-helpers="список программ для проверки ACL" (в комплекте имеются: ip_user, ldap_group, mswin_lm_group, session, unix_group, wbinfo_group)
debug (начать/закончить полную трассировку; сигнал USR2)
check (сигнал ZERO)
parse (проверить синтаксис squid.conf)
-l facility (источник для записей в syslog)
-s (level 0 debugging to syslog в дополнение к выводу в файл)
-u порт (UDP порт для входных ICP запросов, 3130)
-v (напечатать версию параметры сборки)
-z (создать дисковый кеш при первом запуске)
-C (не отлавливать сигналы к завершению)
-D (не делать DNS-тест при запуске)
-F (восстановление после сбоя не в фоновом режиме)
-N (не становиться фоновым процессом)
-R (не устанавливать REUSEADDR на порту)
-V (поддержка виртуальных хостов для режима акселерации - аналогично "httpd_accel_host virtual" в конфигурационном файле)
-X (включить отладку при разборе конфигурационного файла)
-Y (более быстрое восстановление после сбоев)
4.5. Формат squid.conf
сетевые параметры сервера
http_port 3128 (порт для запросов клиентов); в версии 2.3 можно указывать перед портом имя хоста или IP-адрес
https_port порт (обработка SSL/TLS запросов в режиме акселерации; в качестве опций указывается файл с сертификатом, приватный ключ, версия SSL/TLS, тип шифрования)
ssl_unclean_shutdown off
icp_port 3130 (если соседей не ожидается, то поставить "icp_port 0")
htcp_port 4827 (порт для общения с соседями - ICP - через TCP, нужен "--enable-htcp" в configure, иначе его нельзя устанавливать даже в 0)
mcast_groups 239.128.16.128 224.0.1.20 (к каким multicast группам подсоединяться для получения ICP, если используется multicast; для раздачи используется cache_peer; не трогать)
tcp_incoming_address 0.0.0.0 (по какому адресу принимать входные пакеты, если хост имеет несколько интерфейсов; в 2.3 убран)
tcp_outgoing_address 0.0.0.0 [[!]acl] (при посылке ставить указанный адрес в качестве исходного; в 2.5 появилась возможность задавать ACL)
udp_incoming_address 0.0.0.0 (по какому адресу принимать пакеты ICP)
udp_outgoing_address 255.255.255.255 (с какого адреса должны выходить пакеты ICP; по умолчанию - с того же, что и приходят)
tcp_outgoing_tos TOS-биты [!]acl (установка битов приоритета траффика в зависимости от ACL)
tcp_recv_bufsize 0 bytes (0 означает, что надо использовать размер буфера по умолчанию)
incoming_icp_average 6
incoming_http_average 4
incoming_dns_average 4
min_icp_poll_cnt 8
min_http_poll_cnt 8
min_dns_poll_cnt 8
соседи (neighbour, peer)
cache_peer hostname type proxy-port icp-port options (каждый сосед описывается отдельной строкой)
type
parent - старший в иерархии (если запрос отсутствует в локальном кеше, то он направляется к parent, тот - при отсутствии в своем кеше - пересылает запрос дальше и возвращает готовый ответ подчиненному в иерархии; если squid получает от parent TCP_DENIED, то он лезет напрямую)
sibling - одного уровня (если запрос отсутствует в локальном кеше, то он направляется к sibling, тот - при отсутствии в своем кеше - сразу возвращает сообщение об этом, ничего не предпринимая)
multicast
options
proxy-only (объекты, взятые с этого узла не хранить у себя)
weight=число (число от 1, по умолчанию - 1, чем больше, тем больше приоритет при прочих равных)
ttl=число (TTL в посылаемых ICP пакетах при использовании multicast)
no-query (не посылать ICP запросы - только принимать)
default (самый старший в иерархии, используемый как last-resort)
round-robin (определяет множество старших кешей, используемых по очереди)
multicast-responder (данный сосед является членом multicast группы, запрос к нему посылается через multicast, но запросы от него будут обрабатываться и так)
closest-only (при ответах ICP_OP_MISS не передавать FIRST_PARENT_MISS)
no-digest (не запрашивать от этого соседа cash-digest)
no-netdb-exchange (не запрашивать у этого соседа ICMP RTT - round trip time - NetDB)
no-delay (при перегрузке delay pool не лезть к этому соседу)
login=user:password (если старший в иерархии proxy требует аутентификации)
allow-miss (передавать соседям запросы не только в режиме only-if-cached; может порождать циклы)
max-conn=число (максимальное число соединений с данным соседом)
cache_peer_domain host domain [domain...] ограничить запросы к данному соседу данным списком доменов (можно использовать отрицание с помощью восклицательного знака)
neighbor_type_domain parent | sibling domain... модифицировать тип соседа при запросах к данному домену
icp_query_timeout milisec (по умолчанию определяется автоматически для каждого соседа)
maximum_icp_query_timeout milisec
mcast_icp_query_timeout milisec (по умолчанию 2000 ms, ожидание ответа на регулярные multicast опросы)
dead_peer_timeout 10 seconds (как долго ждать прежде, чем объявить соседа "мертвым")
hierarchy_stoplist (список строк - через пробел, - при встрече которых в URL, запрос будет направлен сразу напрямую, а не "по соседям"; по-умолчанию - "cgi-bin ?")
minimum_direct_hops 4 (If using the ICMP pinging stuff, do direct fetches for sites which are no more than this many hops away)
minimum_direct_rtt400 (при использовании ICMP ping для вычисления близости серверов, использовать только тех соседей, которые отзываются быстрее указанного числа милисекунд)
icp_hit_stale on|off (возвращать ли ответ ICP_HIT для зачерствевших объектов; по умолчанию - off)
netdb_low 900
netdb_high 1000 (нижняя верхняя границы для базы данных измерения ICMP)
netdb_ping_period 5 minutes (минимальное время между ping-ами в одну и ту же сеть)
query_icmp on|off (должны ли соседи включать в ICP ответы ICMP данные; соответствующие данные собираются если сосед сконфигурирован с --enable-icmp, в это случае он измеряет путь до http-сервера помощью ICMP, выключен по умолчанию)
test_reachability on|off (если включить, то ответ ICP_MISS будет заменяться на ICP_MISS_NOFETCH если сервер отсутствует в ICMP базе данных или RTT равен нулю)
retry_on_error off (повторять запрос к соседу после получения сообщения об ошибке)
mcast_miss_addr адрес (по этому multicast адресу посылается сообщение при каждом cache miss)
mcast_miss_port порт
mcast_miss_encode_key ключ
nonhierarchical_direct on (запросы из hierarchy_stoplist и некешируемых типов будут направляться к первоисточнику, off - к родительскому кешу)
prefer_direct on (если никакая методика - ICP, HTCP, digest - не указали родительский кеш, то напрвлять запрос к первоисточнику; off - к родительскому кешу)
размер кеша и параметры кеширования, параметры запросов
cache_mem 8 MB (объем оперативной памяти, используемой для хранения обрабатываемых объектов; если требуется, то этот лимит может быть слегка превышен; если осталось свободное место, то оно используется для хранения наиболее часто используемых объектов отрицательных ответов; память используется и под другие нужды - индекс объектов - на каждый объект требуется около 100 байт ОП; если средний размер объекта 9КБ (в очень старом руководстве говорится - 20КБ, в более новом - 13КБ, у меня - 9КБ, как измельчал интернет!), то на 8ГБ диска понадобится 100МБ ОП только под индекс объектов; еще понадобится память под кеш IP-адресов, fqdn-кеш и др.)
cache_dir тип имя-директории Mbytes Level-1 Level2[read-only] [max-size=число] (определяет имя, размер и количество поддиректорий на первом и втором уровне кеша на диске - каждый кешируемый объект кладется в отдельный файл, файлы не сваливаются в одно место, а разносятся в двухуровневой иерархии директорий; можно иметь несколько директорий под кеш - особенно полезно иметь их на разных дисках; эксперимент показал, что при кэше в 700 МБ используется только 2 директории первого уровня; при стандартной структуре директорий кеша в него "с комфортом" влезает миллион объектов (9 GB), если их больше, то надо увеличить число директорий верхнего уровня; тип кеша указывается начиная с версии 2.3: ufs (unix file system), aufs (async ufs), diskd (внешние процессы для избежания блокировки squid на дисковом вводе/выводе); директорию верхнего уровня надо создавать самому; поддиректории создаются командой squid -z)
cache_swap_log полное-имя-файла (это не журнал, а оглавление кеша на диске)
cache_swap_high 95 (при достижении данного уровня заполнения кеша - в процентах - начинается ускоренный процесс удаления старых объектов; для большого кеша эти границы надо поднять, 5% от 8 GB - это 400 MB!)
cache_swap_low 90 (процесс удаления старых объектов заканчивается, если достигнут данный уровень)
maximum_object_size 4096 KB (максимальный размер кешируемого объекта; если его увеличишь, то съэкономишь трафик, если уменьшишь, то странички быстрее грузиться будут - хотя можно просто увеличить размер кеша; максимальный размер объекта, который удалось за раз скачать по модему - 8 MB)
minimum_object_size 0 KB (файлы меньшего размера не сохраняются; введено в 2.3-STABLE3
maximum_object_size_in_memory 8 KB
ipcache_size 1024 (размер кеша для IP адресов)
ipcache_high 95 и ipcache_low 90 (верхний и нижний уровень заполнения IP кеша для алгоритма удаления старых объектов по LRU)
cache_replacement_policy policy (алгоритмы замещения объектов в кеше: lru, heap GDSF, heap LFUDA или heap LRU; действует на последующие cache_dir)
memory_replacement_policy policy
memory_pools on|off (по умолчанию, однажды захваченная, но ныне не используемая память не отдается обратно в систему, off позволяет освобождать ее)
memory_pools_limit байт (максимальное количество неиспользуемой памяти, которое squid будет придерживать; если 0, то придерживать все, что было захвачено; см. memory_pools)
request_size 100 KB (максимально возможный размер запроса; если клиент загружает файлы с помощью метода POST, то необходимо увеличить допустимый размер) - убран в версии 2.3
request_header_max_size 10KB (появился в 2.3)
request_body_max_size 1 MB (появился в 2.3; в новых версиях по умолчанию - без ограничений)
reply_header_max_size 20 KB (появился в 2.5)
reply_body_max_size 0 allow | deny all (появился в 2.3; в версии 2.4 появилась возможность задать ACL)
refresh_pattern [-i] regex MIN_AGE percent MAX_AGE[options] используется, чтоб определить не устарел ли объект в кеше. Имя объекта сравнивается по очереди с регулярными выражениями в строках refresh_pattern до первого совпадения, параметры из соответствующей строк используются в алгоритме проверки "на свежесть". По умолчанию, регулярные выражения различают прописные/строчные буквы, чтобы игнорировать это различие, используется ключ "-i". MIN_AGE и MAX_AGE- время в минутах (MAX_AGE также используется, если приходится делать запрос к соседям (Cache-Control: Max-age=nnn) ). procent - целое число. OBJ_DATE - время извлечения объекта с исходного сервера (заголовок HTTP Date). OBJ_LASTMOD - время последнего изменения объекта (заголовок HTTP Last-Modified). OBJ_AGE = NOW - OBJ_DATE (как давно мы его извлекли). LM_AGE = OBJ_DATE - OBJ_LASTMOD (насколько стар был объект в момент извлечения). LM_FACTOR = OBJ_AGE / LM_AGE. CLIENT_MAX_AGE - максимальный возраст объекта, который удовлетворит клиента (HTTP/1.1 Cache-Control: ). EXPIRES - срок хранения объекта (из ответа сервера, если есть). В общих чертах алгоритм описан так:
если (определен CLIENT_MAX_AGE)
если (OBJ_AGE > CLIENT_MAX_AGE)
то (объект старый)
если (определен EXPIRES) {
если ( EXPIRES <= NOW)
то (объект старый)
иначе (объект свежий)
}
если (AGE > MAX_AGE) то (объект старый)
если (OBJ_DATE > OBJ_LASTMOD ) {
если (LM_FACTOR меньше PERCENT) то (объект свежий)
иначе (объект старый)
}
если (AGE <= MIN_AGE) то (объект свежий)
(объект старый)
По умолчанию (я эти числа изрядно увеличиваю):
refresh_pattern ^ftp: 1440 20% 10080
refresh_pattern ^gopher: 1440 0% 1440
refresh_pattern . 0 20% 4320
options
override-expire - нарушение стандарта HTTP! - использовать min даже если явно задан expire
override-lastmod - использовать min даже для недавно модифицированных объектов
reload-into-ims - нарушение стандарта HTTP! - преобразует клиентские запросы типа no-cache в If-Modified-Since
ignore-reload - нарушение стандарта HTTP! - игнорировать заголовки no-cache или reload в запросах клиентов
replacement_policy GDSF | LFUDA (частотные алгоритмы замещения объектов в кеше вместо LRU; требуется --enable-heap-replacement при сборке; в версии 2.4 расслоился на cache_replacement_policy и memory_replacement_policy)
reference_age 1 year (максимальное время хранения неиспользуемого объекта до его удаления по LRU алгоритму; если места на диске не хватает, то автоматически уменьшается)
quick_abort_min 16 KB (если клиент оборвал запрос, а осталось докачать всего min KB, то squid докачает)
quick_abort_max 16 KB (если клиент оборвал запрос, и осталось качать больше max KB, то прекратить)
quick_abort_pct 95 (если клиент оборвал запрос, а уже получено больше чем pct процентов объекта, то докачать)
negative_ttl 5 minutes (некоторые негативные ответы тоже кешируются - "connection refused "и "404 not found" - ttl задает их время жизни в кеше; по-моему, хватит и 1 минуты)
range_offset_limit 0 KB (если клиент делает запрос с середины объекта, то offset_limit равный -1 вынуждает squid загрузить весь объект в кеш до того как начать передачу клиенту - скажем 17го мегабайта ;) -; offset_limit равный 0 означает. что squid никогда не будет грузить больше, чем клиент запросил; offset_limit равен определенному числу означает, что squid будет грузить весь объект, если начало запроса меньше этого числа)
no_cache deny имя-ACL (определяет список объектов, которые не будут кешироваться; по-умолчанию, кешируется все, хотя рекомендуется определить "acl QUERY urlpath_regex cgi-bin \?" запретить его кеширование "no_cache deny QUERY"; на самом деле cgi-bin и query все-таки кешируются, хотя и слабо)
store_avg_object_size 13 KB (предполагаемый средний размер объекта, используемый для расчетов; у меня - 9КБ (12 КБ, если не кешировать маленькие объекты); не д.б. вдвое больше реального или возникнут проблемы)
store_objects_per_bucket 20 (число объектов на хеш-корзину, чем меньше, тем больше будет создано корзин)
always_direct allow|deny [!]aclname ... (запросы, удовлеворяющие данным acl не кешировать, а всегда направлять к первоисточнику)
never_direct allow|deny [!]aclname ...
store_dir_select_algorithm least-load | round-robin (алгоритм выбора директории хранения для кешируемого объекта)
сообщения об ошибках, журналы и мониторинг
logformat имя спецификация-формата (позволяет описать формат журнала запросов; предопределены форматы squid, squidmime, common и combined)
cache_access_log /usr/local/squid/logs/access.log (журнал запросов к кешу; до версии 2.6)
access_log /usr/local/squid/logs/access.log [имя-формата [ACL ...]] (журнал запросов к кешу; в версии 2.6)
cache_store_log /usr/local/squid/logs/store.log (журнал записи объектов в дисковый кеш; авторы рекомендуют поставить none, т.к. программ анализа все равно нет
emulate_httpd_log off | on (эмулировать или нет Common Log Format; лучше использовать родной формат)
log_ip_on_direct on | off (записывать в журнале IP-адрес сервера или соседа вместо имени)
log_mime_hdrs off (в журнал access записываются переданные полученные HTTP-заголовки - очень интересная информация, но больно длинная)
useragent_log имя-файла (по-умолчанию none; в этот файл будут записываться строки User-agent из HTTP-заголовков; необходима компиляция с "--enable-useragent_log")
referer_log имя-файла (по-умолчанию none; в этот файл будут записываться строки Refererиз HTTP-заголовков; необходима компиляция с "--enable-referer_log")
debug_options раздел,уровень (уровень отладки; волшебное слово ALL для всех разделов; по умолчанию ALL,1; уровень от 1 до 9 - наивысший; перечень разделов приведен в doc/debug-sections.txt)
log_fqdn off (определять и записывать в журнал полные доменные имена источника запроса, вносит дополнительную задержку в обработку запроса)
client_netmask 255.255.255.255 (при записи в журнал можно обнулять некоторые биты IP-адреса, чтоб защитить частную жизнь клиента)
log_icp_queries on|off (записывать ли в журнал ICP-запросы)
logfile_rotate 10 (squid -k rotate переименовывает журнальные файлы, данный параметр задает количество старых копий для ротации)
err_html_text строка (подставляется в шаблоны текстов сообщений об ошибках - лежат в директории error - вместо %L)
deny_info err_page_name acl (запросы, не прошедшие проверку в http_access, проверяются на соответствие acl выдается соответствующее сообщение об ошибке из файла page_name)
client_db on|off (сбор статистики о клиентах, по умолчанию - включен)
buffered_logs on|off (при включении запись в журнал буферизуется и слегка ускоряется)
high_response_time_warning msec (выдается предупреждение, если среднее время ответа в течении минуты превышает указанную величину)
high_page_fault_warning штук-в-секунду (выдается предупреждение, если среднее за минуту число подкачек страниц в секунду превышает указанную величину)
high_memory_warning число (выдается предупреждение, если используется слишком много памяти - mallinfo)
strip_query_terms on (удалять параметры query перед записью в журнал)
параметры обработки запросов FTP, WAIS, gopher
passive_ftp on | off (по умолчанию включен, но если squid за firewall, то надо выключить (будет использоваться PORT); введен в 2.3-STABLE3)
ftp_user email-адрес (будет подставляться вместо пароля при анонимном доступе к ftp-серверам; по умолчанию - Squid@, что вызывает проблемы с серверами, которые проверяют синтаксис адреса)
ftp_sanitycheck on (проверять, чтобы сервер не перепослал нас куда-то ещё в ответе на команду PORT)
ftp_telnet_protocol on (отключить для доступа на FTP-сервер, нарушающий стандарты)
icon_directory /usr/local/squid/etc/icons (каталог с иконками для FTP-оглавления)
short_icon_urls off (использовать относительные URL для адресов иконок)
wais_relay_host localhost
wais_relay_port 8000 (куда перенаправлять wais-запросы; в новых версиях по умолчанию - 0, что правильно :)
параметры обработки DNS запросов
check_hostnames on (проверять DNS имена на соответствие стандартам)
allow_underscore on (разрешать подчёркивания в DNS именах)
cache_dns_program /usr/local/squid/bin/dnsserver
dns_children 5 (число внешних процессов, которые делают DNS lookup вместо squid - чтобы он не зависал, ожидая результата поиска; 0 - если не нужен (реально использвать только в версиях от 2.5); от 5 до 32; сколько их надо легко понять, просматривая cache.log; при 300 тыс. запросах в день уже третий dnsserver имеет нулевую загрузку)
dns_retransmit_interval 5 seconds (каждый следующий интервал удваивается)
dns_timeout 5 minutes
dns_defnames off (дополнять однокомпонентные DNS-имена доменом по умолчанию перед запросом DNS-сервера)
dns_nameservers список-IP-адресов (будет использоваться вместо того списка DNS-серверов, который опреден в /etc/resolv.conf; по умолчанию - none)
hosts_file /etc/hosts
dns_testnames netscape.com internic.net nlanr.net microsoft.com (список имен хостов на примере которых проверяется работоспособность DNS, чтобы запретить проверку надо использовать ключ -D)
append_domain .deol.ru (добавляется к имени хоста, если в нем нет ни одной точки)
positive_dns_ttl 6 hours
negative_dns_ttl 5 minutes
ignore_unknown_nameservers on (игнорировать сообщения от DNS-серверов, которые мы не запрашивали)
параметры внешних программ
diskd_program /usr/local/squid/libexec/
unlinkd_program /usr/local/squid/bin/unlinkd (программа, используемая в параллельном процессе для удаления файлов; не нужна, если используется async-io)
pinger_program /usr/local/squid/bin/pinger (имя программы, используемой в параллельном процессе pinger; только если при компиляции использовался ключ "--enable-icmp")
redirect_program none (позволяет подключить программу преобразования URL при каждом запросе; запускается при запуске самого squid и висит в ожидании очередной строки; см.)
redirect_children 5 (сколько процессов преобразования запускать параллельно)
redirect_rewrites_host_header on (по умолчанию, Squid переписывает поле "Host:" в заголовках преобразованных запросов, это не всегда хорошо)
redirector_access acl (какие запросы направлять через редиректор; по умолчанию - все; в версии 2.4 появились ключевые слова allow и deny перед acl)
url_rewrite_program имя-программы (в отличие от redirect_program дополнительно передаётся urlgroup)
url_rewrite_children 5 (сколько процессов преобразования запускать параллельно)
url_rewrite_concurrency 0 (сколько запросов каждый процесс может обрабатывать параллельно)
url_rewrite_host_header no (переписывать заголовок Host:)
url_rewrite_access acl (какие запросы направлять через преобразователь; по умолчанию - все)
location_rewrite_program имя-программы (преобразование URL в ответах)
location_rewrite_children 5 (сколько процессов преобразования запускать параллельно)
location_rewrite_concurrency 0 (сколько запросов каждый процесс может обрабатывать параллельно)
location_rewrite_access acl (какие запросы направлять через преобразователь; по умолчанию - все)
mail_program mail (имя программы для посылки письма при падении squid)
параметры аутентификации (для включения аутентификации необходимо задать в http_access ACL (типа proxy_auth, proxy_auth_regex, external %LOGIN) с использованием имён пользователей; аутентификация прокси несовместима с прозрачным режимом до 2.6.15; после изменения схемы требуется restart, а не reload):
auth_param схема имя-параметра значение (задание параметров для программ аутентификации в 2.5 и выше; squid может предлагать клиенту несколько схем аутентификации (заголовок Proxy-Authenticate:), а браузер должен выбрать из них самую безопасную из понимаемых им; на практике, браузеры обычно выбирают самую первую; порядок предъявления схемы определяется порядком первого появления имени схемы в squid.conf; выключить действие схемы командой reconfigure нельзя):
basic: если squid получает запрос, который попадает под ACL proxy_auth (proxy_auth_regex, external с %LOGIN) в http_access, то squid ищет заголовок Authorization и извлекает из него имя и пароль (base64, открытым текстом); если заголовок не обнаружен, то браузеру возвращается сообщение об ошибке 407 (Proxy Authentication Required) со списком допустимых схем аутентификации, браузер запрашивает у пользователя имя и пароль для определённой области действия (realm); полученные от пользователя имя и пароль браузер передаёт в последующих запросах к squid в заголовке Authorization; для аутентификации используется внешняя программа, которая получает на стандартный ввод имя и пароль и должна ответить "OK" или "ERR"; параметры: program (имя программы и параметры), children (5), concurrency (предварительно необходимо убедиться, что поддерживается), realm (область действия, показывается пользователю при запросе пароля), credentialsttl (2 часа), casesensitive (off), blankpassword (off); в комплекте поставки имеются программы:
NCSA (ncsa_auth, вместе с именем программы /usr/local/squid26/libexec/ncsa_auth указывается имя файла с именами и хешированными crypt/md5/sha1 паролями; файл можно заполнять, например, с помощью htpasswd из комплекта apache; необходимо закрыть на чтение, чтобы не подбирали)
getpwnam (getpwname_auth)
LDAP (squid_ldap_auth)
MSNT (обращается к NT серверу)
mswin_sspi (только под MS Windows NT?)
multi-domain-NTLM
PAM (pam_auth)
SASL (sasl_auth)
SMB (smb_auth, smb_auth.sh)
YP
digest - squid возвращает браузеру требование аутентифицироваться вместе с именем области действия и случайной строкой (nonce), браузер запрашивает имя и пароль и выдаёт squid запрос с именем пользователя; для аутентификации используется внешняя программа, которая получает на стандартный ввод имя пользователя и область действия и возвращает сделанный из них хеш или "ERR"; этот хеш возвращается браузеру, который делает из него и пароля пользователя второй хеш, который посылается в следующем запросе к squid; параметры: program (имя программы и параметры), children (5), concurrency, realm, nonce_garbage_interval (5 minutes), nonce_max_duration (30 minutes), nonce_max_count (50), nonce_strictness (off), check_nonce_count (on), post_workaround (off); в комплекте поставки имеются программы:
password (digest_pw_auth, вместе с именем программы /usr/local/squid26/libexec/digest_pw_auth указывается имя файла с именами пользователей и паролями в формате "имя:пароль"; можно указать ключ "-c" и имя файла с готовыми хешами - MD5 (имя:область-действия:пароль) - в формате "имя:область-действия:хеш"; файл необходимо закрыть от чтения)
ldap (digest_ldap_auth)
ntlm (NTLMv1 до 2.5.STABLE5) - используется протокол NTLMSSP между squid и браузером; с клиентской стороны поддерживается MS IE (не работает в MS Windows Server 2003; "keep_alive off" на сервере не помогает, включение HTTP 1.1 для прокси на клиенте не помогает, помогает перевод клиента с NTLMv2 на LM: установить HKLM\System\CurrentControlSet\Control\LSA\LMCompatibilityLevel из 2 в 0) и Firefox (на всех платформах); Opera 9.02 под MS Windows выдаёт окошко для ручного ввода имени и пароля только, если ntlm-аутентификация является единственной; первый запрос браузер делает без указания аутентификационной информации; squid возвращает сообщение об ошибке 407 с указанием "Proxy-Authenticate: NTLM"; затем squid разрывает соединение, не глядя на keep-alive; клиент создаёт новое соединение и выдаёт запрос с "Proxy-Authorization: NTLM что-то", на что squid опять отвечает 407 с указанием "Proxy-Authenticate: NTLM другое-что-то"; теперь браузер может послать достаточно информации для аутентификации пользователя определённого домена; со следующим запросом клиента цикл повторяется в отличие от basic аутентификации (2 лишних пакета, 20% трафика), если разорвать TCP соединение; для аутентификации используется внешняя программа, которая участвует в этом протоколе; параметры: program (имя программы и параметры), children (5), keep_alive (on, могут быть проблемы с IE); в комплекте поставки имеются:
fakeauth (проверяет только синтаксис запроса),
mswin_sspi (только под MS Windows NT?),
no_check (no_check.pl, проверяет только синтаксис запроса),
SMB (ntlm_auth, обращается к контроллеру домена; параметры: имя-домена/имя-DC ... (необходимо определить в DNS соответствующее имя); требуется пропускать пакеты к DC на порт TCP/139; простейший тест: запустить "ntlm_auth -d имя-домена/имя-DC" и ввести "YR"; ключ "-d" вызывает выдачу большого объёма отладочной печати в cache.log
предлагается также использовать ntlm_auth из пакета samba-common с параметром --helper-protocol=squid-2.5-ntlmssp)
negotiate - используется протокол SPNEGO (Simple and Protected GSS-API Negotiation) между squid и браузером; для аутентификации используется внешняя программа, которая участвует в этом протоколе; параметры: program (имя программы и параметры), children (5), keep_alive (on, могут быть проблемы с IE); в комплекте поставки имеются: mswin_sspi (только под MS Windows NT?), ожидается поддержка SPNEGO в ntlm_auth из Samba-4.X (--helper-protocol=gss-spnego)
authenticate_program none (убрана в 2.5; позволяет производить аутентификацию клиентов, делающих запросы; программа должна в цикле читать строку "имя пароль" выдавать OK или ERR; должен быть определен ACL proxy_auth; традиционная для 2.4 программа аутентификация определена в ../auth_modules/NCSA (надо сказать make; make install), после чего добавить authenticate_program /usr/local/squid/bin/ncsa_auth /usr/local/squid/etc/passwd
authenticate_children 5 (сколько параллельных процессов будут заниматься аутентификацией; убрана в 2.5)
authenticate_ttl 3600 (сколько секунд кешировать результаты работ программы аутентификации)
authenticate_ip_ttl 0 (чтобы с нескольких мест не пользовались одним именем, требуется повторная аутентификация клиента, см. также max_user_ip)
authenticate_ip_ttl_is_strict on (убрана в 2.5)
proxy_auth_realm Squid proxy-caching web server (строка текста, которая будет выдана на экран клиента при запросе имени/пароля доступа к кешу; в 2.4 заменен обобщенной директивой auth_param; убрана в 2.5)
пример:
auth_param ntlm program /usr/local/squid/libexec/ntlm_auth имя-домена/простое-имя-DC
auth_param ntlm children 10
# файл digest_passwd_ha1 содержит имена и хеши для схемы digest
auth_param digest program /usr/local/squid/libexec/digest_pw_auth -c /usr/local/squid/etc/digest_passwd_ha1
auth_param digest realm proxy (digest, ha1)
# файл ncsa_passwd содержит имена и хеши для схемы basic
auth_param basic program /usr/local/squid/libexec/ncsa_auth /usr/local/squid/etc/ncsa_passwd
auth_param basic realm proxy (basic)
...
# файл noauth.acl содержит список IP, запросы с которых принимаются без аутентификации
acl noauth src "/usr/local/squid/etc/noauth.acl"
http_access allow noauth
# файл auth.acl содержит список IP, запросы с которых принимаются с аутентификацией
acl auth src "/usr/local/squid/etc/auth.acl"
acl password proxy_auth REQUIRED
# файл authname.acl содержит список IP, запросы с которых принимаются с аутентификацией
forward_timeout 4 minutes (максимальное время поиска пути)
connect_timeout 120 seconds (сколько времени ждать соединения от squid к серверу)
minimum_retry_timeout 5 seconds (если сервер имеет несколько IP адресов, то connection timeout делится на их количество, данный параметр ограничивает получившийся результат снизу, маловато; убран в 2.5)
peer_connect_timeout 30 seconds
siteselect_timeout 4 seconds (сколько времен разрешается потратить на выбор URL из URN; убрана в 2.5)
read_timeout 15 minutes (сколько времени разрешается ждать следующего байта от сервера, достаточно и 5 минут)
client_lifetime 1 day (сколько времени разрешать клиенту быть присоединенным к squid; в т.ч. в случае если он ушел не попрощавшись; это перебор, хватит и 8 часов; соединение обрывается даже если происходит передача данных!)
half_closed_clients on (разрешать наполовину закрытые соединения - например чтение есть, а запись уже закрыта; не стоит их баловать)
pconn_timeout 120 seconds (постоянные соединения с серверами и другими кешами)
ident_timeout 10 seconds
shutdown_lifetime 30 seconds (сколько времени продолжать обслуживание после получения SIGTERM or SIGHUP)
maximum_single_addr_tries 3 (сколько раз пытаться достучаться до сервера, имеющего 1 IP адрес; если сервер имеет несколько IP адресов, то каждый из них будет опробован ровно один раз)
ACL - определение списка доступа (тип: тип объекта, строка: регулярное выражение - шаблон для сравнения; по умолчанию чувствительное к регистру букв (строчные/прописные); чтобы игнорировать регистр букв, надо использовать ключ "-i") acl имя тип строка ... ... (логическое ИЛИ) acl имя тип "имя файла" (по одному параметру в строке) external_acl_type имя опции формат имя-программы параметры (описание внешней программы обработки ACL) типы:
src ip-address/netmask ... (clients IP address)
src addr1-addr2 ... (range of addresses)
dst ip-address/netmask ... (URL host's IP address)
myip ip-address/netmask ... (local socket IP address)
srcdomain foo.com ... (reverse lookup, client IP)
dstdomain foo.com ... (Destination server from URL; если в URL использовался IP, то делается попытка определить имя домена, если не удалась, то подставляется слово "none")
dstdom_regex [-i] строка ... (regex matching server; если в URL использовался IP, то делается попытка определить имя домена, если не удалась, то подставляется слово "none")
time [day-abbrevs] [h1:m1-h2:m2] (где день это одна буква из SMTWHFA)
url_regex [-i] строка (регулярное выражение для всего URL)
urlpath_regex [-i] строка (регулярное выражение для path-части URL)
urllogin [-i] строка (регулярное выражение для login-части URL)
port порт ... (перечень портов) в стандартной конфигурации определяется ACL Safe_port для интервала 1024-65535; это слишком слабое ограничение; лучше к безопасным портам отнести 32768-65535 (у меня все клиентские порты начинаются с 32768 и firewall эа этим следит), и отдельно всякие извращения перевода с русского на русский - 81, 82, 83, 88, 8000-8002, 8080-8083, 8091, 8100-8103, 8888
port порт1-порт2(интервал портов)
myport порт ... (перечень портов)
proto [HTTP | FTP | ...]
method [GET | POST | ... ] (в т.ч. собственный метод purge: acl PURGE method purge)
src_as number ... (номера автономных систем - AS, делается запрос к whois.ra.net на поиск !gASномер)
dst_as number ... (не более 253 или поставить IP-адрес в as_whois; такой поток запросов RADB не выдерживает, так что надо сделать несколько раз squid restart, чтобы таблица адресов заполнилась)
proxy_auth username ... (можно использовать строку REQUIREDдля любого имени пользователя)
proxy_auth_regex [-i] regexp
snmp community string ...
maxconn число(больше чем указанное число соединений с одного и того же IP)
max_user_ip число(больше чем указанное число соединений одного пользователя с различных IP-адресов)
external имя-типа параметры (использовать внешнюю программу, описанную в external_acl_type)
as_whois_server имя (whois сервер, используемый для получения номера AS; только при запуске или reconfigure; whois.ra.net aka whois.radb.net; лучше поставить IP адрес, иначе нельзя будет использовать более 250 AS)
права доступа
http_access allow|deny [!]aclname ... (кому разрешать доступ к прокси по HTTP; здесь и далее - логическое И)
http_reply_access allow|deny [!]aclname ... (какие ответы на запросы разрешить; http_reply_access allow all)icp_access allow|deny [!]aclname ... (кому разрешать доступ к прокси по ICP)
miss_access allow|deny [!]aclname ... (кому разрешить получать ответ MISS от нас)
cache_peer_access cache-host allow|deny [!]aclname ... (ограничить запросы к данному соседу - расширение для cache_peer_domain)
использование протокола ident
ident_lookup_access allow|deny [!]aclname
ident_lookup_access список-ACL (если запрос допускается ACL, то источник проверяется с помощью ident; по умолчанию "ident_lookup_access deny all" - по умолчанию ACL с именем all определяется так, что ему удовлетворяет любой запрос; чтоб запретить использовать ident совсем, можно компилировать с "--disable-ident")
параметры администрирования
cache_mgr email (почтовый адрес, на который будет послано письмо, если squid грохнется)
cache_effective_user nobody (если запустить squid от имени root, то поменять UID на указанный)
cache_effective_group nogroup
visible_hostname имя-хоста (это имя будет упоминаться в сообщениях об ошибках)
httpd_suppress_version_string off (подавлять выдачу номера версии Squid; появилась в 2.6)
unique_hostname уникальное-имя (если нескольким кешам дали одно и то же visible_hostname, то чтобы предотвратить циклы, надо определить каждому из них уникальное имя)
hostname_aliases имя ... (список синонимов для нашего имени хоста)
cachemgr_passwd password action action ... (задание пароля для действий по администрированию squid; чтоб запретить действие - поставьте пароль disable; чтоб разрешить действие без проверки пароля - поставьте пароль none, кроме действий config и shutdown; неполный список действий: 5min, 60min, asndb, authenticator, cbdata, client_list, comm_incoming, config, counters, delay, digest_stats, dns, events, filedescriptors, fqdncache, histograms, http_headers, info, io, ipcache, mem, menu, netdb, non_peers, objects, pconn, peer_select, redirector, refresh, server_list, shutdown, store_digest, storedir, utilization, via_headers, vm_objects; имя действия all - для всех действий)
параметры саморекламы, посылаемой в http://ircache.nlanr.net/Cache/Tracker
announce_period 0 day (0 означает - не посылать никогда)
announce_host tracker.ircache.net
announce_port 3131
announce_file имя-файла (дополнительно к стандартно информации - хост, порт - посылается этот файл)
параметры для работы в режиме ускорителя http-сервера
httpd_accel_host hostname (если нужна поддержка виртуальных хостов, в частности для transparent proxy, то вместо имени указать virtual)
httpd_accel_port port
httpd_accel_single_host off
httpd_accel_with_proxy on|off (по умолчанию кеширование для ускоряемого сервера выключено)
httpd_accel_uses_host_header on|off (для работы в прозрачном режиме требуется включить, иначе виртуальные сервера не будут правильно кешироваться, но т.к. squid не проверяет соответствие заголовка Head: и имени в URL, то это опасно. Я так понимаю, что можно подсовывать в кеш страницы с одного сервера под именем другого, затем когда нормальный пользователь запросит страницу с этого другого сервера, то он получит ее из кеша, куда она попала с первого сервера. Исправлено в 2.3)
преобразование заголовков и URL в запросах и ответах
forwarded_for on|off (если включено - по умолчанию - то squid будет вставлять IP-адрес или имя в заголовок перенаправляемых HTTP-запросов: "X-Forwarded-For: 192.1.2.3"; если выключено, то "X-Forwarded-For: unknown")
anonymize_headers allow|deny header_name ... (перечень заголовков, которые нуждаются в анонимизации; по умолчанию - ни один; можно использовать несколько строк, но все они должны иметь либо allow, либо deny; удален в 2.4)
header_access имя-заголовка allow | deny [!]acl (фильтрация заголовков запроса; введен в 2.4 вместо aninymize_headers; вместо имени заголовка запроса можно использовать ключевые слова All и Other (неизвестные заголовки); это нарушение протокола HTTP)
fake_user_agent none (если заголовок User-Agent фильтруется с помощь анонимизатора, то подставляется эта строка; удален в 2.4)
header_replace имя-заголовка строка (заменить заголовок на указанную строку; введен в 2.4 вместо fake_user_agent)
reload_into_ims on|off (при включении запросы типа no-cache или reload будут преобразовываться в If-Modified-Since; является нарушением стандартов; более гибкая настройка через refresh_pattern)
uri_whitespace strip (что делать с запросами, имеющими пробелы в URI)
strip - удалять пробелы
deny - сообщать Invalid Request
allow - передавать как есть
encode - кодировать в соответствии с RFC1738 и передавать дальше
chop - остаток после первого же пробела отбрасывать
broken_posts allow|deny acl ... (если запрос удовлетворяет acl и имеет тип PUT/POST, то squid посылает дополнительный CRLF после тела запроса, чтоб успокоить неправильно написанный сервер)
SNMP
snmp_port 3401 (порт, который слушает squid для SNMP запросов)
forward_snmpd_port 0 (если задан порт, то на него перенаправляются все SNMP-запросы; убрано в 2.3)
snmp_access allow|deny [!]aclname ... (кто будет допущен к SNMP порту, по умолчанию - никто)
pid_filename /usr/local/squid/logs/squid.pid (none, если не нужен)
max_open_disk_fds
offline_mode on|off (если включить, то squid будет брать объекты только из кеша и не будет пытaться обращаться к первоисточникам)
coredump_dir (по умолчанию в cache_dir)
redirector_bypass on | off (если включен и все редиректоры заняты, то не обрабатывать URI редиректором; если выключен и нет свободных редиректоров, то аварийное завершение - применяется, если редиректор используется для аутентификации)
chroot (делать chroot после разбора конфигурации; reconfigure работать не будет, если прислушиваемся к портам < 1024)
client_persistent_connections on (использовать постоянные соединения при общении с клиентами)
server_persistent_connections on (использовать постоянные соединения при общении с серверами)
persistent_connection_after_error off (не использовать постоянные соединения после получения ошибки)
balance_on_multiple_ip on (борьба с серверами, балансирующими траффик по нескольким IP и не умеющим сохранять сессию)
pipeline_prefetch on (если клиент работает в режиме pipeline, то запрашивать с сервера 2 объекта параллельно)
extension_methods (позволяет задать дополнительные нестандартизованные методы доступа HTTP - можно подсмотреть в cache.log)
ie_refresh off (борьба с неспособностью MS IE до 5.5 SP1 сделать полноценный refresh, снижает эффективность кеширования)
vary_ignore_expire off (позволяет squid игнорировать в некоторых случаях нулевое время хранения объекта - Expire: на текущее время)
параметры DELAY POOL, ограничивают интенсивность использования кеша для отдельных хостов и подсетей
delay_pools 0
delay_class номер-пула класс (д.б. ровно один пул каждого класса; классы: 1 - 3)
delay_access номер-пула allow|deny acl ...
delay_parameters pool aggregate network individual
delay_initial_bucket_level 50
интерфейс WCCP с маршрутизаторами Cisco (используется для прозрачного прокси и автоматического отключения при падении прокси; WCCPv1 в squid 2.3; WCCPv2 в squid 2.6)
wccp_router ip-адрес
wccp2_router ip-адрес
wccp_version 4 (для IOS 11.2 нужна версия 3)
wccp2_rebuild_wait
wccp2_forwarding_method
wccp2_return_method
wccp2_assignment_method
wccp2_service
wccp2_service_info
wccp2_weight
wccp_incoming_address IP-адрес
wccp_outgoing_address IP-адрес
wccp_address
wccp2_address
работа с БД digest
digest_generation on
digest_bits_per_entry
digest_rebuild_period
digest_rewrite_period
digest_swapout_chunk_size
digest_rebuild_chunk_procentage
4.6. Управление squid (Cache Manager)
Настройка прав доступа в squid.conf:
acl all src 0.0.0.0/0.0.0.0
acl localhost src 127.0.0.1/255.255.255.255
acl manager proto cache_object
acl managerhost src 1.2.3.4/255.255.255.255
http_access allow manager localhost
http_access allow manager managerhost
http_access deny manager
http_access allow all
cachemgr_passwd пароль команда
Управление squid с помощью программы client: /usr/local/squid/bin/client cache_object://localhost/команда
Управление squid с помощью cachemgr.cgi (лично я не пробовал и другим не советую):
Per-request state information, including full request and reply headers
Miscellaneous statistics collection
"Hot objects" which are kept entirely in memory
Причем большая часть используемой памяти не должна свопироваться (иначе работает безумно медленно). Например, при кеше в 7 ГБ (800 тысяч объектов) требуется 128 МБ оперативной памяти. При восстановлении оглавления кеша (после аварийной перезагрузки) требуется удвоенный объем.
Как уменьшить потребности:
попробовать GNU malloc или dlmalloc (./configure --enable-dlmalloc)
уменьшить cache_mem (пока не появятся сообщения в cache.log)
memory_pools off
уменьшить размер кеша (cache_swap) - единственный существенный способ
4.8. Алгоритмы замещения кеша (LRU, GDSF, LFUDA)
Squid поддерживает размер кеша между low и high, регулярно запуская процедуру удаления объектов (чем ближе мы к high, тем агрессивнее очистка). Вместо удаления можно использовать очистку файлов (truncate) пока хватает inode. Удаление производится асинхронно внешней программой unlinkd. Если объект тянется в данный момент, то он не удаляется. Если объект "отрицательно кеширован", то он удаляется. Если объект частный, то он удаляется. Алгоритмы замешения:
LRU. Если время с последнего использования объекта больше некой границы (threshold), то объект удаляется. Граница динамически вычисляется на основе заполненности кеша и low/high маркеров (начальное/максимальное значение задается в squid.conf). При стабилизации размера кеша граница представляет время полного заполнения (замещения) кеша в текущих условиях (типичное значение от 1 до 10 дней; если меньше 3 дней, то рекомендуется увеличить кеш).
GDSF. Стремится удержать маленькие полулярные объекты (растет hitrate, падает byterate).
LFUDA. hitrate падает, byterate - растет.
Сравнение алгоритмов проводится в
Enhancement and Validation of Squid's Cache Replacement Policy
Evaluating Content Management Techniques for Web Proxy Caches
4.9. Какие объекты кешируются
Кешируемость объектов в зависимости от кода возврата HTTP:
Caching Code
Successful 2xx
c 200 OK
201 Created
202 Accepted
c 203 Non-Authoriative Information *
E 204 No Content
205 Reset Content *
? 206 Partial Content *
Redirection 3xx
C 300 Multiple Choices
C 301 Moved Permanently
t 302 Moved Temporarily
- 303 See Other *
- 304 Not Modified
E 305 Use Proxy (proxy redirect) *
Client Error 4xx
E 400 Bad Request
- 401 Unauthorized
402 Payment Required *
E 403 Forbidden
E 404 Not Found
E 405 Method Not Allowed *
406 Not Acceptable *
- 407 Proxy Authentication Required *
408 Request Timeout *
409 Confict *
C 410 Gone *
411 Length Required *
412 Precondition Failed *
413 Request Entity To Large *
E 414 Request-URI Too Long *
415 Unsupported Media Type
Server Error 5xx
E 500 Internal Server Error
E 501 Not Implemented
E 502 Bad Gateway
E 503 Service Unavailable
E 504 Gateway Timeout *
505 HTTP Version Not Supported *
Notes:
* HTTP 1.1
c Cached unless a query response without expiry information
C Cached
E Negatively cached if no expiry headers
t Cached only if expiry information
- Not cached
Unless other said, the response code is not cached.
Кешируемость в зависимости от заголовков:
Responses with Cache-Control: Private are NOT cachable.
Responses with Cache-Control: No-Cache are NOT cachable.
Responses with Cache-Control: No-Store are NOT cachable.
Responses for requests with an Authorization header are cachable ONLY if the reponse includes Cache-Control: Public.
Responses with Vary headers are NOT cachable because Squid does not yet support Vary features.
4.10. Справедливый дележ канала (delay pool)
Пул - набор групп ведер определенного класса. Группа ведер - часть пула, привязанная к хосту, сети или одно на всех. Ведро - ограниченная емкость, в которую с ограниченной скоростью вливается внешний трафик, и из которой он раздается клиенту. Если ведро заполняется полностью, то запросы к серверу останавливаются, если пустеет, то увеличиваются (а клиент ждет).
Определены 3 класса пулов:
одно ведро на всех из этого класса
одно общее ведро и 255 отдельных для каждого хоста из C-сетки
255 ведер для каждой сетки (класс B) и отдельное для каждого хоста
quick abort д.б. установлен маленьким чтобы объект не качался на полной скорости после отпадения клиента (нет клиента для запроса - нет ограничений).
4.11. Squid как transparent proxy (только http)
В процессе участвуют маршрутизатор, Linux и Squid:
http-пакеты, бегущие мимо, должны отлавливаться маршрутизатором и переадресовываться на proxy-сервер. Как понять, что это http-пакет? Будем считать, что все пакеты, направленные на tcp/80, являются запросами на HTTP. Возникал вопрос: а может кешировать и другие порты? После обработки статистики (большой объем - 422MB, в ситуации с добровольным использованием proxy) выяснилось, что всего обращений было 3120260, из них HTTP - 92%. Из них на нестандартные порты - 2.3% (3128 - 0.05%, 8000 - 0.09%, 8001 - 0.13%, 8080 - 1.06%, 8081 - 0.15%, 8100 - 0.11%, 8101 - 0.46%). Я не вижу смысла бороться за 1%, разве что найду готовое решение ;)
Proxy-сервер уже стоит на пути этих пакетов (например, squid установлен на маршрутизаторе или firewall).
Cisco отлавливает такие пакеты и с помощью route-map перенаправляет их на proxy-сервер.
ОС proxy-сервера должна принимать эти пакеты, как родные, и перенаправлять к squid
linux 2.2.
конфигурация ядра: CONFIG_EXPERIMENTAL=y # включен и так CONFIG_NET=y # само собой CONFIG_FIREWALL=y # чтобы иметь возможность тонко управлять маршрутизацией (несовместим с FAST_SWITCHING) # CONFIG_IP_ALIAS is not set # у меня включено и вроде работает (при нехватке ОП зависает драйвер eth0, если ALIAS выключить, то прикладная программа) CONFIG_INET=y # включен и так # CONFIG_IP_MULTICAST is not set # а почему нельзя? CONFIG_IP_FIREWALL=y # чтобы иметь возможность тонко управлять IP-маршрутизацией CONFIG_IP_MASQUERADE=y # а необходимо ли это для transparent proxy? CONFIG_IP_TRANSPARENT_PROXY=y CONFIG_IP_ROUTER=y # необязательно, но может ускорить обработку пакетов
при загрузке включать ip_forward, ip_always_defrag (вставить в загрузочные скрипты: /etc/rc.d/init.d/network) echo 1 > /proc/sys/net/ipv4/ip_forward # ядро д.б. сконфигурировано поддержкой /proc и sysctl) echo 1 > /proc/sys/net/ipv4/ip_always_defrag # в ядре 2.2.12 указывается во время конфигурации
ipchains (ipfwadm в ядре 2.2 работать не будет)
ipchains -A input -p TCP -d 127.0.0.1/32 www -j ACCEPT
ipchains -A input -p TCP -d адрес-хоста/32 www -j ACCEPT
squid д.б. скомпилирован так, чтобы он принимал эти пакеты, как родные.
linux 2.2 и squid 2.2. Происходит само собой.
squid д.б. сконфигурирован так, чтобы обрабатывать эти пакеты соответствующим образом.
http_port 3128 # redirect д.б. на этот порт
httpd_accel_host virtual # имитирует акселератор http-сервера, но не совсе нормально
httpd_accel_port 80 # а если перенаправляли не только 80 порт?
httpd_accel_with_proxy on # иначе при работе в режиме акселератора отключается кеширование
httpd_accel_uses_host_header on # иначе виртуальные домены будут неправильно кешироваться (см. замечание про безопасность)
Проблема. дырка в firewall: запрос приходит на прокси-сервер, который от своего имени (уже изнутри) лезет куда не надо.
Ссылки:
FAQ
The Compleat (sic) Idiot's Guide to Transparent Proxy with Linux and Squid
4.12. Формат журналов
Формат access.log (запись делается, когда клиент закрывает socket; для наших 300 тысяч запросов в день получается 60 MB в день!):
timestamp (unix time in ms)
elapsed (ms), если клиент "ушел, не попрощавшись", то здесь будет время потраченное на обнаружение данного факта, а не время реального обслуживания (иногда более получаса на маленький файл)
TCP_REFRESH_HIT (объект в кеше был старым, был сделан IMS-запрос к источнику и тот вернул "304 Not Modified")
TCP_REFRESH_MISS (объект в кеше был старым, был сделан IMS-запрос к источнику и тот вернул обновленное содержание)
TCP_IMS_HIT (клиент выдал IMS-запрос, объект оказался в кеше и свежим)
TCP_IMS_MISS (клиент выдал IMS-запрос для просроченного объекта)
TCP_REF_FAIL_HIT (объект в кеше староват, но запросить новую копию не удалось)
TCP_SWAPFAIL (объект д.б. в кеше, но не смогли извлечь)
TCP_DENIED
UDP_...
ERR_CLIENT_ABORT
ERR_NO_CLIENTS
ERR_READ_ERROR
ERR_CONNECT_FAIL
ERR_...
size (bytes to client)
method (GET, POST, ...)
URL
ident ("-", если недоступен)
hierarhy data/Hostname
DEAD_NEIGHTBOR
DEAD_PARENT
LOCAL_IP_DIRECT
FIRST_PARENT_MISS
FIRST_UP_PARENT
PARENT_HIT (UDP-запрос к parent вернулся с подтверждением)
SINGLE_PARENT
PARENT_UDP_HIT_OBJECT (объект оказался у parent и поместился в UDP-ответе)
DIRECT (объект был запрошен с оригинального сервера)
...
тип содержимого (MIME тип/подтип)
Формат store.log:
time (unix format with ms)
action
RELEASE (удален из кеша)
SWAPOUT (сохранен на диск)
SWAPIN (был на диске, загружен в память)
HTTP reply code
HTTP Date: reply header
HTTP Last-Modified: reply header
HTTP Expires: reply header
HTTP Content-Type: reply header
HTTP Content-Length: reply header
реально полученное число байт (если не совпадает с предыдущим числом, объект не хранится)
HTTP метод (GET, POST, ...)
ключ доступа (обычно URL, частные объекты еще и последовательный номер и метод)
Еще можно собирать useragent.log, все HTTP-заголовки и отладочную информацию. Я собираю только access.log и этого очень много.
Время в журналах записывается в Unix-формате (число милисекунд с 1 января 1970 года), что неудобно. Преобразовать в человеческий формат можно, например, с помощью gawk: awk '{print strftime("%Y%m%d%H%M%S",$1), $2, $3, $4, $5, $6, $7, $8, $9, $10, $11}' (printlog.sh) или perl: s/^\d+\.\d+/localtime $&/e;
Squid не умеет работать с файлами, превышающими 2 ГБ, так что журналы надо регулярно чистить.
4.13. Обработка статистики
В комплекте поставки идут access-extract.pl, (увеличено MaxEntries до ...) получающая на стандартный ввод журнал access.log выдающая на стандартный выво промежуточный результат, и access-summary.pl (убрал выдачу ICP, которой у меня нет, за счет чего увеличил ширину колонки с именами хостов; в xsort изменил сортировку с COUNT на BYTES), делающая из него красивый отчет. Внутри используется squid-logs.pl. Его надо расширить новыми суффиксами имен файлов (bmp - Image; rm, mid, mp3 - Audio; pl, cgi, shtml, php, php3, phtml, asp, dll - Dynamic; rpm, cab, avc - Bundle; css - HTML; koi - Text; js - Software). За день получается 60МБ в access.log, поэтому у меня не хватает терпения дождаться результатов работы других процедур из комплекта.
Частота обращений к объектам извлекается из access.log с помощью (url_freq.sh) awk '{print $7}' | sort | awk -f /usr/local/bin/count.awk | sort -nr +1 или без учета anchor и query-частей URL (url_freq_noq.sh) awk '{print $7}' | awk -F'?' '{print $1}' | awk -F';' '{print $1}' | awk -F'#' '{print $1}' | sort | awk -f /usr/local/bin/count.awk | sort -rn +1
4.14. LightSquid - анализатор статистики использования squid и генератор отчётов
LightSquid 1.7.1 - набор скриптов на perl для анализа журналов, не требует СУБД, очень быстр. Состоит из скрипта lightparser.pl, преобразующего журналы squid в собственный набор данных и набора cgi-скриптов для генерации отчётов (безопасность скриптов неизвестна, обновление каждые 10 минут). Набор отчётов полон и очень удобен: отчёты по дням, месяцам и годам для всей организации, групп и отдельных пользователей с указанием трафика, доли трафика, использования кеша, популярных сайтах; пометки о превышении лимита, больших файлах и подозрительной доле POST/PUT; статистика по самым популярным сайтам и кто и когда их использовал; графики загрузки по дням для пользователей и всей организации; детальные графики по часам для каждого пользователя. Требуется perl, а для графических отчётов gd и perl-GD (взял из FC6).
Скрипт lightparser.pl быстр (20 тысяч строк на Xeon 1.6 GHz), самостоятельно разжимает архивы .gz и .bz2, данные для каждого дня помещаются в отдельный подкаталог в каталоге с отчётами, в котором данные для каждого пользователя помещаются в отдельный текстовый файл. Записи с кодом 4xx пропускаются. Некоторые URL приводятся к общей форме (mail.ru, spylog.com и др.). В качестве параметров можно указывать имя файла с журналом относительно каталога с журналами и ключевые слова "today", "yesterday" и дату в формате YYYYMMDD. Каталог report имеет относительно небольшой объём (у меня получилось 60 МБ на месяц), т.к. отчёты создаются по запросу.
$cfgpath: путь к остальным файлам настройки (каталог-развёртывания)
$tplpath: путь к шаблонам страниц (каталог-развёртывания/tpl)
$langpath: путь к языковым файлам (каталог-развёртывания/lang)
$reportpath: путь к каталогу отчётов (каталог-развёртывания/report)
$logpath: путь к каталогу с журналами squid
$ip2namepath: путь к каталогу к подпрограммам преобразования ip в имена пользователей
$squidlogtype: тип журнала (для стандартного формата squid - 0)
$skipurl: регулярное выражение для отсечения некоторых URL из журнала
$ip2name: способ получения имени пользователя из журнала
simple - если имя пользователя в журнале отсутствует, то использовать IP адрес
squidauth - если в журнале присутствует имя пользователя, то преобразовать его (URLDecode), иначе использовать IP адрес
list - всегда извлекать имя пользователя по IP адресу из файла (я сделал модификацию, запронить users.txt)
squidlist2 - извлекать имя пользователя по IP адресу из файла (сетевые маски)
demo - если имя пользователя в журнале отсутствует, то DNS или IP
ip - всегда использовать IP адрес
dns - определять DNS имя по IP адресу
dhcp - извлекать имя пользователя из /etc/dhcpd.conf
...
$timereport: собирать статистику о временах доступа к сайтам; удваивает размер и время обработки (рекомендую убрать, пока начальник не заметил)
$lang: ru
$DecOutType: fine
$decdelimiter: " "
$showgroupid: 0
$showoversizelink: генерировать отчёт о пользователях, превысивших лимит
$showputpost: собирать статистику по POST
$putpostwarninglevel: подозрительно большой размер POST, в процентах
$userealname: преобразовывать идентификаторы пользователей в имена (файл realname.cfg)
$bigfilelimit: размер подозрительно больших файлов, которые попадут в отдельный отчёт
$perusertrafficlimit: пользователи скачавшие больше попадут в отдельный отчёт
$topsiteslimit: количество сайтов в отчёте наиболее популярных сайтов
$usertimelimit: количество сайтов в отчёте времени, потраченного пользователями
$graphreport: строить графики
$graphmaxuser: масштаб по вертикали месячных графиков отдельных пользователей
$graphmaxall: масштаб по вертикали месячных графиков
заполнить файл соответствия между именами и именами групп - group.cfg; поля разделяются табуляциями: имя пользователя, номер группы, имя группы
заполнить файл realname.cfg; поля разделяются табуляциями: имя пользователя, реальное имя пользователя
skipuser.cfg
поменять права для всех файлов на владельца процесса apache, но убрать права на запись
начальное заполнение каталога с отчётами
настроить apache на запуск cgi
<Directory "имя-каталога-разворачивания">
AddHandler cgi-script .cgi
AllowOverride All
Order deny,allow
Deny from all
Allow from откуда-можно-смотреть
</Directory>
опробовать доступ к сайту
добавить в crontab пользователя с достаточными правами ежедневный запуск:
lightparser.pl yesterday access.log.1.gz
lightparser.pl yesterday
4.15. sarg (Squid Analysis Report Generator)
SARG (ранее sqmgrlog) - Squid Analysis Report Generator. Отчёты создаются в формате html (по умолчанию - в /var/www/html), для графиков используется библиотека gd. Установка пакета sarg-2.2-1.el4.rf.i386.rpm на CentOS 4.3 и sarg-2.2.3.1-1.el5.rf.i386.rpm на CentOS 5.0 (x86-64 не работает). Требуется пакет gd, отчёты складываются в /var/www/sarg, настройка доступа для apache в /etc/httpd/conf.d/sarg.conf). Конфигурационный файл /etc/sarg/sarg.conf (символ '#' - начало комментария, каждый параметр на отдельной строке):
lastlog число-сохраняемых-отчётов (0 - без ограничений)
remove_temp_files yes
index { yes | no | only } (создавать index.html)
index_tree { date | file }
overwrite_report no (перезаписывать отчёт, если отчёт за указанный день уже существует)
records_without_userid {ignore | ip | everybody } (что делать, если в строке журнала нет идентификатора пользователя; ignore - пропускать строку, ip - записывать ip, everybody - вместо userid записывать строку "everybody" )
use_comma {no | yes} (использовать запятую вместо десятичной точки)
mail_utility mail (какую программу использовать для посылки отчёта по почте)
topsites_num 100 (сколько сайтов включить в отчёт о самых популярных сайтах)
topsites_sort_order {CONNECT | BYTES} {D | A} (тип сортировки отчёта о самых популярных сайтах)
index_sort_order {D | A} (тип сортировки индекса)
exclude_codes имя-файла (/etc/sarg/exclude_codes, исключить записи с указанными кодами)
report_type перечень-отчётов-через-пробел
topusers (для самых "прожорливых" пользователей выводится имя пользователя (IP адрес), имена сайтов, число байт и т.д.)
topsites (для самых популярных сайтов выводится имя сайта, число соединений и загруженных байт)
sites_users (для каждого сайта перечисляется список заходивших на него пользователей)
users_sites (кто и куда ходил)
date_time (потребление трафика почасовое и посуточное)
denied (denied.log, куда пользователей не пустили: время, userid, IP-адрес, URL)
auth_failures (ошибки аутентификации)
site_user_time_date (sites, dates, times and bytes report)
downloads (download.log: для каждого загруженного файла выводится время, userid, IP-адрес, URL; см. download_suffix)
usertab имя-файла (none; файл содержит соответствие между userid/IP и реальным именем)
long_url no (вставлять в отчёт полный URL (не советую) или только имя сайта)
date_time_by { bytes | elap } (включать в почасовой отчёт байты или потраченное время)
charset Koi8-r (а для Russian_UFT-8?)
user_invalid_char "&/" (символы, недопустимые в userid)
include_users "список:пользователей:через:двоеточие" (включать в отчёт только указанных пользователей)
exclude_string "список:строк:через:двоеточие" (не включать в отчёт строки журнала, содержащие указанные строки)
show_successful_message {yes | no}
show_read_statistics yes (помогает скоротать время в ожидании завершения отчёта)
topuser_fields NUM DATE_TIME USERID CONNECT BYTES %BYTES IN-CACHE-OUT USED_TIME MILISEC %TIME TOTAL AVERAGE
user_report_fields CONNECT BYTES %BYTES IN-CACHE-OUT USED_TIME MILISEC %TIME TOTAL AVERAGE
topuser_num 0 (0 - без ограничений; сколько пользователей включить в отчёт о самых популярных сайтах)
site_user_time_date_type { table | list } (отчёт site_user_time_date в виде таблицы или списка)
datafile имя-файла (сохранить отчёт в виде файла для дальнейшей обработки)
-x (отладочная печать на stdout; на неё действует language и charset)
-z (?)
Практика - программа глючная и медленная, точнее очень глючная (sites_users содержит какую-то ерунду; забывает удалять и закрывать файлы - требуется ulimit 60000; не все графики создаются; в результате пришлось разбить на 3 части, считающиеся в разные дни: полный список пользователей без подробностей, первые 10 пользователей с подробностями, первые 100 сайтов) и очень медленная (полный месячный отчёт - 180 GB трафика - обрабатывается в течение 2 часов). Версию 2.2.3 так и не удалось заставить работать. В результате отказался в пользу LightSquid. Сбор суммарной информации по использованию трафика пользователями за последний месяц:
time nice -19 sarg -d $(date --date "1 month ago" +%d/%m/%Y)-$(date --date "1 day ago" +%d/%m/%Y) \
-x -z -l /squid/logs/access.log.5.gz ...
где /etc/sarg/sarg.conf содержит
graphs no
resolve_ip no
user_ip yes
topuser_sort_field BYTES reverse
user_sort_field BYTES reverse
index yes
overwrite_report yes
records_without_userid ip
report_type topusers
usertab /etc/sarg/usertab
privacy no
exclude_string имя-своего-домена
topuser_fields NUM DATE_TIME USERID CONNECT BYTES %BYTES IN-CACHE-OUT USED_TIME MILISEC %TIME TOTAL AVERAGE
user_report_fields CONNECT BYTES %BYTES IN-CACHE-OUT USED_TIME MILISEC %TIME TOTAL AVERAGE
topuser_num 0
displayed_values bytes
user_report_limit 0
ulimit 60000
Сбор информацию куда ходил конкретный пользователь (10 самых "прожорливых" пользователей) за последний месяц (15 минут CPU):
time nice -19 sarg -f /etc/sarg/sarg.top10user.conf \
topuser_fields NUM DATE_TIME USERID CONNECT BYTES %BYTES IN-CACHE-OUT USED_TIME MILISEC %TIME TOTAL AVERAGE
user_report_fields CONNECT BYTES %BYTES IN-CACHE-OUT USED_TIME MILISEC %TIME TOTAL AVERAGE
topuser_num 10
displayed_values bytes
user_report_limit 10
ulimit 60000
Ссылки:
SARG
пакеты sarg для RedHat (dag)
4.16. redirector, как средство оптимизации
redirector - внешняя программа (небуфферизованный в/в), в цикле читает с stdin URL и пишет на stdout преобразованный URL (или пустую строку, если нет преобразований). Преобразование происходит после проверки ACL, но до проверки на присутствие в кеше. В 2.6 заменён на url_rewrite_program. Формат входной строки (поля, разделенные пробелами):
URL
ip-address/fqdn (если fqdn нет, то "-")
ident ("-", если нет)
method (GET, POST, ...)
urlgroup (в 2.6)
В качестве примера использования редиректора для уменьшения трафика в поставке приводится редиректор, производящий нормализацию URL (приведение к стандартному виду), что увеличивает вероятность попадания в кеш. А также редиректор преобразующий запросы на загрузку всяких там IE, Netscape и пр. с различных зеркал в запросы к локальному www-серверу (автор клянется, что это дает 15%). См. также про борьбу с баннерами.
Примеры redirectors:
SquidGuard
Squirm
Jesred (усовершенствованный Squirm)
4.17. Борьба с баннерами
Только не будем спорить о морали :) Но и в transparent режиме этого делать не надо. Поставьте себе локальный прокси и радуйтесь. Кстати, теми же методами можно бороться со счетчиками и порно.
Превращение банеров-картинок в рваные прямоугольники:
Насобирать "вредителей" (в виде регулярных выражений)
Заводим файлы в /usr/local/squid/etc:
banners_path_regex - по одному регулярному выражению на строку
banners_regex - по одному регулярному выражению на строку
banners_exclusion (это строки, трактуемые в предыдущих файлах как баннеры, но их лучше не трогать - JavaScript всякие)
Замена рекламных банеров на пустое место. Если рваные прямоугольники оскорбляют эстетические чувства. Предполагается, что в исходных страницах заданы width и height, иначе страница поплывет (можно заменять банеры на картинки соответствующего размера, но это большой труд).
Насобирать "вредителей" (в виде регулярных выражений)
На своем http-сервере завести "заменитель" рекламных картинок void.gif
Настраиваем redirector в squid.conf (если он уже используется, то добавить к старому; м.б. еще настроить redirector_access): redirect_program /usr/local/squid/bin/banners.pl
banners.pl (perl выбран для простоты демонстрации):
К сожалению, использование "http_access deny" для блокировки JavaScript программ не получается (броузер не показывает страницу совсем). Поэтому приходится заменять реальный скрипт через redirect (см. выше) на что-нибудь безобидное (и каждый случай обрабатывать отдельно :(. Например, если исходный скрипт открывал окно с рекламой (<script src=...>), то вместо него подсовываем
вместо tx3 (если он встроен страницу с помощью SSI, то не поможет, да и зачем тогда его резать?):
document.write(" ");
Ссылки:
Борьба с баннерами с помощью Squid'а
Фильтры
Копия классической статьи Ковалева (к сожалению, оригинал недоступен)
DansGuardian (фильтрация по содержимому, пакеты, для коммерческого использования платный)
РЕЖИК
SquidGuard
squidGuard и другие
4.18. squidGuard
squidGuard позволяет фильтровать и переадресовывать запросы по именам доменов, URL и регулярным выражениям. Позволяет группировать пользователей по IP адресам с заданием различных правил для различных групп с указанием времени суток. Возможно задание списка "хороших" сайтов. Домены и URL могут храниться в текстовых файлах или в формате Berkeley DB. Не фильтрует содержимое запросов и встроенные скрипты. GPL. Можно использовать бесплатно в любых целях, кроме продажи. К сожалению не изменялся с 2001 года (хотя есть заплатки от последователей и последователей).
Устанавливаю из готового пакета (/usr/bin/squidGuard, /etc/squid/squidguard.conf, /etc/logrotate.d/squidguard, /var/log/squidguard/, /usr/share/doc/squidguard-1.2.0/), пакета с чёрным списком (/etc/squid/squidguard-blacklists.conf; /etc/logrotate.d/squidguard-blacklists; /etc/squid/local/bad/; /etc/squid/local/good/; /var/lib/squidguard/: ads/, adult/, aggressive/, audio-video/, drugs/, forums/, gambling/, hacking/, local, mail/, /proxy/, violence/, warez/). Из исходных текстов устанавливается обычным путём (./configure; make; make install), требуется Berkeley DB 2.x. После установки необходимо настроить /etc/squid/squidguard-blacklists.conf и просмотреть входящие в комплект чёрные списки. После установки необходимо настроить права доступа к /var/log/squidguard, а после первого создания БД (ключ -C) настроить права доступа к /var/lib/squidguard и /etc/squid/local/. Настроить squid.conf:
-C имя-файла | all (преобразовать текстовый файл в .bd, не забыть указать "-c имя-файла-настроек")
-u (слить изменения из файлов .diff в .bd)
Файл настройки описывает поименованные группы интервалов времени (используется при описании группы клиентов), группы пользователей (по IP адресам), группы URL (ссылки на текстовые файлы и БД), группы правил переадресации и группы ACL. Комментарии начинаются с '#'; имеется большой список зарезервированных слов (в частности: anonymous, user, userlist); нельзя ссылаться на описания групп вперёд; описания групп начинаются с
тип-группы имя-группы {
и завершаются '}'. В начале файла указываются имена используемых файлов:
logdir имя-каталога (в этом каталоге будут лежать файлы squidGuard.error и squidGuard.log; имя-каталога также используется как базовое имя для имён файлов, описываемых в директиве log)
dbhome имя-каталога (имя-каталога используется как база для имён файлов, со списками доменов, выражений и URL
Описание интервала времени (имя типа: time) состоит из перечня спецификаций (каждое на отдельной строке, при перекрытии интервалы объединяются), следующих видов (вместо года, месяца или дня можно указать '*'):
weekly sunday [...] [HH:MM-HH:MM]
date YYYY-MM-DD [...] [HH:MM-HH:MM ...]
date YYYY-MM-DD-YYYY-MM-DD [HH:MM-HH:MM ...]
Описание группы клиентов (имя типа: source) состоит из перечня адресов клиентов в следующих форматах (файл содержит на каждой строке IP адрес без ключевого слова "ip"; использование доменов требует log_fqdn в squid.conf; имена пользователей определяются по протоколу ident (доменные имена с обратной косой чертой не поддерживаются); спецификации одного типа объединяются, разных типов - пересекаются; группы могут пересекаться - приоритет имеет первая по тексту; имя журнала берётся относительно logdir):
ip адрес-хоста ...
ip адрес-сети/длина-маски ...
ip адрес-сети/маска ...
ip адрес-адрес ...
iplist имя-файла
domain имя-хоста ...
user имя-пользователя ...
userlist имя-файла
logfile имя-файла
Описание группы клиентов может иметь условие по времени:
Описание группы URL (имя типа: destination) состоит из перечня URL в следующих форматах (спецификации любых типов объединяются; группы могут пересекаться - приоритет имеет первая в директиве pass; в списках необходимо использовать только строчные буквы; включение имени домена включает все хосты во всех поддоменах этого домена; при включении URL в список из него необходимо удалить "http://www.", ":8080" и завершающее имя или "/"; в строке списка URL можно в качестве второго поля указать новый URL для перенаправления (это работает быстрее, чем rewrite); использование регулярных выражений сильно замедляет работу; имя журнала берётся относительно logdir):
domainlist имя-файла
urllist имя-файла
expressionlist имя-файла
redirect [302:]URL
logfile имя-файла
Описание группы URL может иметь условие по времени:
Имеется специальная группа пользователей default, в которую входят пользователи, не вошедшие ни в одну из остальных групп или вошедшие в группу, не имеющую ACL; здесь же задаются правило переадресации для групп клиентов, не имеющих собственных правил переадресации.
Директива redirect (если URL блокируется фильтром, то какой-нибудь redirect должен быть обязательно определён) позволяет производить подстановку переменных (в поставке имеется шаблон squidGuard.cgi для создания красивых страниц с объяснением):
%a - IP адрес клиента
%n - имя хоста клиента
%i - имя пользователя согласно ident
%s - имя группы клиентов
%t - имя группы URL
%u - URL
%p - REQUEST_URI
Первый же сайт, на который я зашёл (rambler.ru), оказался в списках ads и adult.
Ссылки:
An ultrafast and free filter, redirector and access controller
squidGuard Patches
SquidGuard - ДЛЯ ВСЕХ
4.19. Приемы конфигурации
Простейшие случаи иерархии. Основной squid с консервативными настройками и вспомогательный с агрессивными настройками (антибаннер ;).
Консервативный:
ICP выключен
никаких соседей
maximum_object_size побольше
большой объем кеша на диске
стандартные (почти) настройки refresh_pattern
transparent proxy
Агрессивный:
ICP выключен
cache_peer основной parent 3128 3130 no-query default # если не нашел объект в своем кеше, то обращаться к parent, а не к источнику prefer_direct off
hierarchy_stoplist - пустой
maximum_object_size побольше
очень небольшой объем кеша на диске (пробовал поставить нулевой размер и cache_peer ... proxy-only, но возникают проблемы при обработке ошибок)
собственно агрессивная настройка:
redirect
refresh
acl, http_access, deny_info
Закрыть доступ к какой-то информации для клиентов
badobjects - это произвольное имя ACL; ERR_ACCESS_DENIED - имя файла в /usr/lib/squid/errors/English или в подобном месте, вместо этого файла можно поставить для каждой ситуации свой файл; воздействие http_access зависит от места, в которое его поставить; если squid получает от parent TCP_DENIED, то он лезет напрямую:
acl badobjects url_regex регулярное-выражение
http_access deny badobjects
deny_info ERR_ACCESS_DENIED badobjects
Шаблон для борьбы с RealPlayer
http://[^/]+/SmpDsBhgRl
Как удалить объект из кеша
В squid.conf:
acl PURGE method purge
acl localhost src 127.0.0.1
http_access allow purge localhost
http_access deny purge
Теперь для каждого удаляемого объекта: client -m PURGE URI
4.20. Использование дополнительного канала для доступа в Интернет
Имеем маршрутизатор (Cisco) с двумя каналами доступа в Интернет через двух различных провайдеров. Клиентские компьютеры расположены в адресном пространстве одного из них, а хочется нагрузить оба канала на прием. Создаем файл as.list, содержащий список AS ,к которым мы хотим обращаться через второй канал. Конфигурируем squid:
acl all src 0.0.0.0/0.0.0.0
acl second dst_as "as.list"
cache_peer второй-squid parent 3129 0 no-query default (описываем вспомогательный squid как старший для нас)
cache_peer_access второй-squid allow second (обращаться к нему только, если сервер находится в AS из списка)
hierarchy_stoplist какой-нибудь-бред deny all (чтобы cgi-bin и QUERY тоже шли по этому маршруту)
never_direct allow second (не обращаться напрямую к серверам из AS списка)
never_direct deny all
Конфигурируем вспомогательный squid-сервер (можно даже на том же хосте - специально выбран нестандартный порт; только прямого доступа к нему давать не надо):
никаких соседей/icp/htcp
tcp_outgoing_address из адресного пространства второго провайдера
никакого кеширования
4.21. SNMP
Для сбора статистики с помощью встроенного агента SNMP Squid должен быть собран с ключом --enable-snmp. По умолчанию, squid слушает SNMP запросы на порту 3401 (вместо стандартного 161).
Для обеспечения прав доступа надо записать в squid.conf (не забывайте про сетевой экран):
acl snmppublic snmp_community имя-сообщества
# snmp_port 3401
snmp_access allow snmppublic localhost
MIB файл называется /usr/local/squid/share/mib.txt: надо убрать фигурные скобки со всем содержимым из описания модуля, положить его в /usr/share/snmp/mibs. Извлечение полного дерева объектов: snmpwalk -p 3401 -m SQUID-MIB имя-хоста имя-сообщества squid
При описании использована форма записи SMIv2, хотя поддерживается только SNMPv1. Единственная переменная, определенная как read-write: cacheLoggingFacility (нечаянно?). trap отсутствуют. Все объекты лежат в поддереве iso.org.dod.internet.private.enterprises.nlanr.squid (1.3.6.1.4.1.3495.1):
cacheSystem
cacheSysVMsize (объем кеша в оперативной памяти, в KB)
cacheMedianSvcTable (усредненная статистика за интервал времени, указанный в cacheMedianTime)
cacheMedianSvcEntry (индекс доступа к экземпляру: cacheMedianTime)
cacheMedianTime (интервал времени усреднения: 1, 5 и 60 минут)
cacheHttpAllSvcTime (среднее время обслуживания всех запросов, милисекунд)
cacheHttpMissSvcTime (среднее время обслуживание запросов, отсутствующих в кеш или устаревших)
cacheHttpNmSvcTime (HTTP near miss service time)
cacheHttpHitSvcTime (среднее время обслуживание запросов, найденных в кеш; по-моему, считается неправильно: TCP_HIT для локального хоста без обращения к серверу картинки в 8 кБ иногда требует больше получаса)
cacheIcpQuerySvcTime
cacheIcpReplySvcTime
cacheDnsSvcTime (среднее время обслуживания DNS)
cacheRequestHitRatio (%, можно вычислить по cacheProtoClientHttpRequests и cacheServerRequests)
cacheRequestByteRatio (%, можно вычислить по cacheServerInKb и cacheHttpOutKb)
cacheNetwork
cacheIpCache (статистика кеша IP: получение IP адреса по имени и доступность сервера)
cacheIpEntries (элементов в кеше IP)
cacheIpRequests
cacheIpHits
cacheIpPendingHits
cacheIpNegativeHits
cacheIpMisses
cacheBlockingGetHostByName
cacheAttemptReleaseLckEntries
cacheFqdnCache (определение полного имени по простому)
cacheFqdnEntries (у меня их всего 2)
cacheFqdnRequests
cacheFqdnHits
cacheFqdnPendingHits
cacheFqdnNegativeHits
cacheFqdnMisses
cacheBlockingGetHostByAddr
cacheDns
cacheDnsRequests
cacheDnsReplies
cacheDnsNumberServers
cacheMesh (таблицы соседей и клиентов, их состояние и статистика, у меня не работает, да и в описании ошибки)
4.22. Мониторинг с помощью rrdtool
Для мониторинга работы Squid можно использовать MRTG или rrdtool. В последнее время я потихонечку перевожу весь свой мониторинг с MRTG на rrdtool. Хотя использование rrdtool более трудоемко, зато он требует меньше ресурсов при работе и не заполняет всю имеющуюся память при проблемах с сетью. К тому же он позволяет выводить больше 2 графиков на одну картинку. При этом я имитирую внешний вид и поведение mrtg. К сожалению, не вся статистика доступна по SNMP (например, доля прерванных соединений), а часть той статистики, что должна извлекаться согласно документации, извлекается с ошибками. Нам надо: спроектировать структуру БД и создать ее; обеспечить внесение изменений каждые 5 минут; обеспечить регулярное обновление суточных, недельных, месячных и годовых графиков; создать набор HTML страниц для доступа к графикам.
Все данные, связанные с работой Squid, у меня хранятся в одной БД. К сожалению, rrdtool не позволяет добавлять или удалять DS (data source) из существующей БД (разве что с помощью dump/restore), так что если в дальнейшем потребуется собирать дополнительную информацию, то ее придется хранить во второй БД. Интервал измерения как в mrtg - 300 секунд. Значения каждой DS хранятся в четырех RRA с использованием усреднения по 1, 6, 24 и 288 отсчетам соответственно. Размер RRA выбран достаточным для построения графиков за 2 дня, 2 недели, 2 месяца и 2 года соответственно. Информация извлекается с помощью протокола SNMP. Команду для создания БД можно взять в архиве. Имена DS совпадают с простыми дескрипторами объектов Squid MIB (некоторые пришлось "укоротить" из-за ограничения на длину имени DS в rrdtool):
cacheSysPageFaults
cacheSysNumReads
cacheCpuTime
cacheCpuUsage (не используется для построения графиков)
cacheNumObjCount
cacheCurrentUnlink
cacheCurrentUnusedF
cacheProtoClientHtt
cacheHttpHits
cacheHttpErrors
cacheHttpOutKb
cacheServerRequests
cacheServerErrors
cacheServerInKb
cacheCurrentSwap
cacheHttpAllSvcTime
cacheHttpMissSvc
cacheHttpHitSvcTime
cacheDnsSvcTime
cacheRequestHit (не используется для построения графиков)
cacheRequestByte (не используется для построения графиков)
cacheIpEntries
cacheIpRequests
cacheIpHits
cacheIpNegativeHits
cacheDnsRequests
cacheDnsReplies
Изменения запрашиваются и вносятся в БД каждые 5 минут с помощью скрипта squid_update.sh (вызывается из crontab).
Суточные, недельные, месячные и годовые графики генерируются скриптом squid_graph.sh соответственно раз в 5 минут, 30 минут, 2 часа и 1 день (вызывается из crontab). Скрипт имеет 2 параметра: начало отсчета (-2days, -14days, -50days и -20month) и суффикс имени PNG-файла (5min, 30min, 2h, 1d). Получаются следующие графики (за дизайн извиняйте - мне в детстве медведь наступил не только на ухо :):
squid_hr_???.png (эффективность кеширования в хитах и байтах)
squid_cpu_???.png (использование CPU)
squid_svctime_???.png (среднее время обслуживания запросов)
squid_traffic_???.png (траффик от серверов и к клиентам)
squid_request_???.png (число запросов в секунду)
squid_ipreqs_???.png (число запросов в секунду к DNS-кешу)
squid_ipentries_???.png (число объектов в DNS-кеше)
squid_dnsreqs_???.png (число запросов в секунду к DNS-серверу)
squid_pf_???.png (число обращений в секунду к файлу подкачки)
squid_reads_???.png (число чтений HTTP в секунду)
squid_unlinks_???.png (число удалений объектов из кеша в секунду)
squid_unusedfd_???.png (число используемых и свободных дескрипторов файлов)
squid_swapsize_???.png (используемое под кеш место на диске)
squid_objects_???.png (число объектов в дисковом кеше)
squid_errors_???.png (число ошибок в секунду)
Все 4 графика каждого типа объединяются в одну HTML страницу. Чтобы не писать 15 почти одинаковых страниц, используется SSI, а именно: сделан шаблон и 15 страниц типа (title - заголовок страницы, groupprefix - начало имени файла, к которому в шаблоне добавлются суффиксы вида "_5min.png"):
<!--#set var="title" value="Squid CPU Usage" -->
<!--#set var="groupprefix" value="squid_cpu" -->
<!--#include file="rrdtool_template.shtml" -->
Все страницы, посвященные мониторингу Squid, объединяются индексной страницей, содержащей 5-минутные графики всех типов и ссылки на соответствующие страницы.
В действительно, мониторится не только Squid, так что вызовы описанных выше скриптов включены в вызовы скриптов верхнего уровня, а ссылка на индексную страницу - в управляющую консоль.
4.23. Извлечение и удаление объектов из кеша
Утилита purge позволяет извлекать сохраненные объекты из кеша (с сохранением информации о структуре URL и самих файлах) или удалять их (как "правильные" объекты с помощью обращения к Squid методом PURGE, так и ошибочные файлы напрямую).
Сборка производится с помощью команды make (не надо читать про RCS в README!). Извлечение файлов MP3 из кеша (ограничитель шаблона - $ - ставить не надо, так как некоторые сервера добавляют всякий мусор в конце URI дабы избежать кеширования):
