Squid 2.7 for Windows

Native port of Squid 2.7, with some Windows service enhancement.
Full MinGW and Cygwin support is available in the standard Squid distribution.

Current features:
- Based on latest Squid 2.7 STABLE release
- Run as a native Windows Service
- Currently supported build environments:
  - Microsoft Visual C++ 6.0 SP6
  - MSYS + MinGW
  - Cygwin
- Multiple Squid service instances are allowed
- Full Command line support when running as a service
- Automatic Service restart after Squid failure on Windows 2000/XP/2003
- Use PSAPI.DLL for full getrusage() emulation
- Internal DNS looks in registry for configured DNS, resolv.conf no more needed
- Multithreaded support for standard Squid external helpers or redirectors (pinger, unlinkd, dnsserver)
- All squid -k switches (check, debug, interrupt, kill, parse, reconfigure, rotate, shutdown) works
- Basic, NTLM, Negotiate and Digest Authentication schema
- Native Windows Basic, Negotiate and NTLM Authenticators with NTLMv2 support
- Cachemgr CGI interface supporting Microsoft IIS and Apache Web Server
- SNMP
- Support for aufs async I/O using native Windows Threads
- External ACL native group helper for Windows Domains group membership check
- OpenSSL Support (experimental binary package available)
- ARP acl support
- Currently supported Windows platforms:
  - Windows NT 4.0 Workstation and Server SP4 and later
  - Windows 2000 Professional and Server
  - Windows XP Professional (x86 and x64)
  - Windows 2003 Server (x86 and x64)
  - Windows Vista (x86 and x64)
  - Windows 2008 Server (x86 and x64)
Some special builds are available on Squid download Page

Licensing

Squid is licensed under the terms of the GNU General Public License.

Install:

If You are upgrading from SquidNT 2.x, please uninstall the old service and merge your old squid.conf in the new squid.conf configuration file. Don't forget to take a look about squid.conf changes on Squid 2.7 Release Notes page
Extract the binary archive in the desired directory (default c:\squid)
Check in the docs\CompileOptions.txt file the build options
Read the docs\release.html file
Copy and rename the follwing files:

squid.conf.default ==> squid.conf
mime.conf.default ==> mime.conf
cachemgr.conf.default ==> cachemgr.conf

Edit the squid.conf and change if needed the c:/squid path (use path with '/' char, NOT '\')
Manually create ALL the directories specified in squid.conf, except the contents of the cache directory
squid -i [-f configfile] [-n servicename] (installs the servicename Squid service using the configfile configuration file, default configfile is "c:/squid/etc/squid.conf", default servicename is "Squid")
squid -z [-f configfile] (creates the cache directories)
squid -O servicecommandline [-n servicename] (Set in Windows Registry the Squid servicename service command line)

Uninstall:

squid -r [-n servicename] (removes the servicename Squid service)

Usage:

Service mode:

Start: Control Panel/Services: choose "Start" for the "Squid" service.
Stop: Control Panel/Services: choose "Stop" for the "Squid" service.
squid -h Print help message.
squid -n servicename [-f configfile] -k reconfigure | rotate | shutdown | interrupt | kill | debug | check
Send signal to running copy and exit.
squid -O servicecommandline [-n servicename] Set Windows Service Command line options in Registry.
squid -v Print version.

The rest of the (original) cmdline switches when running as a Service must be used once with the -O switch. If multiple service command line options must be specified, use quote.

Don't use the "Start parameters" in the Windows Service applet: they are specific to Windows services functionality and Squid is not designed for understand they.

Example:
```
squid -O "-D -u 3130" -n squidsvc
```
Don't forget to take a look on Squid documentation on www.squid-cache.org

This Squid build can support multiple Squid service instances running from the same executable, so the service name MUST be ALWAYS specified when using all -k, -O commands even running only one instance.

Every instance must have a different service name, use different TCP ports, use different logs and cache directory and use a different configuration file.
So, when installing the service, if don't using the default settings (c:/squid,Squid Service Name), the service name and the associated config file MUST be specified.
The same when removing or running squid -k or -O commands.

Command Line mode:
All Squid cmdline switches are available, except the -N (no daemon mode)

Compiling source code:

Microsoft build environment:
- Microsoft Visual C++ 6.0 Service Pack 6
- Microsoft latest Core SDK
- Native CVS, gawk, perl, sed and patch for NT
MinGW environment:
- MSYS 1.0.9 or later
- MinGW 3.1.0 or later
- Windows API 2.4.0 or later
- MSYS Developer Tool Kit 1.0.1 or later
Build environments configuration
How obtain the sources:
- Download the auto-generated daily tar.gz archive from Squid download Page
  or
- Get with CVS the nt branch from devel.squid-cache.org
Build using Microsoft Visual Studio:
- Check ASCII format of all project files, must be DOS (CR+LF)
- Check paths on all project files
- Verify the Squid options defined in autoconf.h
- Check default parameters on squid_mswin.mak file
- Check settings on Install files project

Build using MinGW:

From MSYS prompt run:

./configure --prefix=c:/squid --disable-wccp --disable-wccpv2 \
--enable-win32-service --enable-default-hostsfile=none
make

For other configure options see Squid FAQ

Compatibility Notes:

It's recommended to use / char in Squid paths instead of \
Paths with spaces (like C:\Programs Files\Squid) are NOT supported by Squid
Include wildcard patterns in squid.conf are NOT supported on Windows
When using ACL like acl aclname acltype "file" the file must be in DOS text format (CR+LF) and the full Windows path must be specified, for example:
```
acl blocklist url_regex -i "c:/squid/etc/blocked1.txt"
```
The Windows equivalent of /dev/null is NUL
Squid doesn't know how to run external helpers based on scripts, like .bat, .cmd, .vbs, .pl, etc. So in squid.conf the interpreter path must be always specified, for example:
```
redirect_program c:/perl/bin/perl.exe c:/squid/libexec/redir.pl
redirect_program c:/winnt/system32/cmd.exe /C c:/squid/libexec/redir.cmd
```
When Squid runs in command line mode, the launching user account must have administrative privilege on the system
"Start parameters" in the Windows 2000/XP/2003 Service applet cannot be used

Known Limitations:

Squid features not operational:
DISKD: needs to be ported - Volunteers are welcome
WCCP: cannot work because GRE support on Windows is missing - Volunteers are welcome
Transparent Proxy: missing Windows non commercial interception driver
Some code sections can make blocking calls
Some external helpers may not work
File Descriptors number hard-limited to 2048

For general Squid configuration ask always on squid-users mailing list.

Commercial support is available from Acme Consulting S.r.l..

(ask for price)

Original Port and some enhancements by Romeo Anghelache (see the ChangeLog)