git.sesse.net Git - videoredirector/blob - README

   1 Video mirror redirector
   2 =======================
   3
   4 This fulfills a simple need: Redirecting people on to the closest mirror
   5 of many. It was specifically written for Debconf 13, but should be useable
   6 for any kind of dumb HTTP mirror.
   7
   8 It is based on http.debian.net (https://github.com/rgeissert/http-redirector),
   9 but heavily modified, since we do not need most of what a Debian mirror needs.
  10 You will most likely need some local tweaking of e.g. the mirror list; things
  11 are a lot more hard-coded than in the original
  12
  13 Getting started
  14 ===============
  15
  16 Required packages:
  17     libcgi-simple-perl
  18     libgeo-ip-perl
  19     libwww-perl
  20     wget
  21
  22 Run ./update.sh, it will download the geoip databases, the mirrors
  23 list, build the database used by the redirector, and check the mirrors
  24 for errors.
  25
  26 Check the first lines of redir.pl for the invocation (or look at the
  27 example below.)
  28
  29 Real life testing
  30 =================
  31
  32 Here's the Apache snippet we used during Debconf 13:
  33
  34     AddHandler cgi-script .pl
  35     Options +ExecCGI
  36
  37     RewriteEngine On
  38     RewriteRule ^/(.*)$ /redir.pl?url=$1 [L]
  39
  40 Credits
  41 =======
  42
  43 "This product includes GeoLite data created by MaxMind, available from
  44 http://maxmind.com/"