Все ленты — последние статьи

Squid (кеширующий прокси для http): установка, настройка и использование

Назначение

 

Представляет собой 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 3.0-STABLE24 (переписано на C++, официально добавлен ICAP), Squid 2.7-STABLE8, Squid 2.6-STABLE23; готовится к выходу 3.1 (отличия 2.7.STABLE8 от 2.6.STABLE23, 2.6.STABLE23 от 2.6.STABLE16, 2.6.STABLE16 от 2.6.STABLE12, 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).

Установка

Полезные ключи ./configure (--help, squid -v)

  • --prefix=/usr/local/squid (куда инсталлировать файлы, также имеется множество дополнительных ключей для тонкой настройки расположения файлов)
  • --enable-async-io=число-нитей (подразумевает --with-aufs-threads=число-нитей, --with-pthreads, --enable-storeio=ufs,aufs)
  • --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 автоматически распознавать падение сервера)
  • --disable-wccpv2
  • --enable-delay-pools (управление ограничением трафика)
  • --enable-useragent-log (журнализовать заголовок Useragent)
  • --enable-referer-log (журнализовать заголовок Referer)
  • --enable-forward-log (поддержка директивы forward_log, в 2.6)
  • --enable-kill-parent-hack (помогает сделать shutdown чисто)
  • --enable-snmp (включить SNMP сервер для мониторинга)
  • --enable-arp-acl (поддержка ACL, основанных на ethernet MAC адресах)
  • --enable-cachemgr-hostname=имя-хоста (cachemgr.cgi будет по умолчанию натравлен на этот хост)
  • --enable-err-language=языки-для-сообщений-об-ошибках (по умолчанию — все)
  • --enable-default-err-language=язык-сообщений-об-ошибках (Russian-1251?)
  • --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)
  • --enable-linux-tproxy (поддержка Netfilter TPROXY)
  • --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-ntlm-fail-open (делать клиентам "поблажки")
    • --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)
  • --enable-follow-x-forwarded-for (отслеживать цепочку X-Forwarded-For, 2.6)
  • --with-large-files (журналы и пр.)
  • --with-maxfd=число-дескрипторов
  • --with-openssl= (в CentOS надо указать /usr/kerberos)

Ключи запуска squid

  • -a порт (TCP порт для входных HTTP запросов, 3128)
  • -d (отладка на stderr)
  • -f имя-файла-конфигурации
  • -h (help)
  • -k (послать команду работающему серверу, номер процесса из squid.pid?)
    • reconfigure (посылка сигнала HUP — разобрать заново файл конфигурации)
    • rotate (rotate журналы; сигнал USR1)
    • shutdown (сигнал TERM)
    • interrupt (shutdown без паузы; сигнал INT)
    • kill (даже не закрыв журналы; сигнал KILL)
    • 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 (более быстрое восстановление после сбоев)

Формат 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 требует аутентификации)
          • login=PASS (передавать имя/пароль пользователя вышестоящему прокси)
          • connect-timeout=
          • digest-url=URL
          • 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)
      • fqdncache_size 1024 (размер кеша fqdn — полных доменных имен)
      • 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) то (объект свежий)
        (объект старый)
        
        По умолчанию (я эти числа изрядно увеличиваю):
        1. refresh_pattern ^ftp: 1440 20% 10080
        2. refresh_pattern ^gopher: 1440 0% 1440
        3. 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 процентов объекта, то докачать)
      • read_ahead_gap 16 KB (размер буфера упреждающего чтения)
      • 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_log /usr/local/squid/logs/cache.log (журнал запусков процессов)
      • 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 (при включении запись в журнал буферизуется и слегка ускоряется)
    • error_directory /usr/local/squid/share/errors/English
    • 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_list_width 32 (ширина листинга ftp) — маловато
      • 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; очередь к DC не выдерживает более 10 обращений — squid падает
            • предлагается также использовать 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_cache_garbage_interval 1 hour (интервал сборки мусора)
      • 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, запросы с которых принимаются с аутентификацией
        # по ограниченному списку имён;
        acl authname src "/usr/local/squid/etc/authname.acl"
        # список допустимых имён пользователей (как WS2003, так и pre-2000; в кодировке cp1251 ;)
        # задаётся в файле names.acl с добавлением имени домена или имени компьютера
        acl password-name proxy_auth "/usr/local/squid/etc/names.acl"
        http_access allow authname password-name
        …
        
    • timeout's
      • 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 минут)
      • request_timeout 30 seconds (сколько разрешается ждать запроса после установления соединения, маловато)
      • persistent_request_timeout 1 minute (в 2.4)
      • 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")
      • srcdom_regex [-i] строка … (regex matching client name)
      • 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)
      • browser [-i] regexp (сопоставляется заголовок User-Agent)
      • referer_regex [-i] regexp (сопоставляется заголовок Referer)
      • ident username … (строка REQUIRED сопоставляется любому непустому слову)
      • ident_regex [-i] regexp
      • 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-адресов)
      • req_mime_type regexp (тип upload)
      • req_header имя-заголовка [-i] регулярное-выражение (сопоставляется указанный заголовок запроса)
      • rep_mime_type regexp (нельзя использовать в http_access)
      • rep_header имя-заголовка [-i] регулярное-выражение (сопоставляется указанный заголовок ответа)
      • 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 порту, по умолчанию — никто)
    • snmp_incoming_address 0.0.0.0
    • snmp_outgoing_address 0.0.0.0
  • разное
    • mime_table /usr/local/squid/etc/mime.conf (явно не хватает .class, .pl, .map, .ico, .bmp, .js, .css, .mid)
    • 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

Управление 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 (лично я не пробовал и другим не советую):

  • cachemgr.cgi в /usr/local/squid/cgi-bin
  • конфигурация Apache
    • ScriptAlias /Squid/cgi-bin/ /usr/local/squid/cgi-bin/
    • ограничение доступа по адресу хоста
       <Location /Squid/cgi-bin/cachemgr.cgi>
      order deny,allow
      deny from all
      allow 1.2.3.4
      </Location>
      
    • ограничение доступа по паролю
       <Location /Squid/cgi-bin/cachemgr.cgi>
      AuthUserFile /path/to/password/file
      AuthGroupFile /dev/null
      AuthName User/Password Required
      AuthType Basic
      require user cachemanager
      </Location>
      

Сколько надо оперативной памяти

Требования к памяти:

  • 72 байта на каждый объект
  • Disk buffers for reading and writing
  • Network I/O buffers
  • IP Cache contents
  • FQDN Cache contents
  • Netdb ICMP measurement database
  • 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) — единственный существенный способ

Алгоритмы замещения кеша (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 — растет.

Сравнение алгоритмов проводится в

Какие объекты кешируются

Кешируемость объектов в зависимости от кода возврата 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.

Справедливый дележ канала (delay pool)

Пул — набор групп ведер определенного класса. Группа ведер — часть пула, привязанная к хосту, сети или одно на всех. Ведро — ограниченная емкость, в которую с ограниченной скоростью вливается внешний трафик, и из которой он раздается клиенту. Если ведро заполняется полностью, то запросы к серверу останавливаются, если пустеет, то увеличиваются (а клиент ждет).

Определены 3 класса пулов:

  1. одно ведро на всех из этого класса
  2. одно общее ведро и 255 отдельных для каждого хоста из C-сетки
  3. 255 ведер для каждой сетки (класс B) и отдельное для каждого хоста

Пример конфигурации:

delay_pools 3 # 3 delay pools
delay_class 1 1 # pool 1 is class 1
delay_class 2 1 # pool 2 is class 1
delay_class 3 3 # pool 3 is class 3
delay_access 1 allow staff
delay_access 1 deny all
delay_access 2 allow students
delay_access 2 deny all
delay_access 3 allow college
delay_access 3 deny all
delay_parameters 1 640000/640000
delay_parameters 2 64000/64000
delay_parameters 3 64000/64000 32000/64000 6400/32000
# total_rest/total_max net_rest/net_max ind_rest/ind_max
где
total — на всех
net — на подсеть
ind — на отдельный адрес
rest — скорость заполнения (байт/сек)
max — объем ведра (байт)

Ограничение для модемных клиентов, чтобы squid не подкачивал файл пока клиент еще не считал предыдущую порцию.

acl clients src адреса
delay_pools 1
delay_class 1 2
delay_access 1 allow clients
delay_access 1 deny all
delay_parameters 1 -1/-1 8000/4000

Прижать любителей MP3:

acl multimedia urlpath_regex -i \.mp3$ \.mpeg$ \.avi$ \.mov$
delay_pools 1
delay_class 1 1
delay_access 1 allow multimedia
delay_access 1 deny all
delay_parameters 1 16000/64000

quick abort д.б. установлен маленьким чтобы объект не качался на полной скорости после отпадения клиента (нет клиента для запроса — нет ограничений).

Squid как transparent proxy (только http)

В процессе участвуют маршрутизатор, Linux и Squid:

  1. 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-сервер.
  2. ОС proxy-сервера должна принимать эти пакеты, как родные, и перенаправлять к squid
    • linux 2.2.
      1. конфигурация ядра:
        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 # необязательно, но может ускорить обработку пакетов
      2. при загрузке включать 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 указывается во время конфигурации
      3. 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
        • ipchains -A input -p TCP -d 0/0 www -j REDIRECT 3128
        • дополнительные правила для firewall и др.
  3. squid д.б. скомпилирован так, чтобы он принимал эти пакеты, как родные.
    • linux 2.2 и squid 2.2. Происходит само собой.
  4. 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: запрос приходит на прокси-сервер, который от своего имени (уже изнутри) лезет куда не надо.

Формат журналов

Формат access.log (запись делается, когда клиент закрывает socket; для наших 300 тысяч запросов в день получается 60 MB в день!):

  1. timestamp (unix time in ms)
  2. elapsed (ms), если клиент "ушел, не попрощавшись", то здесь будет время потраченное на обнаружение данного факта, а не время реального обслуживания (иногда более получаса на маленький файл)
  3. client IP address
  4. type/HTTP reply code, где type:
    • TCP_HIT (верная копия объекта нашлась в кеше)
    • TCP_MEM_HIT
    • TCP_NEGATIVE_HIT
    • TCP_MISS (запрашиваемый объект не был в кеше)
    • TCP_EXPIRED (объект был в кеше, но старый)
    • TCP_CLIENT_REFRESH (клиент запросил reload — no-cache pragma)
    • 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_…
  5. size (bytes to client)
  6. method (GET, POST, …)
  7. URL
  8. ident ("-", если недоступен)
  9. 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 (объект был запрошен с оригинального сервера)
  10. тип содержимого (MIME тип/подтип)

Формат store.log:

  1. time (unix format with ms)
  2. action
    • RELEASE (удален из кеша)
    • SWAPOUT (сохранен на диск)
    • SWAPIN (был на диске, загружен в память)
  3. HTTP reply code
  4. HTTP Date: reply header
  5. HTTP Last-Modified: reply header
  6. HTTP Expires: reply header
  7. HTTP Content-Type: reply header
  8. HTTP Content-Length: reply header
  9. реально полученное число байт (если не совпадает с предыдущим числом, объект не хранится)
  10. HTTP метод (GET, POST, …)
  11. ключ доступа (обычно 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 ГБ, так что журналы надо регулярно чистить.

Обработка статистики

В комплекте поставки идут 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

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 МБ на месяц), т.к. отчёты создаются по запросу.

Установка:

  • создать каталог внутри подходящего сайта
  • развернуть архив в него
  • добавить в lightparser.pl свёртку vkontakte.ru, odnoklassniki.ru, youtube.com, ifolder.ru, rutube.ru, auto.ru, ganjawars.ru, maps.yandex.ru, loadup.ru, webfile.ru
  • отредактировать lightsquid.cfg
    • $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
    

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 (символ '#' — начало комментария, каждый параметр на отдельной строке):

  • language Russian_UTF-8 # language Russian_koi8
  • access_log имя-файла (журнал access.log)
  • graphs yes
  • graph_days_bytes_bar_color blue|green|yellow|orange|brown|red
  • прочие настройки оформления графики (шрифт, цвет, размер, текст)
  • #password none
  • temporary_dir /tmp
  • output_dir /var/www/sarg/ONE-SHOT
  • output_email email-адрес (отчёт посылается по e-mail вместо создания графиков)
  • resolve_ip yes (преобразовывать IP адреса в имена)
  • user_ip yes (использовать в отчёте IP адреса вместо идентификаторов пользователей)
  • topuser_sort_field {USER | CONNECT | BYTES | TIME} {reverse | normal} (тип сортировки отчёта TopUser)
  • user_sort_field {USER | CONNECT | BYTES | TIME} {reverse | normal} (тип сортировки отчёта User)
  • exclude_users {имя-файла | none | indexonly} (файл содержит имена пользователей, которых не надо включать в отчёт)
  • exclude_hosts {имя-файла | none | indexonly} (файл содержит адреса хостов и сетей, которые не надо включать в отчёт: например, 192.168.10.0)
  • useragent_log none (отчёт по UserAgent)
  • date_format {e | u } (e — dd/mm/yy, u — mm/dd/yy)
  • per_user_limit имя-файла число-МБ (записывать в файл идентификаторы пользователей, превысивших указанный лимит)
  • 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 имя-файла (сохранить отчёт в виде файла для дальнейшей обработки)
  • datafile_delimiter ";"
  • datafile_fields user;date;time;url;connect;bytes;in_cache;out_cache;elapsed
  • datafile_url {ip | name}
  • weekdays 0-6 (какие дни недели помещать в отчёт)
  • hours 0-23 (какие часы помещать в отчёт)
  • dansguardian* и squidguard*
  • show_sarg_info yes (выводить сылку на сайт автора в каждом отчёте)
  • show_sarg_logo yes
  • parsed_output_log none (имя каталога для сохранения полуобработанных данных)
  • parsed_output_log_compress /bin/gzip
  • displayed_values { bytes | abbreviation}
  • authfail_report_limit строк (10)
  • denied_report_limit строк (10)
  • siteusers_report_limit строк (0)
  • squidguard_report_limit строк (10)
  • dansguardian_report_limit строк (10)
  • user_report_limit строк (10)
  • www_document_root, block_it — для общения со squidGuard и ACL
  • external_css_file /var/www/sarg/sarg.css
  • download_suffix "zip,arj,bzip,gz,ace,doc,iso,adt,bin,cab,com,dot,drv$,lha,lzh,mdb,mso,ppt,rtf,src,shs,sys,exe,dll,mp3,avi,mpg,mpeg"
  • ulimit максимальное-число-открытых-файлов ("none" для отключения ulimit)
  • ntlm_user_format { username | domainname+username }

Ключи запуска sarg:

  • -a имя-или-IP-адрес (ограничить отчёт указанным клиентом)
  • -b имя-файла (отчёт по UserAgent)
  • -c имя-файла (список исключений)
  • -d дд/мм/гггг-дд/мм/гггг (ограничить интервалом дат)
  • -e email-адрес (кому послать отчёт)
  • -e stdout (выдать отчёт на стандартный вывод)
  • -f имя-конфигурационного-файла
  • -g формат-даты-в-отчёте (e — dd/mm/yy, u — mm/dd/yy)
  • -i (формировать отчёт по пользователям и IP адресам)
  • -l имя-журнала-squid (можно указывать несколько раз, но в порядке возрастания даты; понимает сжатые файлы, но разжимает их в файл и забывает удалить)
  • -n (преобразовывать IP адреса в имена)
  • -o имя-каталога (куда записывать отчёты)
  • -p (использовать в отчёте IP адреса вместо идентификаторов пользователей)
  • -s имя-сайта (ограничить отчёт указанным сайтом)
  • -t ЧЧ:ММ:СС (ограничить отчёт по времени суток)
  • -u имя-пользователя (ограничить отчёт указанным пользователем)
  • -w имя-католога-для-временных-файлов
  • -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 \
-d $(date --date "1 month ago" +%d/%m/%Y)-$(date --date "1 day ago" +%d/%m/%Y) \
[-a IP-адрес] -x -z -l /squid/logs/access.log.5.gz …
где /etc/sarg/sarg.top10user.conf содержит
graphs no
user_ip yes
topuser_sort_field BYTES reverse
user_sort_field BYTES reverse
records_without_userid ip
report_type topusers users_sites
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 10
displayed_values bytes
user_report_limit 10
ulimit 60000

Ссылки:

redirector, как средство оптимизации

redirector — внешняя программа (небуфферизованный в/в), в цикле читает с stdin URL и пишет на stdout преобразованный URL (или пустую строку, если нет преобразований). Преобразование происходит после проверки ACL, но до проверки на присутствие в кеше. В 2.6 заменён на url_rewrite_program. Формат входной строки (поля, разделенные пробелами):

  1. URL
  2. ip-address/fqdn (если fqdn нет, то "-")
  3. ident ("-", если нет)
  4. method (GET, POST, …)
  5. urlgroup (в 2.6)

В качестве примера использования редиректора для уменьшения трафика в поставке приводится редиректор, производящий нормализацию URL (приведение к стандартному виду), что увеличивает вероятность попадания в кеш. А также редиректор преобразующий запросы на загрузку всяких там IE, Netscape и пр. с различных зеркал в запросы к локальному www-серверу (автор клянется, что это дает 15%). См. также про борьбу с баннерами.

Примеры redirectors:

Борьба с баннерами

Только не будем спорить о морали :) Но и в transparent режиме этого делать не надо. Поставьте себе локальный прокси и радуйтесь. Кстати, теми же методами можно бороться со счетчиками и порно.

Превращение банеров-картинок в рваные прямоугольники:

  1. Насобирать "вредителей" (в виде регулярных выражений)
  2. Заводим файлы в /usr/local/squid/etc:
    • banners_path_regex — по одному регулярному выражению на строку
    • banners_regex — по одному регулярному выражению на строку
    • banners_exclusion (это строки, трактуемые в предыдущих файлах как баннеры, но их лучше не трогать — JavaScript всякие)
  3. В squid.conf
    acl banners_path_regex urlpath_regex "/usr/local/squid/etc/banners_path_regex"
    acl banners_regex url_regex "/usr/local/squid/etc/banners_regex"
    acl banners_exclusion url_regex "/usr/local/squid/etc/banners_exclusion"
    http_access deny banners_path_regex !banners_exclusion
    http_access deny banners_regex !banners_exclusion
    

Замена рекламных банеров на пустое место. Если рваные прямоугольники оскорбляют эстетические чувства. Предполагается, что в исходных страницах заданы width и height, иначе страница поплывет (можно заменять банеры на картинки соответствующего размера, но это большой труд).

  1. Насобирать "вредителей" (в виде регулярных выражений)
  2. На своем http-сервере завести "заменитель" рекламных картинок void.gif
  3. Настраиваем redirector в squid.conf (если он уже используется, то добавить к старому; м.б. еще настроить redirector_access):
    redirect_program /usr/local/squid/bin/banners.pl
  4. banners.pl (perl выбран для простоты демонстрации):
     #!/usr/bin/perl (или где perl живет)
    $|=1;
    while (<>) {
    s@регулярное-выражение@http://www.nospam.org/nospam.gif@;
    print;}
    

К сожалению, использование "http_access deny" для блокировки JavaScript программ не получается (броузер не показывает страницу совсем). Поэтому приходится заменять реальный скрипт через redirect (см. выше) на что-нибудь безобидное (и каждый случай обрабатывать отдельно :(. Например, если исходный скрипт открывал окно с рекламой (<script src=…>), то вместо него подсовываем

 <html><head>
<script language="JavaScript"><!-- window.close(); //--></script>
</head><body></body></html>

вместо tx3 (если он встроен страницу с помощью SSI, то не поможет, да и зачем тогда его резать?):

 document.write("&nbsp;");

Ссылки:

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:

redirector_bypass on
redirect_program /usr/bin/squidGuard -c /etc/squid/squidguard-blacklists.conf
acl squidGuard …
redirector_access allow squidGuard

Опции squidGuard:

  • -d (вывод ошибок на stderr)
  • -c имя-файла-настроек
  • -t yyyy-mm-ddTHH:MM:SS (?)
  • -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 имя-файла

Описание группы клиентов может иметь условие по времени:

source имя-группы-клиентов [within|outside имя-интервала-времени] {
…
} else {
…
}

Описание группы URL (имя типа: destination) состоит из перечня URL в следующих форматах (спецификации любых типов объединяются; группы могут пересекаться — приоритет имеет первая в директиве pass; в списках необходимо использовать только строчные буквы; включение имени домена включает все хосты во всех поддоменах этого домена; при включении URL в список из него необходимо удалить "http://www.", ":8080" и завершающее имя или "/"; в строке списка URL можно в качестве второго поля указать новый URL для перенаправления (это работает быстрее, чем rewrite); использование регулярных выражений сильно замедляет работу; имя журнала берётся относительно logdir):

  • domainlist имя-файла
  • urllist имя-файла
  • expressionlist имя-файла
  • redirect [302:]URL
  • logfile имя-файла

Описание группы URL может иметь условие по времени:

destination имя-группы [within|outside имя-интервала-времени] {
…
} else {
…
}

Описание группы правил переадресации (имя типа: rewrite) состоит из перечня правил замены URL в следующих форматах

  • s@исходное-регулярное-выражение@результат@[irR]
    • i — нечувствительность к регистру
    • r — переадресация будет видима клиенту (через код HTTP 302, Moved Temporarily)
    • R — переадресация будет видима клиенту (через код HTTP 301, Moved Permanently)
  • logfile имя-файла

Описание группы правил переадресации может иметь условие по времени:

rewrite имя-группы [within|outside имя-интервала-времени] {
…
} else {
…
}

Описание группы ACL (ровно одна непоименованная группа) содержит для каждой группы пользователей правила поведения фильтра в формате

имя-группы-клиентов [within|outside имя-интервала-времени] {
pass [!]имя-группы-URL …
[rewrite имя-группы-переадресации]
[redirect [301:|302:]новый-адрес]
} else {
…
}

Имеется специальная группа пользователей default, в которую входят пользователи, не вошедшие ни в одну из остальных групп или вошедшие в группу, не имеющую ACL; здесь же задаются правило переадресации для групп клиентов, не имеющих собственных правил переадресации.

Имеется следующие встроенные группы URL

  • any — соответствует любому URL (эквивалент ".*")
  • all — синоним any
  • none — эквивалент !any
  • in-addr — "^[^:/]+://[0-9]\{1,3\}\.[0-9]\{1,3\}\.[0-9]\{1,3\}\.[0-9]\{1,3\}($|[:/])"

Директива redirect (если URL блокируется фильтром, то какой-нибудь redirect должен быть обязательно определён) позволяет производить подстановку переменных (в поставке имеется шаблон squidGuard.cgi для создания красивых страниц с объяснением):

  • %a — IP адрес клиента
  • %n — имя хоста клиента
  • %i — имя пользователя согласно ident
  • %s — имя группы клиентов
  • %t — имя группы URL
  • %u — URL
  • %p — REQUEST_URI

Первый же сайт, на который я зашёл (rambler.ru), оказался в списках ads и adult.

Приемы конфигурации

Простейшие случаи иерархии. Основной 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

Использование дополнительного канала для доступа в Интернет

Имеем маршрутизатор (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 из адресного пространства второго провайдера
  • никакого кеширования

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):

  1. cacheSystem
    1. cacheSysVMsize (объем кеша в оперативной памяти, в KB)
    2. cacheSysStorage (объем кеша на диске, в KB)
    3. cacheUptime (в 1/100 секунды)
  2. cacheConfig
    1. cacheAdmin (e-mail)
    2. cacheSoftware
    3. cacheVersionId
    4. cacheLoggingFacility
    5. cacheStorageConfig
      1. cacheMemMaxSize (значение cache_mem в MB)
      2. cacheSwapMaxSize (значение cache_dir в MB)
      3. cacheSwapHighWM
      4. cacheSwapLowWM
  3. cachePerf
    1. cacheSysPerf
      1. cacheSysPageFaults (потребовавших физического в/в)
      2. cacheSysNumReads (число команд ввода для HTTP)
      3. cacheMemUsage (в KB, у меня -1 :)
      4. cacheCpuTime (секунд)
      5. cacheCpuUsage (%, у меня всегда 3% :)
      6. cacheMaxResSize (в KB, у меня 0 :)
      7. cacheNumObjCount (число объектов в кеше)
      8. cacheCurrentLRUExpiration
      9. cacheCurrentUnlinkRequests (число запросов к unlinkd)
      10. cacheCurrentUnusedFDescrCnt (свободных дескрипторов файлов)
      11. cacheCurrentResFileDescrCnt (зарезервированных fd)
    2. cacheProtoStats
      1. cacheProtoAggregateStats
        1. cacheProtoClientHttpRequests
        2. cacheHttpHits
        3. cacheHttpErrors
        4. cacheHttpInKb (от клиентов)
        5. cacheHttpOutKb (клиентам)
        6. cacheIcpPktsSent
        7. cacheIcpPktsRecv
        8. cacheIcpKbSent
        9. cacheIcpKbRecv
        10. cacheServerRequests (к HTTP серверам и родителям)
        11. cacheServerErrors
        12. cacheServerInKb (от серверов)
        13. cacheServerOutKb
        14. cacheCurrentSwapSize (в KB)
        15. cacheClients (число клиентских кешей)
      2. cacheMedianSvcTable (усредненная статистика за интервал времени, указанный в cacheMedianTime)
        1. cacheMedianSvcEntry (индекс доступа к экземпляру: cacheMedianTime)
          1. cacheMedianTime (интервал времени усреднения: 1, 5 и 60 минут)
          2. cacheHttpAllSvcTime (среднее время обслуживания всех запросов, милисекунд)
          3. cacheHttpMissSvcTime (среднее время обслуживание запросов, отсутствующих в кеш или устаревших)
          4. cacheHttpNmSvcTime (HTTP near miss service time)
          5. cacheHttpHitSvcTime (среднее время обслуживание запросов, найденных в кеш; по-моему, считается неправильно: TCP_HIT для локального хоста без обращения к серверу картинки в 8 кБ иногда требует больше получаса)
          6. cacheIcpQuerySvcTime
          7. cacheIcpReplySvcTime
          8. cacheDnsSvcTime (среднее время обслуживания DNS)
          9. cacheRequestHitRatio (%, можно вычислить по cacheProtoClientHttpRequests и cacheServerRequests)
          10. cacheRequestByteRatio (%, можно вычислить по cacheServerInKb и cacheHttpOutKb)
  4. cacheNetwork
    1. cacheIpCache (статистика кеша IP: получение IP адреса по имени и доступность сервера)
      1. cacheIpEntries (элементов в кеше IP)
      2. cacheIpRequests
      3. cacheIpHits
      4. cacheIpPendingHits
      5. cacheIpNegativeHits
      6. cacheIpMisses
      7. cacheBlockingGetHostByName
      8. cacheAttemptReleaseLckEntries
    2. cacheFqdnCache (определение полного имени по простому)
      1. cacheFqdnEntries (у меня их всего 2)
      2. cacheFqdnRequests
      3. cacheFqdnHits
      4. cacheFqdnPendingHits
      5. cacheFqdnNegativeHits
      6. cacheFqdnMisses
      7. cacheBlockingGetHostByAddr
    3. cacheDns
      1. cacheDnsRequests
      2. cacheDnsReplies
      3. cacheDnsNumberServers
  5. cacheMesh (таблицы соседей и клиентов, их состояние и статистика, у меня не работает, да и в описании ошибки)

Мониторинг с помощью 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, так что вызовы описанных выше скриптов включены в вызовы скриптов верхнего уровня, а ссылка на индексную страницу — в управляющую консоль.

Извлечение и удаление объектов из кеша

Утилита (была на http://www.cache.dfn.de/DFN-Cache/Development/Purge/) purge позволяет извлекать сохраненные объекты из кеша (с сохранением информации о структуре URL и самих файлах) или удалять их (как "правильные" объекты с помощью обращения к Squid методом PURGE, так и ошибочные файлы напрямую).

Сборка производится с помощью команды make (не надо читать про RCS в README!). Извлечение файлов MP3 из кеша (ограничитель шаблона — $ — ставить не надо, так как некоторые сервера добавляют всякий мусор в конце URI дабы избежать кеширования):

./purge -n -a -s -C /tmp/MP3s/ -e '\.mp3|\.wav'|fgrep -v 'strange file'