URL_LFS_REWRITE
NAMESYNOPSIS
DESCRIPTION
OPTIONS
KNOWN ISSUES
CONFIGURATION
AUTHOR
COPYRIGHT
REPORTING BUGS
SEE ALSO
NAME
url_lfs_rewrite - a URL-rewriter based on local file existence
SYNOPSIS
url_lfs_rewrite [--debug] --local-dir=/var/www/ [options]
DESCRIPTION
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.
OPTIONS
--debug
Write debug info to stderr.
--local-dir
Directory path under which the scripts searches for files.
--to-scheme
Scheme to use for the redirected URL.
Default: http
--to-host
Domain name to use for the redirected URL.
Default: localhost
--to-path
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
system.
CONFIGURATION
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.
AUTHOR
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
COPYRIGHT
* Copyright (C)
1996-2023 The Squid Software Foundation and contributors
*
* Squid software is distributed under GPLv2+ license and
includes
* contributions from numerous individuals and organizations.
* Please see the COPYING and CONTRIBUTORS files for
details.
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/
Introduction
- About Squid
- Why Squid?
- Squid Developers
- How to Donate
- How to Help Out
- Getting Squid
- Squid Source Packages
- Squid Deployment Case-Studies
- Squid Software Foundation
Documentation
- Quick Setup
- Configuration:
- FAQ and Wiki
- Guide Books:
- Non-English
- More...
Support
- Security Advisories
- Bugzilla Database
- Mailing lists
- Contacting us
- Commercial services
- Project Sponsors
- Squid-based products