.if !'po4a'hide' .TH squid 8
.
.SH "نام (NAME)"
squid \- سرور پروکسی و کش وب بر پایه HTTP
.
.SH "خلاصه دستور (SYNOPSIS)"
.if !'po4a'hide' .B squid
.if !'po4a'hide' .B [\-dhisrvzCFNRSVYX]
.if !'po4a'hide' .B [\--foreground]
.if !'po4a'hide' .B [\-l
facility
.if !'po4a'hide' .B ] [\-f
config\-file
.if !'po4a'hide' .B ] [\-[au]
port
.if !'po4a'hide' .B ] [\-k
signal
.if !'po4a'hide' .B ] [\-n
service\-name
.if !'po4a'hide' .B ] [\-O
command\-line
.if !'po4a'hide' .B ]
.
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه
.B squid
یک سرور پروکسی و کِش (Caching Server) با کارایی بالا برای کلاینت‌های وب است که از اشیاء داده‌ای پروتکل‌های HTTP ،HTCP ،ICP ،ICAP و FTP پشتیبانی می‌کند. بر خلاف نرم‌افزارهای کش سنتی، Squid تمامی درخواست‌ها را در یک فرآیند واحد و غیرمسدودکننده (non-blocking) مدیریت می‌کند.
.PP
برنامه Squid فراداده‌ها و به‌ویژه اشیاء پرکاربرد را در حافظه RAM ذخیره می‌کند، جستجوهای سامانه نام دامنه (DNS) را کش کرده، از جستجوهای نامسدودکننده DNS پشتیبانی می‌نماید و کش منفی (negative caching) را برای درخواست‌های ناموفق اعمال می‌کند.
.PP
برنامه Squid از SSL، کنترل‌های دسترسی گسترده و ثبت کامل وقایع درخواست‌ها (logging) پشتیبانی می‌کند. با استفاده از پروتکل‌های سبک کش اینترنتی ICP ،HTCP یا CARP، کش‌های Squid می‌توانند در یک ساختار سلسله‌مراتبی یا مش برای صرفه‌جویی بیشتر در پهنای باند سازمان‌دهی شوند.
.PP
برنامه Squid از یک برنامه سرور اصلی به نام
.B squid
، تعدادی برنامه اختیاری برای پردازش‌های سفارشی و احراز هویت، و برخی ابزارهای مدیریتی و کلاینت تشکیل شده است. هنگامی که Squid راه‌اندازی می‌شود، تعداد قابل تنظیمی از فرآیندهای کمکی (helper processes) را اجرا می‌کند که هر کدام می‌توانند جستجوها را به‌صورت موازی انجام دهند. این امر مدت زمانی را که کش در انتظار نتایج سپری می‌کند کاهش می‌دهد.
.PP
برنامه Squid برگرفته از پروژه Harvest با بودجه ARPA است.
.PP
این صفحه راهنما فقط آرگومان‌های خط فرمان را فهرست می‌کند. برای جزئیات نحوه پیکربندی Squid به فایل
.BR /etc/squid/squid.conf.documented ،
پرسش‌های متداول (FAQ) و مثال‌های ویکی Squid در
https://wiki.squid-cache.org
یا راهنمای پیکربندی در وب‌سایت اصلی Squid
.if !'po4a'hide' http://www.squid-cache.org/Doc/config
مراجعه کنید.
.
.SH "گزینه‌ها (OPTIONS)"
.if !'po4a'hide' .TP 12
.if !'po4a'hide' .B "\-a port"
شماره پورت HTTP را مشخص می‌کند که در آن Squid علاوه بر مقادیر تعیین‌شده برای
.B http_port
در فایل
.B squid.conf
، باید به درخواست‌ها گوش فرا دهد.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-C
سیگنال‌های کشنده (fatal signals) را به دام نینداز.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-d level"
پیام‌های اشکال‌زدایی (debugging) را در خطای استاندارد (stderr) نیز بنویس.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-f file"
استفاده از فایل پیکربندی مشخص‌شده به جای
.B /etc/squid/squid.conf .
اگر نام فایل با یک
.B !
یا
.B |
شروع شود، به عنوان یک دستور خارجی یا خط فرمان در نظر گرفته می‌شود. به عنوان مثال می‌تواند برای پیش‌پردازش پیکربندی قبل از خوانده شدن آن توسط Squid استفاده شود. برای تسهیل این کار، Squid همچنین مفهوم متداول #line را برای مشخص کردن فایل مبدا اصلی متوجه می‌شود.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-F
تا زمان بازسازی کامل مخزن ذخیره‌سازی (store)، به هیچ درخواستی پاسخ نده.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-h
چاپ پیام راهنما.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-i
نصب به عنوان یک سرویس ویندوز (Windows Service) (گزینه
.B \-n
را ببینید).
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-k reconfigure | rotate | shutdown | interrupt | kill | debug | check | parse"
تجزیه فایل پیکربندی، سپس ارسال سیگنال به نسخه در حال اجرا (به جز
.B "\-k parse"
) و خروج.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-l facility"
استفاده از بخش (facility) مشخص‌شده syslog. این گزینه مستلزم فعال بودن
.B \-s
است.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-n name"
مشخص کردن نام سرویس ویندوز برای انجام عملیات سرویس؛ مقدار پیش‌فرض:
.B Squid
است.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-N
غیرفعال کردن حالت دیمن (عدم اجرا در پس‌زمینه).
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \--foreground
فرآیند والد تا زمانی که فرزندانش کار خود را به پایان نرسانده باشند، خارج نمی‌شود. این گزینه تاثیری بر
.B \-N
که در زمان راه‌اندازی فرآیند را چنگال/خارج (fork/exit) نمی‌کند، ندارد.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\--kid roleID"
ایفای نقش فرآیند فرزند SMP مشخص با شناسه معین. از این گزینه استفاده نکنید؛ این گزینه صرفاً برای استفاده فرآیند اصلی (master process) در نظر گرفته شده است.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-O options"
تنظیم گزینه‌های خط فرمان سرویس ویندوز در رجیستری (Registry).
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-r
حذف سرویس ویندوز (گزینه
.B \-n
را ببینید).
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-R
عدم تنظیم فلگ
.B REUSEADDR
روی پورت.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-s
فعال‌سازی ثبت وقایع در syslog. همچنین در
.BI /etc/squid/squid.conf
نیز قابل پیکربندی است.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-S
بررسی مجدد swap در حین بازسازی (rebuild).
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-u port"
مشخص کردن شماره پورت ICP (پیش‌فرض: ۳۱۳۰)؛ برای غیرفعال کردن مقدار ۰ را قرار دهید.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-v
چاپ نگارش و جزئیات ساخت (build).
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-X
اجبار به حالت اشکال‌زدایی کامل.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-Y
در حین بارگذاری سریع (fast reload)، تنها مقادیر
.B UDP_HIT
یا
.B UDP_MISS_NOFETCH
بازگردانده شوند.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B \-z
ایجاد دایرکتوری‌های مفقود swap و سایر ساختارهای ناقص cache_dir، و سپس خروج. تمام انواع cache_dir در صورتی که دایرکتوری سطح بالای پیکربندی‌شده وجود نداشته باشد، آن را ایجاد می‌کنند. سایر اقدامات به نوع ذخیره‌سازی بستگی دارند؛ برای مثال سامانه‌های ذخیره‌سازی مبتنی بر ufs دایرکتوری‌های گم‌شده L1 و L2 را می‌سازند، در حالی که نوع Rock فایل پایگاه‌داده مفقود را ایجاد می‌کند.
.IP
این گزینه اعتبارسنجی هیچ‌یک از ساختارهای موجود swap را فعال نمی‌کند؛ تمرکز آن بر ایجاد بخش‌های مفقود است. اگر هیچ موردی کم نباشد، دستور squid -z صرفاً خارج می‌شود. در صورتی که به خرابی cache_dir مشکوک هستید، باید دایرکتوری سطح بالای cache_dir را پیش از اجرای squid -z حذف نمایید.
.IP
به‌طور پیش‌فرض، squid -z در حالت دیمن اجرا می‌شود (تا ماکروهای پیکربندی و سایر ویژگی‌های SMP مطابق انتظار کار کنند) و کنترل را قبل از مقداردهی اولیه کامل cache_dirها به فراخواننده بازمی‌گرداند. در صورت اجرا از طریق اسکریپت‌های init یا مدیرهای دیمن، فراخواننده معمولاً باید قبل از ادامه فرآیند منتظر تکمیل مقداردهی اولیه بماند. از گزینه
.B \--foreground
برای جلوگیری از خروج زودهنگام استفاده کنید. برای غیرفعال کردن حالت دیمن، از گزینه
.B \-N
استفاده نمایید.
.
.SH "فایل‌ها (FILES)"
فایل‌های پیکربندی Squid واقع در /etc/squid/:
.
.if !'po4a'hide' .IP "squid.conf"
فایل پیکربندی اصلی. برای کارکرد
.B squid
باید ابتدا تغییراتی در این فایل اعمال کنید. برای مثال، پیکربندی پیش‌فرض فقط دسترسی از شبکه‌های محلی خصوصی (RFC private LAN) را مجاز می‌داند؛ برخی توزیع‌ها حتی همین را نیز مسدود می‌کنند.
.
.if !'po4a'hide' .IP "squid.conf.default"
نسخه مرجع فایل پیکربندی. همیشه با نسخه Squid مورد استفاده شما به‌روز نگه داشته می‌شود.
.IP
از این فایل برای بررسی تنظیمات پیش‌فرض پیکربندی و ساختار نحوی (syntax) پس از ارتقا استفاده کنید.
.
.if !'po4a'hide' .IP "squid.conf.documented"
نسخه مرجع فایل پیکربندی. همیشه با نسخه Squid مورد استفاده شما به‌روز نگه داشته می‌شود.
.IP
از این فایل برای خواندن مستندات گزینه‌های پیکربندی موجود در ساخت Squid خود استفاده نمایید. راهنمای آنلاین پیکربندی نیز به عنوان یک مرجع کامل از گزینه‌ها در دسترس است.
.BR "ببینید: " http://www.squid-cache.org/Doc/config
.
.if !'po4a'hide' .IP "msntauth.conf"
فایل پیکربندی اصلی برای احراز هویت‌کننده نمونه MSNT.
.
.if !'po4a'hide' .IP "errorpage.css"
شیوه‌نامه CSS برای کنترل نحوه نمایش صفحات خطای تولیدشده. از این فایل برای اعمال برند تجاری یا سفارشی‌سازی دلخواه استفاده کنید؛ این تنظیمات برای تمام زبان‌هایی که Squid صفحات خطا ارائه می‌دهد اعمال خواهد شد.
.PP
.br
برخی فایل‌ها در مسیرهای دیگر قرار دارند:
.
.if !'po4a'hide' .IP "/etc/squid/mime.conf (mime_table)"
نگاشت‌های نوع MIME برای دروازه‌بانی FTP.
.
.if !'po4a'hide' .IP "/usr/share/squid/errors"
محل قرارگیری صفحات خطا و قالب‌های Squid.
.
.SH "نویسندگان (AUTHORS)"
برنامه Squid در طول سالیان متمادی توسط تیمی از توسعه‌دهندگان نوشته شده و به نوبت توسط افراد زیر نگهداری شده است:
.if !'po4a'hide' .I Duane Wessels <duane@squid-cache.org>
.if !'po4a'hide' .I Henrik Nordstrom <hno@squid-cache.org>
.if !'po4a'hide' .I Amos Jeffries <amosjeffries@squid-cache.org>
.PP
همراه با مشارکت‌های بسیار از سوی جامعه کاربران و توسعه‌دهندگان Squid.
برای مشاهده فهرست کامل افرادی که در کد مشارکت داشته‌اند به فایل CONTRIBUTORS مراجعه کنید.
برای مشاهده فهرستی از دارندگان عمده حق نشر مشارکت‌کننده در کد، فایل CREDITS را ببینید.
.
.SH "حق نشر (COPYRIGHT)"
.PP
 * Copyright (C) 1996-2026 The Squid Software Foundation and contributors
 *
 * نرم‌افزار Squid تحت مجوز GPLv2+ توزیع می‌شود و شامل مشارکت‌های
 * افراد و سازمان‌های متعددی است.
 * لطفاً برای جزئیات به فایل‌های COPYING و CONTRIBUTORS مراجعه کنید.
.
.SH "پرسش‌ها (QUESTIONS)"
پرسش‌ها درباره استفاده از این برنامه را می‌توان به
.I فهرست پستی کاربران Squid (Squid Users mailing list)
به نشانی
.if !'po4a'hide' <squid-users@lists.squid-cache.org>
ارسال کرد.
.
.SH "گزارش اشکالات (REPORTING BUGS)"
گزارش‌های اشکال باید به زبان انگلیسی ارسال شوند.
برای آگاهی از جزئیات مواردی که باید در گزارش باگ خود قید کنید به نشانی https://wiki.squid-cache.org/SquidFaq/BugReporting مراجعه فرمایید.
.PP
گزارش اشکالات یا وصله‌های اصلاح باگ را با استفاده از https://bugs.squid-cache.org ارسال کنید.
.PP
اشکالات امنیتی جدی را به نشانی زیر گزارش دهید:
.I Squid Bugs <squid-bugs@lists.squid-cache.org>
.PP
ایده‌ها و پیشنهادات برای بهبودهای جدید را به فهرست پستی توسعه‌دهندگان ارسال کنید:
.I Squid Developers mailing list
.if !'po4a'hide' <squid-dev@lists.squid-cache.org>
.
.SH "همچنین ببینید (SEE ALSO)"
.if !'po4a'hide' .B basic_pam_auth "(8), "
.if !'po4a'hide' .B basic_ldap_auth "(8), "
.if !'po4a'hide' .B ext_ldap_group_acl "(8), "
.if !'po4a'hide' .B ext_session_acl "(8), "
.if !'po4a'hide' .B ext_unix_group_acl "(8), "
.br
ویکی پرسش‌های متداول Squid:
.if !'po4a'hide' https://wiki.squid-cache.org/SquidFaq
.br
راهنمای پیکربندی Squid:
.if !'po4a'hide' http://www.squid-cache.org/Doc/config