ocaml

SwiftSurf

Smart Web Proxy

version française

download the latest version (Change Log)

Compilation and installation

Compilation is very easy : you just have to type "gmake" (or "gmake byte" if you don't have a native ocaml compiler). To get an ocaml compiler, go to ocaml web site.

For installing swiftsurf, you must become root and type "gmake install".

You can now launch swiftsurf and configure your browser. With Netscape or Mozilla, go to Edit->Preferences->Advanced->Proxies, select "Manual proxy configuration" and set localhost with port 8080 as proxy for http and https.

Presentation

SwiftSurf is a web proxy that can handle http (1.0 and 1.1) and https. Moreover, it allows page filtering and authentication through a password.

a. Vocabulary

b. Interest of filtering

Nota: The way the filter stops a page is by looking at the url, NOT the content of the page. However, as you'll soon see, it's enough most of the time.

Configuration

All the configuration of SwiftSurf is made using the configuration file. Comments start by "#" and finish at the end of the line.
If not specified with the -c option, the configuration file is searched within the following files : $HOME/.swiftsurf, /etc/swiftsurf.conf, ./swiftsurf.conf, /dev/null.
the default file provided with the program should be fine for most users. You just need to add the urls you want to filter in the file named "forbidden". If you want an example of configuration file using profiles, see swiftsurf.conf.school.

General configurations

Here are the configurations that will be used by all connections (all the keywords are case insensitive) :

Profiles configurations

You can use at the same time different profiles, depending on the access you want to give for example. Here is how a profile is defined :
profile login:pass
  profOpt1
  profOpt2 ...
endProfile
If you do not define any profile, you will be able to use the proxy without password.
Here are the possible options for profiles (profOpt) :

To do


sebastien.ailleret@inria.fr Home Page