نام (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)

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