" This manpage has been generated by docbook2man-spec.pl
." (included in the Privoxy source tarball) from a DocBook document.
.TH "PRIVOXY" "8" "02 June 2026" "Privoxy 4.2.0" ""
.SH "نام (NAME)"
privoxy \- پراکسی وب ارتقادهنده حریم خصوصی
.SH "خلاصه دستور (SYNOPSIS)"

\fBprivoxy\fR [\fB\-\-chroot\fR ] [\fB\-\-config-test\fR ] [\fB\-\-help\fR ] [\fB\-\-no-daemon\fR ] [\fB\-\-pidfile \fIpidfile\fB\fR ] [\fB\-\-pre-chroot-nslookup \fIhostname\fB\fR ] [\fB\-\-user \fIuser[.group]\fB\fR ] [\fB\-\-version\fR ] [\fB\fIconfigfile\fB\fR ]

.SH "گزینه‌ها (OPTIONS)"
.PP
\fBPrivoxy\fR می‌تواند با گزینه‌های خط فرمان زیر فراخوانی شود:
.TP
\fB\-\-chroot\fR
پیش از تغییر به شناسه کاربری داده‌شده در گزینه \-\-user، به دایرکتوری خانگی آن کاربر chroot می‌کند؛ یعنی به هسته شناسانده می‌شود که درخت دایرکتوری فرآیند \fBPrivoxy\fR از آنجا آغاز می‌گردد. در صورت پیکربندی دقیق، این کار می‌تواند تاثیر آسیب‌پذیری‌های احتمالی در \fBPrivoxy\fR را به فایل‌های موجود در آن سلسله‌مراتب محدود سازد.
.TP
\fB\-\-config-test\fR
پس از بارگذاری فایل‌های پیکربندی و پیش از اتصال به آدرس شنود، خارج می‌شود. کد خروج مشخص می‌کند که آیا فایل‌های پیکربندی با موفقیت بارگذاری شده‌اند یا خیر.

اگر کد خروج ۱ باشد، حداقل یکی از فایل‌های پیکربندی نامعتبر است؛ اگر ۰ باشد، تمام فایل‌های پیکربندی با موفقیت بارگذاری شده‌اند (اما ممکن است همچنان حاوی خطاهایی باشند که تنها در زمان اجرا قابل تشخیص هستند).

این گزینه تنظیمات لاگ را تغییر نمی‌دهد؛ در صورتی که نباید از فایل لاگ پیکربندی‌شده استفاده شود، ترکیب آن با "--no-daemon" توصیه می‌شود.
.TP
\fB\-\-help\fR
چاپ اطلاعات مختصر نحوه استفاده و خروج.
.TP
\fB\-\-no-daemon\fR
تبدیل نشدن به دیمن؛ یعنی عدم fork و رهبر نشدن برای گروه فرآیند، عدم جداسازی از پایانه tty کنترلی و انجام تمامی لاگ‌گیری‌ها در همان پایانه.
.TP
\fB\-\-pidfile \fIpidfile\fB\fR
هنگام راه‌اندازی، شناسه فرآیند (PID) را در \fIpidfile\fR می‌نویسد.
هنگام خروج، \fIpidfile\fR را حذف می‌کند.
عدم موفقیت در ایجاد یا حذف \fIpidfile\fR مهلک نیست. اگر گزینه \fB\-\-pidfile\fR مشخص نشود، هیچ فایل PID استفاده نخواهد شد.
.TP
\fB\-\-pre-chroot-nslookup \fIhostname\fB\fR
راه‌اندازی اولیه کتابخانه تحلیل‌گر نام (resolver) با استفاده از \fIhostname\fR پیش از اعمال chroot. در برخی سیستم‌ها این امر تعداد فایل‌هایی که باید به درخت chroot کپی شوند را کاهش می‌دهد.
.TP
\fB\-\-user \fIuser[.group]\fB\fR
پس از نوشتن (اختیاری) فایل PID، شناسه کاربری \fIuser\fR و شناسه گروهی \fIgroup\fR را بر عهده می‌گیرد؛ یا در صورتی که \fIgroup\fR اختیاری داده نشده باشد، از گروه پیش‌فرض \fIuser\fR استفاده می‌کند. اگر مجوزها برای انجام این کار کافی نباشد، خارج می‌شود.
.TP
\fB\-\-version\fR
چاپ اطلاعات نسخه و خروج.
.PP
اگر \fIconfigfile\fR در خط فرمان مشخص نشود، \fBPrivoxy\fR به دنبال فایلی به نام \fIconfig\fR در دایرکتوری جاری خواهد گشت. اگر هیچ \fIconfigfile\fR یافت نشود، \fBPrivoxy\fR در راه‌اندازی شکست می‌خورد.
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه Privoxy یک پراکسی وب بدون کش (non-caching) با قابلیت‌های فیلترینگ پیشرفته برای ارتقای حریم خصوصی، تغییر داده‌های صفحات وب و سرآیندهای HTTP، کنترل دسترسی و حذف تبلیغات و سایر محتوای مزاحم اینترنتی است. Privoxy از پیکربندی منعطفی برخوردار است و می‌تواند مطابق با نیازها و سلایق فردی سفارشی‌سازی شود. این ابزار هم برای سیستم‌های تک‌کاربره مستقل و هم برای شبکه‌های چندکاربره کاربرد دارد.
.PP
نرم‌افزار Privoxy یک نرم‌افزار آزاد است که تحت مجوز GNU GPLv2 یا بالاتر ارائه می‌شود.
.PP
پروژه Privoxy یکی از پروژه‌های وابسته به سازمان نرم‌افزار در راستای منافع عمومی (SPI) است.
.PP
مشارکت و کمک‌های مالی مورد استقبال هستند:
.PP
.TP 0.2i
\(bu
https://www.privoxy.org/participate
.TP 0.2i
\(bu
https://www.privoxy.org/donate
.SH "نصب و استفاده (INSTALLATION AND USAGE)"
.PP
مرورگرها را می‌توان به طور جداگانه برای استفاده از \fBPrivoxy\fR به عنوان پراکسی HTTP پیکربندی کرد (توصیه می‌شود)، یا \fBPrivoxy\fR می‌تواند با یک فیلتر بسته (packet filter) ترکیب شود تا یک پراکسی رهگیر (intercepting proxy) ایجاد نماید (به \fIconfig\fR مراجعه فرمایید). تنظیم پیش‌فرض برای localhost روی پورت 8118 است (در فایل اصلی کانفیگ قابل تغییر است). برای تنظیم پراکسی HTTP در فایرفاکس، به این مسیر بروید:
\fBTools\fR؛
\fBOptions\fR؛
\fBGeneral\fR؛
\fBConnection Settings\fR؛
\fBManual Proxy Configuration\fR.
.PP
برای اینترنت اکسپلورر، به این مسیر بروید:
\fBTools\fR؛
\fBInternet Properties\fR؛
\fBConnections\fR؛
\fBLAN Settings\fR.
.PP
پراکسی امن (SSL) نیز باید روی مقادیر یکسان تنظیم شود، در غیر این صورت نشانی‌های https: مشمول پراکسی نخواهند شد. نکته: \fBPrivoxy\fR تنها می‌تواند ترافیک HTTP و HTTPS را پراکسی کند. از آن برای FTP یا سایر پروتکل‌ها استفاده نکنید. HTTPS محدودیت‌هایی به همراه دارد و تمام ویژگی‌ها روی اتصالات HTTPS کار نخواهند کرد.
.PP
برای سایر مرورگرها به مستندات آن‌ها مراجعه فرمایید.
.SH "پیکربندی (CONFIGURATION)"
.PP
برنامه \fBPrivoxy\fR با فایل‌های پیکربندی گوناگون قابل تنظیم است. فایل‌های پیکربندی پیش‌فرض عبارتند از:
\fIconfig\fR،
\fIdefault.filter\fR،
\fIdefault.action\fR و
\fImatch-all.action\fR.
فایل \fIuser.action\fR باید برای استثناهای تعریف‌شده محلی نسبت به قوانین پیش‌فرض در \fImatch-all.action\fR و \fIdefault.action\fR، و فایل \fIuser.filter\fR برای فیلترهای محلی استفاده شود. این فایل‌ها دارای توضیحات تفصیلی هستند. در سیستم‌های یونیکس و شبه‌یونیکس، این فایل‌ها به‌طور پیش‌فرض در \fI/etc/privoxy/\fR قرار دارند.
.PP
برنامه \fBPrivoxy\fR از مفهوم \fBاقدامات (actions)\fR به منظور دستکاری جریان داده بین مرورگر و سایت‌های راه دور استفاده می‌کند. اقدامات گوناگونی با کارکردهای مشخص برای اموری نظیر مسدودسازی وب‌سایت‌ها، مدیریت کوکی‌ها و غیره وجود دارد. این اقدامات می‌توانند به‌صورت تکی یا ترکیبی، و علیه نشانی‌های اینترنتی مجزا یا گروه‌هایی از URLها که با نویسه‌های عام (wildcard) و عبارات باقاعده تعریف می‌شوند، به کار گرفته شوند. در نتیجه، کاربر آزادی و کنترل بسیار بیشتری به دست می‌آورد.
.PP
فهرست اقدامات (مسدودسازی تبلیغات و...) را می‌توان از طریق مرورگر وب در نشانی
http://config.privoxy.org
نیز پیکربندی کرد (به شرطی که پیکربندی اجازه دهد). پارامترهای پیکربندی \fBPrivoxy\fR نیز در همین صفحه قابل مشاهده است. علاوه بر این، می‌توان \fBPrivoxy\fR را فعال یا غیرفعال نمود. این یک صفحه داخلی است و نیازی به دسترسی به اینترنت ندارد.
.PP
برای شرح تفصیلی مراحل نصب، کاربرد عمومی، تمامی گزینه‌های پیکربندی، ویژگی‌های جدید و نکات ارتقا، به \fIUser Manual\fR مراجعه کنید.
.SH "فایل‌ها (FILES)"

.nf
 \fI/usr/sbin/privoxy\fR
 \fI/etc/privoxy/config\fR
 \fI/etc/privoxy/match-all.action\fR
 \fI/etc/privoxy/default.action\fR
 \fI/etc/privoxy/user.action\fR
 \fI/etc/privoxy/default.filter\fR
 \fI/etc/privoxy/user.filter\fR
 \fI/etc/privoxy/trust\fR
 \fI/etc/privoxy/templates/*\fR
 \fI/var/log/privoxy/logfile\fR
.fi
.PP
فایل‌های گوناگون دیگری نیز باید گنجانده شوند، اما بسته به بستر اجرایی و پیکربندی ساخت ممکن است متغیر باشند. مستندات تکمیلی باید در دایرکتوری محلی مستندات موجود باشند.
.SH "سیگنال‌ها (SIGNALS)"
.PP
برنامه \fBPrivoxy\fR با دریافت سیگنال‌های \fBSIGINT\fR و \fBSIGTERM\fR خاتمه می‌یابد. اسکریپت‌های چرخش لاگ (log rotation) می‌توانند با ارسال \fBSIGHUP\fR به \fBPrivoxy\fR موجب بازگشایی مجدد فایل لاگ شوند. توجه داشته باشید که برخلاف سایر دیمن‌ها، \fBPrivoxy\fR برای آگاهی از تغییرات فایل‌های پیکربندی نیازی به دریافت \fBSIGHUP\fR ندارد \-- تغییرات به‌طور خودکار شناسایی می‌شوند. سیگنال‌هایی غیر از موارد بالا به‌طور صریح مدیریت نشده و به اقدام پیش‌فرض تعیین‌شده توسط سیستم‌عامل منجر خواهند شد.
.SH "نکات (NOTES)"
.PP
لطفاً برای نحوه تماس با توسعه‌دهندگان، درخواست امکانات جدید، گزارش مشکلات و سایر پرسش‌ها به \fIUser Manual\fR مراجعه فرمایید.
.SH "همچنین ببینید (SEE ALSO)"
.PP
سایر مراجع و وب‌سایت‌های مورد توجه کاربران \fBPrivoxy\fR:

https://www.privoxy.org
صفحه اصلی \fBPrivoxy\fR.

https://www.privoxy.org/faq
پرسش‌های متداول \fBPrivoxy\fR.

https://www.privoxy.org/developer-manual
راهنمای توسعه‌دهندگان \fBPrivoxy\fR.

https://sourceforge.net/projects/ijbswa
صفحه پروژه \fBPrivoxy\fR در SourceForge.

http://config.privoxy.org
رابط کاربری مبتنی بر وب. برای کارکرد این بخش، \fBPrivoxy\fR باید در حال اجرا باشد. میانبر: http://p.p

https://sourceforge.net/p/ijbswa/actionsfile-feedback
برای ارسال بازخوردها و سایر پیشنهادات مربوط به پیکربندی به توسعه‌دهندگان.
.SH "تیم توسعه (DEVELOPMENT TEAM)"

.nf
 Fabian Keil، توسعه‌دهنده ارشد
 David Schmidt
 Lee Rian
 Roland Rosenfeld
 Ian Silvester
.fi
.SH "حق نشر و مجوز (COPYRIGHT AND LICENSE)"
.SS "حق نشر (COPYRIGHT)"
.PP
حق نشر (C) ۲۰۰۱-۲۰۲۶ توسط توسعه‌دهندگان Privoxy <privoxy-devel@lists.privoxy.org>
.PP
بخشی از کد منبع مبتنی بر کدی با حق نشر (C) ۱۹۹۷ توسط Anonymous Coders و Junkbusters, Inc. است.
.SS "مجوز (LICENSE)"
.PP
نرم‌افزار \fBPrivoxy\fR نرم‌افزار آزاد است؛ شما می‌توانید کد منبع آن را تحت شرایط \fIGNU General Public License\fR همان‌گونه که توسط بنیاد نرم‌افزار آزاد منتشر شده است، چه نسخه ۲ مجوز یا (به انتخاب خودتان) هر نسخه بعدی بازتوزیع کرده یا تغییر دهید.
.PP
همین امر برای فایل‌های باینری \fBPrivoxy\fR نیز صادق است، مگر آنکه با نسخه‌ای از mbed TLS یا OpenSSL پیوند شده باشند که تحت مجوز Apache 2.0 باشد یا در برابر نسخه‌ای از wolfSSL تحت مجوز GPL 3 پیوند داده شده باشند که در آن صورت می‌توانید باینری‌های \fBPrivoxy\fR را تحت شرایط \fIGNU General Public License\fR نسخه ۳ یا هر نسخه بعدی بازتوزیع کرده یا تغییر دهید.
.PP
نرم‌افزار \fBPrivoxy\fR به این امید توزیع شده است که مفید واقع شود، اما بدون هرگونه ضمانت؛ حتی بدون ضمانت ضمنی قابلیت فروش یا تناسب برای یک هدف مشخص. برای جزئیات به \fIlicense\fR مراجعه نمایید.