.\" -*- 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 "TINYPROXY 8" .TH TINYPROXY 8 2026-03-09 "Version 1.11.3" "Tinyproxy manual" .\" 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)" tinyproxy \- دیمن پروکسی HTTP سبک‌وزن .SH "خلاصه دستور (SYNOPSIS)" .IX Header "SYNOPSIS" \&\fBtinyproxy\fR [\-vdch] .SH "توضیحات (DESCRIPTION)" .IX Header "DESCRIPTION" \&\fBtinyproxy\fR یک دیمن پروکسی HTTP سبک‌وزن است که برای مصرف حداقل منابع سیستمی طراحی شده است. این برنامه روی یک پورت TCP مشخص به اتصالات گوش فرا می‌دهد و درخواست‌های پروکسی HTTP را مدیریت می‌کند. با طراحی از پایه برای سریع و در عین حال کوچک بودن، یک راه‌حل ایده‌آل برای مواردی همچون استقرارهای تعبیه‌شده (embedded) است که در آن‌ها به یک پروکسی HTTP با امکانات کامل نیاز است، اما منابع سیستمی برای پروکسی‌های بزرگ‌تر در دسترس نیست. .SH "گزینه‌ها (OPTIONS)" .IX Header "OPTIONS" \&\fBtinyproxy\fR گزینه‌های زیر را می‌پذیرد: .IP "\fB\-c " 4 .IX Item "-c " استفاده از یک فایل پیکربندی جایگزین. .IP \fB\-d\fR 4 .IX Item "-d" عدم اجرای پس‌زمینه (دیمن نشدن) و ماندن در پیش‌زمینه. برای اهداف اشکال‌زدایی مفید است. .IP \fB\-h\fR 4 .IX Item "-h" نمایش یک صفحه راهنمای کوتاه از آرگومان‌های خط فرمان و خروج. .IP \fB\-v\fR 4 .IX Item "-v" نمایش اطلاعات نسخه و خروج. .SH "سیگنال‌ها (SIGNALS)" .IX Header "SIGNALS" علاوه بر گزینه‌های خط فرمان، چندین سیگنال نیز وجود دارند که می‌توان در حین اجرا به \fBtinyproxy\fR ارسال کرد تا اطلاعات اشکال‌زدایی ایجاد کند یا رویدادهای خاصی را اجباری سازد. .IP \fBSIGHUP\fR 4 .IX Item "SIGHUP" وادار کردن Tinyproxy به اجرای بازیافت حافظه (garbage collection) روی لیست پیوندی اتصالات جاری. این کار معمولاً پس از مدیریت تعداد مشخصی از اتصالات، به‌طور خودکار انجام می‌شود. (فقط در حالت دیمن) .IP \fBSIGUSR1\fR 4 .IX Item "SIGUSR1" بارگذاری مجدد اجباری فایل پیکربندی و لیست فیلترها. این امکان برای به‌روزرسانی پیکربندی در حالتی که Tinyproxy در پیش‌زمینه اجرا می‌شود و بدون قطع اتصالات فعال، بسیار سودمند است. .SH "فایل‌های قالب (TEMPLATE FILES)" .IX Header "TEMPLATE FILES" دو حالت وجود دارد که در آن‌ها Tinyproxy مستقیماً صفحات HTML را به کلاینت ارائه می‌دهد: .IP \(bu 4 هنگامی که خطایی رخ دهد، یک صفحه خطای متناظر بازگردانده می‌شود. .IP \(bu 4 هنگامی که درخواستی برای میزبان آمار (stathost) ثبت شود، صفحه‌ای شامل خلاصه‌ای از آمار اتصالات بازگردانده می‌شود. (بخش «میزبان آمار (STATHOST)» در ادامه را ببینید.) .PP چیدمان هر دو صفحه خطا و صفحه آمار را می‌توان از طریق فایل‌های قالب HTML قابل‌پیکربندی کنترل کرد؛ این پرونده‌ها صفحات ساده HTML هستند که علاوه‌بر این، چند متغیر قالب را نیز شناسایی و تفسیر می‌کنند. .SH "متغیرهای قالب (TEMPLATE VARIABLES)" .IX Header "TEMPLATE VARIABLES" چندین متغیر استاندارد HTML وجود دارند که در تمام فایل‌های قالب در دسترس هستند: .IP \fBrequest\fR 4 .IX Item "request" خط کامل درخواست HTTP. .IP \fBcause\fR 4 .IX Item "cause" علت مختصر شرایط بروز خطا. .IP \fBclientip\fR 4 .IX Item "clientip" آدرس IP کلاینت ارسال‌کننده درخواست. .IP \fBclienthost\fR 4 .IX Item "clienthost" نام میزبان کلاینت ارسال‌کننده درخواست. .IP \fBversion\fR 4 .IX Item "version" نسخه Tinyproxy. .IP \fBpackage\fR 4 .IX Item "package" نام بسته. در حال حاضر به \*(Aqtinyproxy\*(Aq ارزیابی می‌شود. .IP \fBdate\fR 4 .IX Item "date" تاریخ و زمان جاری در قالب HTTP. .PP علاوه بر این، تقریباً تمام قالب‌ها از متغیر زیر پشتیبانی می‌کنند: .IP \fBdetail\fR 4 .IX Item "detail" توضیح دقیق و ساده به زبان انگلیسی درباره خطا و دلایل احتمالی وقوع آن. .PP هنگامی که Tinyproxy نام یک متغیر را درون آکولاد بیابد، برای نمونه "{request}"، این مقدار پیش از ارائه صفحه با مقدار متغیر متناظر جایگزین می‌شود. .SH "میزبان آمار (STATHOST)" .IX Header "STATHOST" هنگامی که Tinyproxy یک درخواست HTTP برای میزبانی مشخص \-\- میزبان آمار (stathost) \-\- دریافت می‌کند، یک صفحه HTML حاوی آمار اتصالات را بازمی‌گرداند. نام میزبان آمار به‌طور پیش‌فرض \`tinyproxy.stats\` است و می‌توان آن را در زمان اجرا از طریق متغیر پیکربندی \&\`StatHost\` به هر نام یا آدرس IP دیگری تغییر داد. .PP قالب فایل آمار را می‌توان در زمان اجرا از طریق متغیر پیکربندی \`StatFile\` تغییر داد. .SH "فایل‌ها (FILES)" .IX Header "FILES" \&\fI/etc/tinyproxy/tinyproxy.conf\fR .PP \&\fI${localstatedir}/run/tinyproxy/tinyproxy.pid\fR .PP \&\fI/var/log/tinyproxy/tinyproxy.log\fR .SH "اشکالات (BUGS)" .IX Header "BUGS" برای گزارش اشکالات در Tinyproxy، لطفاً به نشانی زیر مراجعه کنید: .PP .SH "همچنین ببینید (SEE ALSO)" .IX Header "SEE ALSO" \&\fBtinyproxy.conf\fR\|(5) .SH "نویسنده (AUTHOR)" .IX Header "AUTHOR" این صفحه راهنما توسط تیم پروژه Tinyproxy نوشته شده است. .SH "حق نشر (COPYRIGHT)" .IX Header "COPYRIGHT" حق نشر \(co 1998\-2020 متعلق به نویسندگان Tinyproxy است. .PP این برنامه تحت شرایط مجوز عمومی همگانی گنو (GNU GPL) نسخه 2 یا بالاتر توزیع می‌شود. برای اطلاعات بیشتر فایل COPYING را ببینید.