TINYPROXY(8)                   Tinyproxy manual                   TINYPROXY(8)


نام (NAME)
       tinyproxy - دیمن پروکسی HTTP سبک‌وزن

خلاصه دستور (SYNOPSIS)
       tinyproxy [-vdch]

توضیحات (DESCRIPTION)
       tinyproxy یک دیمن پروکسی HTTP سبک‌وزن است که برای مصرف حداقل منابع
       سیستمی طراحی شده است. این برنامه روی یک پورت TCP مشخص به اتصالات گوش
       فرا می‌دهد و درخواست‌های پروکسی HTTP را مدیریت می‌کند. با طراحی از پایه
       برای سریع و در عین حال کوچک بودن، یک راه‌حل ایده‌آل برای مواردی همچون
       استقرارهای تعبیه‌شده (embedded) است که در آن‌ها به یک پروکسی HTTP با
       امکانات کامل نیاز است، اما منابع سیستمی برای پروکسی‌های بزرگ‌تر در دسترس
       نیست.

گزینه‌ها (OPTIONS)
       tinyproxy گزینه‌های زیر را می‌پذیرد:

       -c <config-file>
           استفاده از یک فایل پیکربندی جایگزین.

       -d  عدم اجرای پس‌زمینه (دیمن نشدن) و ماندن در پیش‌زمینه. برای اهداف
           اشکال‌زدایی مفید است.

       -h  نمایش یک صفحه راهنمای کوتاه از آرگومان‌های خط فرمان و خروج.

       -v  نمایش اطلاعات نسخه و خروج.

سیگنال‌ها (SIGNALS)
       علاوه بر گزینه‌های خط فرمان، چندین سیگنال نیز وجود دارند که می‌توان در
       حین اجرا به tinyproxy ارسال کرد تا اطلاعات اشکال‌زدایی ایجاد کند یا
       رویدادهای خاصی را اجباری سازد.

       SIGHUP
           وادار کردن Tinyproxy به اجرای بازیافت حافظه (garbage collection)
           روی لیست پیوندی اتصالات جاری. این کار معمولاً پس از مدیریت تعداد
           مشخصی از اتصالات، به‌طور خودکار انجام می‌شود.  (فقط در حالت دیمن)

       SIGUSR1
           بارگذاری مجدد اجباری فایل پیکربندی و لیست فیلترها.  این امکان برای
           به‌روزرسانی پیکربندی در حالتی که Tinyproxy در پیش‌زمینه اجرا می‌شود و
           بدون قطع اتصالات فعال، بسیار سودمند است.

فایل‌های قالب (TEMPLATE FILES)
       دو حالت وجود دارد که در آن‌ها Tinyproxy مستقیماً صفحات HTML را به کلاینت
       ارائه می‌دهد:

       •   هنگامی که خطایی رخ دهد، یک صفحه خطای متناظر بازگردانده می‌شود.

       •   هنگامی که درخواستی برای میزبان آمار (stathost) ثبت شود، صفحه‌ای شامل
           خلاصه‌ای از آمار اتصالات بازگردانده می‌شود. (بخش «میزبان آمار
           (STATHOST)» در ادامه را ببینید.)

       چیدمان هر دو صفحه خطا و صفحه آمار را می‌توان از طریق فایل‌های قالب HTML
       قابل‌پیکربندی کنترل کرد؛ این پرونده‌ها صفحات ساده HTML هستند که علاوه‌بر
       این، چند متغیر قالب را نیز شناسایی و تفسیر می‌کنند.

متغیرهای قالب (TEMPLATE VARIABLES)
       چندین متغیر استاندارد HTML وجود دارند که در تمام فایل‌های قالب در دسترس
       هستند:

       request
           خط کامل درخواست HTTP.

       cause
           علت مختصر شرایط بروز خطا.

       clientip
           آدرس IP کلاینت ارسال‌کننده درخواست.

       clienthost
           نام میزبان کلاینت ارسال‌کننده درخواست.

       version
           نسخه Tinyproxy.

       package
           نام بسته. در حال حاضر به 'tinyproxy' ارزیابی می‌شود.

       date
           تاریخ و زمان جاری در قالب HTTP.

       علاوه بر این، تقریباً تمام قالب‌ها از متغیر زیر پشتیبانی می‌کنند:

       detail
           توضیح دقیق و ساده به زبان انگلیسی درباره خطا و دلایل احتمالی وقوع
           آن.

       هنگامی که Tinyproxy نام یک متغیر را درون آکولاد بیابد، برای نمونه
       "{request}"، این مقدار پیش از ارائه صفحه با مقدار متغیر متناظر جایگزین
       می‌شود.

میزبان آمار (STATHOST)
       هنگامی که Tinyproxy یک درخواست HTTP برای میزبانی مشخص -- میزبان آمار
       (stathost) -- دریافت می‌کند، یک صفحه HTML حاوی آمار اتصالات را
       بازمی‌گرداند. نام میزبان آمار به‌طور پیش‌فرض `tinyproxy.stats` است و
       می‌توان آن را در زمان اجرا از طریق متغیر پیکربندی `StatHost` به هر نام
       یا آدرس IP دیگری تغییر داد.

       قالب فایل آمار را می‌توان در زمان اجرا از طریق متغیر پیکربندی `StatFile`
       تغییر داد.

فایل‌ها (FILES)
       /etc/tinyproxy/tinyproxy.conf

       ${localstatedir}/run/tinyproxy/tinyproxy.pid

       /var/log/tinyproxy/tinyproxy.log

اشکالات (BUGS)
       برای گزارش اشکالات در Tinyproxy، لطفاً به نشانی زیر مراجعه کنید:

       <https://tinyproxy.github.io>

همچنین ببینید (SEE ALSO)
       tinyproxy.conf(5)

نویسنده (AUTHOR)
       این صفحه راهنما توسط تیم پروژه Tinyproxy نوشته شده است.

حق نشر (COPYRIGHT)
       حق نشر © 1998-2020 متعلق به نویسندگان Tinyproxy است.

       این برنامه تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) نسخه 2 یا بالاتر
       توزیع می‌شود. برای اطلاعات بیشتر فایل COPYING را ببینید.

Version 1.11.3                    2026-03-09                      TINYPROXY(8)