Your company here — click to reach over 10,000 unique daily visitors

url_lfs_rewrite - Man Page

a URL-rewriter based on local file existence


 url_lfs_rewrite [--debug] --local-dir=/var/www/ [options]


Direct all request to files who are in a local directory to a local web server hosting this directory.

This program uses Squid concurrency support.



Write debug info to stderr.


Directory path under which the scripts searches for files.


Scheme to use for the redirected URL.

 Default: http

Domain name to use for the redirected URL.

 Default: localhost

URL path to add as prefix for the redirected URL path.

If set it must end with a '/'.

 Default: use the original URL path.

Known Issues

* The --local-dir parameter must end with a '/'. Otherwise no
 file paths will be found.

* URL with no filename in the path can match directories on the local
 filesystem and be wrongly redirected to the local web server.

* Any scheme name accepted by the Perl URL library can be used
 as the --to-scheme parameter. However only schemes supported by
 Squid will work.

* URL containing query-string are not handled well and will not
 be rewritten even if the base script or file exists on the local


  url_rewrite_program /path/to/url_lfs_rewrite --local-dir=\var\www\localhost
  url_rewrite_children 20 startup=1 idle=1 concurrency=25
  url_rewrite_access deny CONNECT
  url_rewrite_access deny to_localhost

This helper can redirect to any web server but only does so if there is a file matching the URL path segment in the local filesystem. Normal configuration requires a web server running on localhost serving up files from a local disk (eg. \var\www\localhost). Configuration of that web server is not covered here.


This program and documentation was written by Amos Jeffries <squid3@treenet.co.nz>

Based on prior work in rredir.pl by Peter Eisenhauer <pe@pipetronix.de>. First Version: 26. May 1997

Reporting Bugs

Bug reports need to be made in English. See https://wiki.squid-cache.org/SquidFaq/BugReporting for details of what you need to include with your bug report.

Report bugs or bug fixes using https://bugs.squid-cache.org/

Report serious security bugs to Squid Bugs <squid-bugs@lists.squid-cache.org>

Report ideas for new improvements to the Squid Developers mailing list <squid-dev@lists.squid-cache.org>

See Also

squid (8), GPL (7),

The Squid FAQ wiki https://wiki.squid-cache.org/SquidFaq

The Squid Configuration Manual http://www.squid-cache.org/Doc/config/


2024-04-16 perl v5.38.2 User Contributed Perl Documentation