.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Required to disable full justification in groff 1.23.0.
.if n .ds AD l
.\" ========================================================================
.\"
.IX Title "URL_LFS_REWRITE 8"
.TH URL_LFS_REWRITE 8 2026-08-25 "perl v5.42.2" "User Contributed Perl Documentation"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "نام (NAME)"
.Vb 1
\& url_lfs_rewrite \- یک بازنویسنده URL بر اساس وجود فایل محلی
.Ve
.SH "خلاصه دستور (SYNOPSIS)"
.IX Header "SYNOPSIS"
.Vb 1
\& url_lfs_rewrite [\-\-debug] \-\-local\-dir=/var/www/ [گزینه‌ها]
.Ve
.SH "توضیحات (DESCRIPTION)"
.IX Header "DESCRIPTION"
تمام درخواست‌ها برای فایل‌هایی که در یک شاخه محلی قرار دارند را به یک وب‌سرور محلی که میزبان این شاخه است هدایت می‌کند.
.PP
این برنامه از پشتیبانی همزمانی Squid استفاده می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.IX Header "OPTIONS"
.IP \fB\-\-debug\fR 12
.IX Item "--debug"
نوشتن اطلاعات اشکال‌زدایی در stderr.
.IP \fB\-\-local\-dir\fR 12
.IX Item "--local-dir"
مسیر شاخه‌ای که اسکریپت در آن به جستجوی فایل‌ها می‌پردازد.
.IP \fB\-\-to\-scheme\fR 12
.IX Item "--to-scheme"
طرح‌واره‌ای (scheme) که برای URL تغییرمسیرداده‌شده استفاده می‌شود.
.Sp
.Vb 1
\& پیش‌فرض: http
.Ve
.IP \fB\-\-to\-host\fR 12
.IX Item "--to-host"
نام دامنه‌ای که برای URL تغییرمسیرداده‌شده استفاده می‌شود.
.Sp
.Vb 1
\& پیش‌فرض: localhost
.Ve
.IP \fB\-\-to\-path\fR 12
.IX Item "--to-path"
مسیر URL که به عنوان پیشوند به مسیر URL تغییرمسیرداده‌شده اضافه می‌شود.
.Sp
در صورت تنظیم، باید به \*(Aq/\*(Aq ختم شود.
.Sp
.Vb 1
\& پیش‌فرض: استفاده از مسیر اصلی URL.
.Ve
.SH "مشکلات شناخته‌شده (KNOWN ISSUES)"
.IX Header "KNOWN ISSUES"
* پارامتر \-\-local\-dir باید به \*(Aq/\*(Aq ختم شود؛ در غیر این صورت هیچ مسیر فایلی یافت نخواهد شد.
.PP
* نشانی‌های اینترنتی (URL) بدون نام فایل در مسیر، می‌توانند با شاخه‌های سیستم‌فایل محلی مطابقت پیدا کرده و به اشتباه به وب‌سرور محلی هدایت شوند.
.PP
* هر نام طرح‌واره‌ای (scheme) که توسط کتابخانه URL در Perl پذیرفته شود، می‌تواند به عنوان پارامتر \-\-to\-scheme استفاده گردد. با این حال تنها طرح‌واره‌های پشتیبانی‌شده توسط Squid کار خواهند کرد.
.PP
* نشانی‌های اینترنتی (URL) حاوی رشته پرس‌وجو (query\-string) به خوبی مدیریت نمی‌شوند و حتی اگر اسکریپت پایه یا فایل در سیستم محلی وجود داشته باشد، بازنویسی نخواهند شد.
.SH "پیکربندی (CONFIGURATION)"
.IX Header "CONFIGURATION"
.Vb 4
\&  url_rewrite_program /path/to/url_lfs_rewrite \-\-local\-dir=\evar\ewww\elocalhost
\&  url_rewrite_children 20 startup=1 idle=1 concurrency=25
\&  url_rewrite_access deny CONNECT
\&  url_rewrite_access deny to_localhost
.Ve
.PP
این برنامه کمکی می‌تواند درخواست‌ها را به هر وب‌سروری هدایت کند، اما تنها در صورتی این کار را انجام می‌دهد که فایلی مطابق با بخش مسیر URL در سیستم‌فایل محلی وجود داشته باشد. پیکربندی عادی مستلزم این است که یک وب‌سرور روی localhost در حال اجرا باشد و فایل‌ها را از یک دیسک محلی (مانند \evar\ewww\elocalhost) ارائه دهد. پیکربندی آن وب‌سرور در این مستند پوشش داده نشده است.
.SH "نویسنده (AUTHOR)"
.IX Header "AUTHOR"
این برنامه و مستندات آن توسط \fIAmos Jeffries <squid3@treenet.co.nz\fR> نوشته شده است.
.PP
بر اساس کارهای پیشین در \fBrredir.pl\fR توسط \fIPeter Eisenhauer <pe@pipetronix.de\fR>.
نسخه اولیه: ۲۶ مه ۱۹۹۷
.SH "حق نشر (COPYRIGHT)"
.IX Header "COPYRIGHT"
.Vb 5
\& * Copyright (C) 1996\-2026 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.
.Ve
.SH "گزارش باگ‌ها (REPORTING BUGS)"
.IX Header "REPORTING BUGS"
گزارش‌های باگ باید به زبان انگلیسی ارسال شوند.
برای جزئیات مواردی که باید در گزارش باگ خود بگنجانید، به https://wiki.squid\-cache.org/SquidFaq/BugReporting مراجعه کنید.
.PP
باگ‌ها یا اصلاحات باگ را با استفاده از https://bugs.squid\-cache.org/ گزارش کنید.
.PP
باگ‌های امنیتی جدی را به \fIباگ‌های Squid <squid\-bugs@lists.squid\-cache.org\fR> گزارش دهید.
.PP
ایده‌ها برای بهبودهای جدید را به \fIفهرست پستی توسعه‌دهندگان Squid <squid\-dev@lists.squid\-cache.org\fR> ارسال کنید.
.SH "همچنین ببینید (SEE ALSO)"
.IX Header "SEE ALSO"
squid (8), GPL (7),
.PP
ویکی پرسش‌های متداول Squid در https://wiki.squid\-cache.org/SquidFaq
.PP
راهنمای پیکربندی Squid در http://www.squid\-cache.org/Doc/config/