Squid-Howto: Unterschied zwischen den Versionen

Aus Xinux Wiki
Zur Navigation springen Zur Suche springen
 
(12 dazwischenliegende Versionen von 5 Benutzern werden nicht angezeigt)
Zeile 1: Zeile 1:
=Installion=
+
=Installation=
==Ubuntu==
+
*apt install squid
apt-get install squid
+
=Erste Schritte=
==Arch==
 
pacman -S squid
 
=Firststeps=
 
 
==Configdir==
 
==Configdir==
cd /etc/squid
+
*cd /etc/squid
==save default==
+
==Default Konfiguration sichern==
cp squid.conf squid.conf.org
+
*cp squid.conf squid.conf.org
==bereinige config von kommentaren==
+
==Kommentare aus der squid.conf entfernen==
grep "^[^#]" squid.conf.org > squid.conf
+
*grep "^[^#]" squid.conf.org > squid.conf
==bereinigte squid.conf==
+
==Bereinigte squid.conf==
 
<pre>
 
<pre>
 
acl localnet src 10.0.0.0/8    # RFC1918 possible internal network
 
acl localnet src 10.0.0.0/8    # RFC1918 possible internal network
Zeile 48: Zeile 45:
 
====Filter anlegen====
 
====Filter anlegen====
 
  acl localnet src 192.168.0.0/16  
 
  acl localnet src 192.168.0.0/16  
*acl Schlüsselwort
+
:acl Schlüsselwort
*localnet Bezeichner (beliebig)
+
:localnet Bezeichner (beliebig)
*src filterkriterium (es gibt viele)
+
:src filterkriterium (es gibt viele)
*192.168.0.0/16 Bereich (Variable)
+
:192.168.0.0/16 Bereich (Variable)
 
====Anwenden der Filter====
 
====Anwenden der Filter====
 
  http_access allow localnet
 
  http_access allow localnet
*http_access Schlüsselwort
+
http_access Schlüsselwort
*allow (erlauben oder verbieten (deny)
+
:allow (erlauben) oder deny (verbieten)
*localnet anzuwendeter Filter
+
localnet anzuwendeter Filter
 
====Port auf Squid lauscht====
 
====Port auf Squid lauscht====
 
  http_port 3128
 
  http_port 3128
Zeile 62: Zeile 59:
 
====Coredumpdir====
 
====Coredumpdir====
 
  coredump_dir /var/cache/squid
 
  coredump_dir /var/cache/squid
*wenn squid abstürzt wird dort ein Abbild geschrieben
+
:wenn squid abstürzt wird dort ein Abbild geschrieben
 
====Refresh Pattern====
 
====Refresh Pattern====
Schlüsselwort    Pattern        Min    Prozent Max             
+
:Schlüsselwort    Pattern        Min    Prozent Max             
 
  refresh_pattern ^gopher:        1440    0%      1440
 
  refresh_pattern ^gopher:        1440    0%      1440
 
  refresh_pattern -i (/cgi-bin/|\?) 0    0%      0
 
  refresh_pattern -i (/cgi-bin/|\?) 0    0%      0
 
  refresh_pattern .              0      20%    4320
 
  refresh_pattern .              0      20%    4320
  
*Hier kann der Refresh-Algorithmus von squid für die eigenen Bedürfnisse optimiert werden.
+
:Hier kann der Refresh-Algorithmus von squid für die eigenen Bedürfnisse optimiert werden.
*MIN ist die Zeit in Minuten,die ein Objekt ohne explizite Ablaufzeit als Aktuell betrachtet wird. Der ermpfohlene Wert ist 0, jeder höhere Wert könnte dazu führen, dass dynmaische Anwendungen irrtümlich gecachtt werden, wenn der Webdesigner keine entsprechenden Gegenaktionen getroffen hat.
+
:MIN ist die Zeit in Minuten,die ein Objekt ohne explizite Ablaufzeit als Aktuell betrachtet wird. Der ermpfohlene Wert ist 0, jeder höhere Wert könnte dazu führen, dass dynmaische Anwendungen irrtümlich gecachtt werden, wenn der Webdesigner keine entsprechenden Gegenaktionen getroffen hat.
*PROZENT ist der Prozentsatz eines Objektalters (Zeit seit der letzten Modifikation) wo ein Objekt ohne explizite Ablaufzeit als aktuell betrachtet wird.
+
:PROZENT ist der Prozentsatz eines Objektalters (Zeit seit der letzten Modifikation) wo ein Objekt ohne explizite Ablaufzeit als aktuell betrachtet wird.
*MAX ist ein oberes Limit wie lange Objekte ohne explizite Ablaufzeiten als aktuell betrachtet werden.
+
:MAX ist ein oberes Limit wie lange Objekte ohne explizite Ablaufzeiten als aktuell betrachtet werden.
  
 
=First run=
 
=First run=
 
==läuft squid?==
 
==läuft squid?==
netstat -lntp | grep 3128
+
*netstat -lntp | grep 3128
 
==starten im Vordergrund==
 
==starten im Vordergrund==
squid -DNX
+
*squid -DNX
 
==starten im Hintergrund==
 
==starten im Hintergrund==
===Ubuntu===
+
* systemctl start squid
service squid start
 
===Arch===
 
systemctl start squid
 
 
==Kontrolle==
 
==Kontrolle==
tail -f /var/log/squid/access.log  
+
*tail -f /var/log/squid/access.log  
 
  1415788926.412  33247 192.168.244.1 TCP_MISS/200 3776 CONNECT aur.archlinux.org:443 - HIER_DIRECT/5.9.250.164 -
 
  1415788926.412  33247 192.168.244.1 TCP_MISS/200 3776 CONNECT aur.archlinux.org:443 - HIER_DIRECT/5.9.250.164 -
 
  1415788926.424  33266 192.168.244.1 TCP_MISS/200 3822 CONNECT aur.archlinux.org:443 - HIER_DIRECT/5.9.250.164 -
 
  1415788926.424  33266 192.168.244.1 TCP_MISS/200 3822 CONNECT aur.archlinux.org:443 - HIER_DIRECT/5.9.250.164 -
Zeile 94: Zeile 88:
 
==Erstellen einer Passwort Datei==
 
==Erstellen einer Passwort Datei==
 
   
 
   
htpasswd -c /etc/squid/passwordfile username
+
*htpasswd -c /etc/squid/passwordfile username
  
 
Syntax:
 
Syntax:
Zeile 109: Zeile 103:
  
 
<pre>
 
<pre>
 
 
auth_param basic program /usr/lib/squid/basic_ncsa_auth /etc/squid/passwd
 
auth_param basic program /usr/lib/squid/basic_ncsa_auth /etc/squid/passwd
 
auth_param basic children 20 startup=0 idle=1
 
auth_param basic children 20 startup=0 idle=1
 
auth_param basic concurrency 0
 
auth_param basic concurrency 0
auth_param basic credentialsttl 500
+
auth_param basic credentialsttl 500 seconds
 
auth_param basic realm xinux proxy server
 
auth_param basic realm xinux proxy server
 
auth_param basic casesensitive off
 
auth_param basic casesensitive off
 +
 +
acl ncsa_users proxy_auth REQUIRED
 +
 +
http_access allow ncsa_users
  
 
</pre>
 
</pre>
Zeile 130: Zeile 127:
 
*realm: Name des Bereichs für den der Proxy zuständig ist. Kann beliebig gewählt werden.
 
*realm: Name des Bereichs für den der Proxy zuständig ist. Kann beliebig gewählt werden.
 
*casesensitive: Legt fest ob der BENUTZERname case-sensitiv sein soll
 
*casesensitive: Legt fest ob der BENUTZERname case-sensitiv sein soll
 +
 +
=Limitierungen=
 +
==Problem==
 +
*Bei der Standard Konfiguration kann unter hoher Belastung folgender Fehler auftreten
 +
"WARNING! Your cache is running out of file descriptors"
 +
==Lösung==
 +
*in der limits.conf
 +
*folgende Zeile hinzufügen
 +
/etc/security/limits.conf
 +
*    soft    nofile          40000
 +
*    hard    nofile          40000
 +
 +
*in common-session folgende Zeile hinzufügen
 +
session required pam_limits.so
 +
 +
*nach einem erneuten einloggen sollte man mit
 +
ulimit -n
 +
40000
 +
*den erhöhten wert sehen
  
 
=Beispielkonzept=
 
=Beispielkonzept=
 
Bestimmte Rechner dürfen alles alle Anderen dürfen nur auf bestimmte Webseiten.
 
Bestimmte Rechner dürfen alles alle Anderen dürfen nur auf bestimmte Webseiten.
  
  acl access-to-all src "/etc/squid/access-to-all.txt"
+
  acl teamleitung src "/etc/squid/teamleitung.txt"
  acl connect-from-all url_regex  "/etc/squid/connect-from-all.txt"
+
  acl badsites url_regex  "/etc/squid/badsites.txt"
  
  http_access allow access-to-all
+
  http_access allow teamleitung
  http_access allow connect-from-all
+
  http_access deny badsites
  
*cat access-to-all.txt  
+
*cat teamleitung.txt  
 
  192.168.244.1
 
  192.168.244.1
 
  192.168.244.71
 
  192.168.244.71
  
 
*cat connect-from-all.txt  
 
*cat connect-from-all.txt  
  http://www.xinux.de
+
  bild.de
  http://www.heise.de
+
  sex
 +
www.faz.net

Aktuelle Version vom 20. März 2025, 16:10 Uhr

Installation

  • apt install squid

Erste Schritte

Configdir

  • cd /etc/squid

Default Konfiguration sichern

  • cp squid.conf squid.conf.org

Kommentare aus der squid.conf entfernen

  • grep "^[^#]" squid.conf.org > squid.conf

Bereinigte squid.conf

acl localnet src 10.0.0.0/8     # RFC1918 possible internal network
acl localnet src 172.16.0.0/12  # RFC1918 possible internal network
acl localnet src 192.168.0.0/16 # RFC1918 possible internal network
acl localnet src fc00::/7       # RFC 4193 local private network range
acl localnet src fe80::/10      # RFC 4291 link-local (directly plugged) machines
acl SSL_ports port 443
acl Safe_ports port 80          # http
acl Safe_ports port 21          # ftp
acl Safe_ports port 443         # https
acl Safe_ports port 70          # gopher
acl Safe_ports port 210         # wais
acl Safe_ports port 1025-65535  # unregistered ports
acl Safe_ports port 280         # http-mgmt
acl Safe_ports port 488         # gss-http
acl Safe_ports port 591         # filemaker
acl Safe_ports port 777         # multiling http
acl CONNECT method CONNECT
http_access deny !Safe_ports
http_access deny CONNECT !SSL_ports
http_access allow localhost manager
http_access deny manager
http_access allow localnet
http_access allow localhost
http_access deny all
http_port 3128
coredump_dir /var/cache/squid
refresh_pattern ^ftp:           1440    20%     10080
refresh_pattern ^gopher:        1440    0%      1440
refresh_pattern -i (/cgi-bin/|\?) 0     0%      0
refresh_pattern .               0       20%     4320

Konfigurationseinstellungen

Grundlegende Direktiven

Filter anlegen

acl localnet src 192.168.0.0/16 
acl Schlüsselwort
localnet Bezeichner (beliebig)
src filterkriterium (es gibt viele)
192.168.0.0/16 Bereich (Variable)

Anwenden der Filter

http_access allow localnet
http_access Schlüsselwort
allow (erlauben) oder deny (verbieten)
localnet anzuwendeter Filter

Port auf Squid lauscht

http_port 3128

Coredumpdir

coredump_dir /var/cache/squid
wenn squid abstürzt wird dort ein Abbild geschrieben

Refresh Pattern

Schlüsselwort Pattern Min Prozent Max
refresh_pattern ^gopher:        1440    0%      1440
refresh_pattern -i (/cgi-bin/|\?) 0     0%      0
refresh_pattern .               0       20%     4320
Hier kann der Refresh-Algorithmus von squid für die eigenen Bedürfnisse optimiert werden.
MIN ist die Zeit in Minuten,die ein Objekt ohne explizite Ablaufzeit als Aktuell betrachtet wird. Der ermpfohlene Wert ist 0, jeder höhere Wert könnte dazu führen, dass dynmaische Anwendungen irrtümlich gecachtt werden, wenn der Webdesigner keine entsprechenden Gegenaktionen getroffen hat.
PROZENT ist der Prozentsatz eines Objektalters (Zeit seit der letzten Modifikation) wo ein Objekt ohne explizite Ablaufzeit als aktuell betrachtet wird.
MAX ist ein oberes Limit wie lange Objekte ohne explizite Ablaufzeiten als aktuell betrachtet werden.

First run

läuft squid?

  • netstat -lntp | grep 3128

starten im Vordergrund

  • squid -DNX

starten im Hintergrund

  • systemctl start squid

Kontrolle

  • tail -f /var/log/squid/access.log
1415788926.412  33247 192.168.244.1 TCP_MISS/200 3776 CONNECT aur.archlinux.org:443 - HIER_DIRECT/5.9.250.164 -
1415788926.424  33266 192.168.244.1 TCP_MISS/200 3822 CONNECT aur.archlinux.org:443 - HIER_DIRECT/5.9.250.164 -

Authentifizierung erzwingen

Zur Vermeidung von ungewollten Zugriffen lässt sich in Squid auch eine Authetifizierung erzwingen

Erstellen einer Passwort Datei

  • htpasswd -c /etc/squid/passwordfile username

Syntax:

  • htpasswd: Programmname
  • -c: Create new passwordfile, also neue Passwortdatei erstellen
  • passwordfile: Passwortdatei mit beliebigem Namen. Auch der Ort kann beliebig gewählt werden
  • username: Name eines Benutzers (beliebig)

Nach Bestätigen des Befehls wird htpasswd nach einem Passwort für den Benutzer verlangen. Dies kann ebenfalls beliebig gewählt werden.

Änderungen an der squid.conf

Folgende Einträge werden am Anfang der squid.conf eingefügt:

auth_param basic program /usr/lib/squid/basic_ncsa_auth /etc/squid/passwd
auth_param basic children 20 startup=0 idle=1
auth_param basic concurrency 0
auth_param basic credentialsttl 500 seconds
auth_param basic realm xinux proxy server
auth_param basic casesensitive off

acl ncsa_users proxy_auth REQUIRED

http_access allow ncsa_users

Syntax:

  • auth_param: Definiert die Parameter für die Authentifizierung
  • basic: Teilt squid mit, dass es sich um grundsätzliche Einstellungen handelt, die zur Anwendung kommen wenn keine anderen verfügbar sind. Weitere Optionen siehe squid Manual
  • program: Es wird ein externes Programm zur Authentifizierung eingesetzt
  • /usr/lib/squid/basic_ncsa_auth: Hier befindet sich das Programm
  • /etc/squid/passwd: Dies ist die Passwortdatei
  • children: Wieviele Authentifikationsprozesse Squid maximal starten soll
  • concurrency: Wieviele Anfragen gleichzeitig bearbeitet werden dürfen
  • credentialsttl: Wie lange die Anmeldedaten gültig sein sollen
  • realm: Name des Bereichs für den der Proxy zuständig ist. Kann beliebig gewählt werden.
  • casesensitive: Legt fest ob der BENUTZERname case-sensitiv sein soll

Limitierungen

Problem

  • Bei der Standard Konfiguration kann unter hoher Belastung folgender Fehler auftreten
"WARNING! Your cache is running out of file descriptors"

Lösung

  • in der limits.conf
  • folgende Zeile hinzufügen
/etc/security/limits.conf
*     soft    nofile          40000
*     hard    nofile          40000
  • in common-session folgende Zeile hinzufügen
session required pam_limits.so
  • nach einem erneuten einloggen sollte man mit
ulimit -n
40000
  • den erhöhten wert sehen

Beispielkonzept

Bestimmte Rechner dürfen alles alle Anderen dürfen nur auf bestimmte Webseiten.

acl teamleitung src "/etc/squid/teamleitung.txt"
acl badsites url_regex  "/etc/squid/badsites.txt"
http_access allow teamleitung
http_access deny badsites
  • cat teamleitung.txt
192.168.244.1
192.168.244.71
  • cat connect-from-all.txt
bild.de
sex
www.faz.net