.if !'po4a'hide' .TH ext_time_quota_acl 8 "22 March 2011"
.
.SH "نام (NAME)"
ext_time_quota_acl \- برنامه‌ی کمکی ACL خارجی سهمیه زمانی اسکوئید
.PP
نسخه 1.0
.
.SH "خلاصه دستور (SYNOPSIS)"
.if !'po4a'hide' .B ext_time_quota_acl
.if !'po4a'hide' .B "[\-b database] [\-d level] [\-p pauselen] [\-h] configfile
.
.SH "توضیحات (DESCRIPTION)"
.B ext_time_quota_acl
به مدیر سیستم امکان می‌دهد تا برای کاربران اسکوئید بودجه‌های زمانی تعریف کند تا مدت‌زمان استفاده از اسکوئید را محدود سازد.
.PP
این ویژگی برای تخصیص زمان ناهار در شرکت‌ها، راه‌اندازی‌های پرتال وای‌فای با پرداخت بر دقیقه یا کنترل والدین بر فرزندان مفید است. مدیر سیستم می‌تواند یک بودجه زمانی (به‌عنوان مثال ۱ ساعت در روز) تعیین کند که از طریق این برنامه‌ی کمکی اعمال می‌شود.
.
.SH "گزینه‌ها (OPTIONS)"
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-b database"
نام فایل پایگاه‌داده پایدار. این مقدار به‌طور پیش‌فرض
.B ext_time_quota.db
در دایرکتوری وضعیت اسکوئید است.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-p pauselen"
.B pauselen
بر حسب ثانیه مشخص می‌شود و فاصله‌ی زمانی بین دو درخواست را تعیین می‌کند تا به عنوان بخشی از همان نشست در نظر گرفته شوند.
وقفه‌های کوتاه‌تر از این مقدار جزء سهمیه محاسبه خواهند شد و وقفه‌های طولانی‌تر نادیده گرفته می‌شوند.
مقدار پیش‌فرض ۳۰۰ ثانیه (۵ دقیقه) است.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-d"
سطح پرگویی را برای بخش اشکال‌زدایی ۸۲ تنظیم می‌کند (۰ تا ۹؛ پیش‌فرض ۱ است؛
.B debug_options
را ببینید).
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B "\-h"
نمایش یک راهنمای کوتاه در خط فرمان.
.
.if !'po4a'hide' .TP
.if !'po4a'hide' .B configfile
این فایل حاوی تعریف بودجه‌های زمانی برای کاربران است.
.PP
.
.SH "پیکربندی (CONFIGURATION)"
.PP
سهمیه‌های زمانی کاربران در یک فایل متنی تعریف می‌شوند که معمولاً در مسیر
.B /etc/squid/time_quota
قرار دارد. هر خطی که با «#» شروع شود، حاوی توضیح است و نادیده گرفته می‌شود. هر خط باید با یک کاربر شروع شود و به دنبال آن یک بودجه زمانی و دوره زمانی متناظر که با «/» جدا شده‌اند، بیاید. در ادامه یک نمونه فایل آورده شده است:
.PP
.if !'po4a'hide' .RS
# user budget / period
.if !'po4a'hide' .br
.if !'po4a'hide' .B john 8h / 1d
.if !'po4a'hide' .br
.if !'po4a'hide' .B littlejoe 1h / 1d
.if !'po4a'hide' .br
.if !'po4a'hide' .B babymary 30m / 1w
.if !'po4a'hide' .br
.if !'po4a'hide' .RE
.PP
کاربر john دارای بودجه زمانی ۸ ساعت در هر روز است، littlejoe فقط مجاز به ۱ ساعت است و babymary بینوا تنها ۳۰ دقیقه در هفته فرصت دارد.
.PP
می‌توانید از «s» برای ثانیه، «m» برای دقیقه، «h» برای ساعت، «d» برای روز و «w» برای هفته استفاده کنید. مقادیر عددی می‌توانند به صورت عدد صحیح یا همراه با بخش اعشاری باشند؛ برای نمونه «0.5h» به معنای ۳۰ دقیقه است.
.PP
این برنامه‌ی کمکی در فایل
.B squid.conf
با استفاده از دستورالعمل
.B external_acl_type
پیکربندی می‌شود و سپس کنترل‌های دسترسی که از آن برای مجاز یا رد کردن استفاده می‌کنند تعریف می‌گردند.
.
.PP
در ادامه یک نمونه آورده شده است:
.PP
.if !'po4a'hide' .RS
# Ensure that users have a valid login. We need their username.
.if !'po4a'hide' .br
.if !'po4a'hide' .br
.if !'po4a'hide' .B acl users proxy_auth REQUIRED
.if !'po4a'hide' .br
.if !'po4a'hide' .B http_access deny !users
.if !'po4a'hide' .br
# Define program and quota file
.if !'po4a'hide' .br
.if !'po4a'hide' .B external_acl_type time_quota ttl=60 children-max=1 %LOGIN /usr/libexec/ext_time_quota_acl /etc/squid/time_quota
.if !'po4a'hide' .br
.if !'po4a'hide' .br
.if !'po4a'hide' .B acl noquota src all
.if !'po4a'hide' .br
.if !'po4a'hide' .B acl time_quota external time_quota
.if !'po4a'hide' .br
.if !'po4a'hide' .B deny_info ERR_ACL_TIME_QUOTA_EXCEEDED noquota
.if !'po4a'hide' .br
.if !'po4a'hide' .B http_access deny !time_quota noquota
.if !'po4a'hide' .RE
.
.PP
در این مثال، پس از راه‌اندازی مجدد اسکوئید، دسترسی تنها تا زمانی برای کاربران مجاز خواهد بود که از بودجه زمانی آن‌ها باقی مانده باشد.
اگر بودجه تمام شود، یک صفحه خطا به کاربر نمایش داده خواهد شد و به او اطلاع می‌دهد.
.PP
در این مثال ما از کنترل دسترسی مجزای
.B users
و لیست کنترل دسترسی
.B noquota
استفاده می‌کنیم تا اعلان درخواست نام کاربری و گذرواژه از پیام‌های اتمام سهمیه جدا بماند.
.
.PP
شناسه کاربر صرفاً یک مقدار کلید یکتا است. مثال بالا از
.B %LOGIN
و نام کاربری استفاده می‌کند، اما هر یک از تگ‌های فرمت
.B external_acl_type
می‌تواند به جای آن جایگزین شود.
.BR %EXT_TAG ,
.BR %LOGIN ,
.BR %EXT_USER ,
.BR %SRC ,
.B %SRCEUI48
و
.B %SRCEUI64
همگی از گزینه‌های محتمل برای شناسایی کلاینت هستند.
ویکی اسکوئید نمونه‌های بیشتری در
https://wiki.squid-cache.org/ConfigExamples
دارد.
.
.SH "محدودیت‌ها (LIMITATIONS)"
.PP
این برنامه‌ی کمکی تنها دسترسی به اینترنت از طریق پروتکل HTTP را کنترل می‌کند و سایر پروتکل‌ها مانند VOIP، ICQ، IRC، FTP، IMAP، SMTP یا SSH را کنترل نمی‌کند.
.
.PP
مرورگرهای دسکتاپ معمولاً قادر به مدیریت احراز هویت با پروکسی‌های HTTP مانند
.B squid
هستند. اما امروزه برنامه‌ها و دستگاه‌های مختلف و متعددی (گوشی‌های هوشمند، بازی‌های دستگاه‌های تلفن همراه و...) از اینترنت بر بستر HTTP استفاده می‌کنند. این دستگاه‌ها اغلب قادر به کار از طریق یک پروکسی نیازمند احراز هویت نیستند.
برای اعتبارسنجی این دستگاه‌ها و نرم‌افزارها، روش‌هایی غیر از احراز هویت با
.B %LOGIN
مورد نیاز است.
.
.PP
یک راهکار عمومی‌تر برای کنترل دسترسی به اینترنت می‌تواند رویکرد پرتال اسیر (کپتیو پرتال مانند pfSense یا ChilliSpot) با استفاده از
.BR %SRC ،
.B %SRCEUI48
و
.B %SRCEUI64
به عنوان کلید، یا شاید یک راهکار مبتنی بر 802.11X باشد؛ هرچند مورد آخر اغلب توسط دستگاه‌های تلفن همراه پشتیبانی نمی‌شود.
.
.SH "پیاده‌سازی (IMPLEMENTATION)"
.PP
هنگامی که این برنامه‌ی کمکی فراخوانی می‌شود، از آن پرسیده می‌شود که آیا کاربر فعلی مجاز به دسترسی به اسکوئید هست یا خیر. برنامه‌ی کمکی بودجه زمانی باقی‌مانده این کاربر را کاهش می‌دهد و در صورت باقی ماندن بودجه، مقدار
.B OK
را بازمی‌گرداند؛ در غیر این صورت، مقدار
.B ERR
را بازخواهد گرداند.
.
.PP
پارامتر
.B ttl=N
در فایل
.B squid.conf
تعیین می‌کند که این برنامه‌ی کمکی هر چند وقت یک‌بار فراخوانی شود؛ در پیکربندی نمونه از یک TTL یک دقیقه‌ای استفاده شده است.
سازوکار تعامل بدین صورت است که اسکوئید تنها زمانی برنامه‌ی کمکی را برای درخواست‌های جدید فراخوانی می‌کند
.B اگر
بیش از مقدار TTL ثانیه از آخرین بررسی گذشته باشد.
این نحوه برخورد باعث مقداری لغزش و عبور از سهمیه به هر میزانی که پیکربندی شده است می‌شود.
مقدار TTL را می‌توان به هر میزان کوتاهی که لازم است تنظیم کرد، حتی تا صفر؛ هرچند به دلیل تفکیک‌پذیری یک‌ثانیه‌ای سهمیه، مقادیر ۱ یا بیشتر توصیه می‌شوند.
.
.PP
اگر دوره زمانی پیکربندی‌شده (مانند «1w» برای babymary) به پایان برسد، بودجه زمانی به مقدار پیکربندی‌شده بازگردانده می‌شود و به کاربر امکان می‌دهد با بودجه‌ای تازه به اسکوئید دسترسی داشته باشد.
.
.PP
اگر زمان بین درخواست فعلی و درخواست قبلی بیشتر از
.B pauselen
باشد (پیش‌فرض ۵ دقیقه است و با پارامتر خط فرمان
.B \-p
قابل تنظیم است)، درخواست فعلی به عنوان یک درخواست جدید در نظر گرفته می‌شود و بودجه زمانی کاهش نمی‌یابد. اگر این زمان کمتر از
.B pauselen
باشد، هر دو درخواست به عنوان بخشی از همان دوره زمانی فعال در نظر گرفته می‌شوند و بودجه زمانی به میزان اختلاف زمان کاهش خواهد یافت. این قابلیت به کاربر اجازه می‌دهد تا وقفه‌های دلخواهی را در طول استفاده از اینترنت داشته باشد بدون اینکه بودجه زمانی خود را از دست بدهد.
.
.SH "ایده‌های بیشتر (FURTHER IDEAS)"
ایده‌های زیر می‌توانند این برنامه‌ی کمکی را بیشتر بهبود دهند. آیا کسی مایل به کمک است؟ از هرگونه پشتیبانی یا بازخوردی استقبال می‌شود!
.if !'po4a'hide' .TP
باید روشی برای مشاهده بودجه زمانی پیکربندی‌شده و باقی‌مانده توسط کاربر وجود داشته باشد. این امر می‌تواند با پیاده‌سازی یک صفحه وب که به پایگاه‌داده‌ی برنامه‌ی کمکی دسترسی داشته باشد و داده‌های متناظر را نشان دهد محقق شود. یکی از مسائلی که باید حل شود احراز هویت کاربران است.
.if !'po4a'hide' .TP
ما می‌توانیم همیشه «OK» برگردانیم و از این ماژول صرفاً به عنوان یک ردیاب استفاده از اینترنت استفاده کنیم تا مشخص شود چه کسی چه مدت در وب مانده است.
.PP
.
.SH "نویسنده (AUTHOR)"
این برنامه و مستندات توسط
.if !'po4a'hide' .I Dr. Tilmann Bubeck <t.bubeck@reinform.de>
نوشته شده است.
.
.SH "حق نشر (COPYRIGHT)"
.PP
 * 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.
.PP
حق نشر این برنامه و مستندات برای نویسندگان نام‌برده در بالا محفوظ است.
.PP
تحت مجوز عمومی همگانی گنو (GNU GPL) نسخه ۲ یا بالاتر (GPLv2+) توزیع شده است.
.
.SH "پرسش‌ها (QUESTIONS)"
پرسش‌ها در مورد استفاده از این برنامه را می‌توان به لیست ایمیل کاربران اسکوئید ارسال کرد:
.br
.I 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
پیشنهادها و ایده‌ها برای پیشرفت‌های جدید را به لیست ایمیل توسعه‌دهندگان اسکوئید ارسال کنید:
.br
.I Squid Developers mailing list
.if !'po4a'hide' <squid-dev@lists.squid-cache.org>
.
.SH "همچنین ببینید (SEE ALSO)"
.if !'po4a'hide' .BR squid "(8), "
.if !'po4a'hide' .BR GPL "(7), "
.br
ویکی پرسش‌های متداول اسکوئید:
.if !'po4a'hide' https://wiki.squid-cache.org/SquidFaq
.br
راهنمای پیکربندی اسکوئید:
.if !'po4a'hide' http://www.squid-cache.org/Doc/config