نام (NAME)

privoxy - پراکسی وب ارتقادهنده حریم خصوصی

خلاصه دستور (SYNOPSIS)

privoxy [--chroot ] [--config-test ] [--help ] [--no-daemon ] [--pidfile pidfile ] [--pre-chroot-nslookup hostname ] [--user user[.group] ] [--version ] [configfile ]

گزینه‌ها (OPTIONS)

Privoxy می‌تواند با گزینه‌های خط فرمان زیر فراخوانی شود:

--chroot

پیش از تغییر به شناسه کاربری داده‌شده در گزینه --user، به دایرکتوری خانگی آن کاربر chroot می‌کند؛ یعنی به هسته شناسانده می‌شود که درخت دایرکتوری فرآیند Privoxy از آنجا آغاز می‌گردد. در صورت پیکربندی دقیق، این کار می‌تواند تاثیر آسیب‌پذیری‌های احتمالی در Privoxy را به فایل‌های موجود در آن سلسله‌مراتب محدود سازد.

--config-test

پس از بارگذاری فایل‌های پیکربندی و پیش از اتصال به آدرس شنود، خارج می‌شود. کد خروج مشخص می‌کند که آیا فایل‌های پیکربندی با موفقیت بارگذاری شده‌اند یا خیر.

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

این گزینه تنظیمات لاگ را تغییر نمی‌دهد؛ در صورتی که نباید از فایل لاگ پیکربندی‌شده استفاده شود، ترکیب آن با "--no-daemon" توصیه می‌شود.

--help

چاپ اطلاعات مختصر نحوه استفاده و خروج.

--no-daemon

تبدیل نشدن به دیمن؛ یعنی عدم fork و رهبر نشدن برای گروه فرآیند، عدم جداسازی از پایانه tty کنترلی و انجام تمامی لاگ‌گیری‌ها در همان پایانه.

--pidfile pidfile

هنگام راه‌اندازی، شناسه فرآیند (PID) را در pidfile می‌نویسد. هنگام خروج، pidfile را حذف می‌کند. عدم موفقیت در ایجاد یا حذف pidfile مهلک نیست. اگر گزینه --pidfile مشخص نشود، هیچ فایل PID استفاده نخواهد شد.

--pre-chroot-nslookup hostname

راه‌اندازی اولیه کتابخانه تحلیل‌گر نام (resolver) با استفاده از hostname پیش از اعمال chroot. در برخی سیستم‌ها این امر تعداد فایل‌هایی که باید به درخت chroot کپی شوند را کاهش می‌دهد.

--user user[.group]

پس از نوشتن (اختیاری) فایل PID، شناسه کاربری user و شناسه گروهی group را بر عهده می‌گیرد؛ یا در صورتی که group اختیاری داده نشده باشد، از گروه پیش‌فرض user استفاده می‌کند. اگر مجوزها برای انجام این کار کافی نباشد، خارج می‌شود.

--version

چاپ اطلاعات نسخه و خروج.

اگر configfile در خط فرمان مشخص نشود، Privoxy به دنبال فایلی به نام config در دایرکتوری جاری خواهد گشت. اگر هیچ configfile یافت نشود، Privoxy در راه‌اندازی شکست می‌خورد.

توضیحات (DESCRIPTION)

برنامه Privoxy یک پراکسی وب بدون کش (non-caching) با قابلیت‌های فیلترینگ پیشرفته برای ارتقای حریم خصوصی، تغییر داده‌های صفحات وب و سرآیندهای HTTP، کنترل دسترسی و حذف تبلیغات و سایر محتوای مزاحم اینترنتی است. Privoxy از پیکربندی منعطفی برخوردار است و می‌تواند مطابق با نیازها و سلایق فردی سفارشی‌سازی شود. این ابزار هم برای سیستم‌های تک‌کاربره مستقل و هم برای شبکه‌های چندکاربره کاربرد دارد.

نرم‌افزار Privoxy یک نرم‌افزار آزاد است که تحت مجوز GNU GPLv2 یا بالاتر ارائه می‌شود.

پروژه Privoxy یکی از پروژه‌های وابسته به سازمان نرم‌افزار در راستای منافع عمومی (SPI) است.

مشارکت و کمک‌های مالی مورد استقبال هستند:

•

https://www.privoxy.org/participate

•

https://www.privoxy.org/donate

نصب و استفاده (INSTALLATION AND USAGE)

مرورگرها را می‌توان به طور جداگانه برای استفاده از Privoxy به عنوان پراکسی HTTP پیکربندی کرد (توصیه می‌شود)، یا Privoxy می‌تواند با یک فیلتر بسته (packet filter) ترکیب شود تا یک پراکسی رهگیر (intercepting proxy) ایجاد نماید (به config مراجعه فرمایید). تنظیم پیش‌فرض برای localhost روی پورت 8118 است (در فایل اصلی کانفیگ قابل تغییر است). برای تنظیم پراکسی HTTP در فایرفاکس، به این مسیر بروید: Tools؛ Options؛ General؛ Connection Settings؛ Manual Proxy Configuration.

برای اینترنت اکسپلورر، به این مسیر بروید: Tools؛ Internet Properties؛ Connections؛ LAN Settings.

پراکسی امن (SSL) نیز باید روی مقادیر یکسان تنظیم شود، در غیر این صورت نشانی‌های https: مشمول پراکسی نخواهند شد. نکته: Privoxy تنها می‌تواند ترافیک HTTP و HTTPS را پراکسی کند. از آن برای FTP یا سایر پروتکل‌ها استفاده نکنید. HTTPS محدودیت‌هایی به همراه دارد و تمام ویژگی‌ها روی اتصالات HTTPS کار نخواهند کرد.

برای سایر مرورگرها به مستندات آن‌ها مراجعه فرمایید.

پیکربندی (CONFIGURATION)

برنامه Privoxy با فایل‌های پیکربندی گوناگون قابل تنظیم است. فایل‌های پیکربندی پیش‌فرض عبارتند از: config، default.filter، default.action و match-all.action. فایل user.action باید برای استثناهای تعریف‌شده محلی نسبت به قوانین پیش‌فرض در match-all.action و default.action، و فایل user.filter برای فیلترهای محلی استفاده شود. این فایل‌ها دارای توضیحات تفصیلی هستند. در سیستم‌های یونیکس و شبه‌یونیکس، این فایل‌ها به‌طور پیش‌فرض در /etc/privoxy/ قرار دارند.

برنامه Privoxy از مفهوم اقدامات (actions) به منظور دستکاری جریان داده بین مرورگر و سایت‌های راه دور استفاده می‌کند. اقدامات گوناگونی با کارکردهای مشخص برای اموری نظیر مسدودسازی وب‌سایت‌ها، مدیریت کوکی‌ها و غیره وجود دارد. این اقدامات می‌توانند به‌صورت تکی یا ترکیبی، و علیه نشانی‌های اینترنتی مجزا یا گروه‌هایی از URLها که با نویسه‌های عام (wildcard) و عبارات باقاعده تعریف می‌شوند، به کار گرفته شوند. در نتیجه، کاربر آزادی و کنترل بسیار بیشتری به دست می‌آورد.

فهرست اقدامات (مسدودسازی تبلیغات و...) را می‌توان از طریق مرورگر وب در نشانی http://config.privoxy.org نیز پیکربندی کرد (به شرطی که پیکربندی اجازه دهد). پارامترهای پیکربندی Privoxy نیز در همین صفحه قابل مشاهده است. علاوه بر این، می‌توان Privoxy را فعال یا غیرفعال نمود. این یک صفحه داخلی است و نیازی به دسترسی به اینترنت ندارد.

برای شرح تفصیلی مراحل نصب، کاربرد عمومی، تمامی گزینه‌های پیکربندی، ویژگی‌های جدید و نکات ارتقا، به User Manual مراجعه کنید.

فایل‌ها (FILES)

/usr/sbin/privoxy
/etc/privoxy/config
/etc/privoxy/match-all.action
/etc/privoxy/default.action
/etc/privoxy/user.action
/etc/privoxy/default.filter
/etc/privoxy/user.filter
/etc/privoxy/trust
/etc/privoxy/templates/*
/var/log/privoxy/logfile

فایل‌های گوناگون دیگری نیز باید گنجانده شوند، اما بسته به بستر اجرایی و پیکربندی ساخت ممکن است متغیر باشند. مستندات تکمیلی باید در دایرکتوری محلی مستندات موجود باشند.

سیگنال‌ها (SIGNALS)

برنامه Privoxy با دریافت سیگنال‌های SIGINT و SIGTERM خاتمه می‌یابد. اسکریپت‌های چرخش لاگ (log rotation) می‌توانند با ارسال SIGHUP به Privoxy موجب بازگشایی مجدد فایل لاگ شوند. توجه داشته باشید که برخلاف سایر دیمن‌ها، Privoxy برای آگاهی از تغییرات فایل‌های پیکربندی نیازی به دریافت SIGHUP ندارد -- تغییرات به‌طور خودکار شناسایی می‌شوند. سیگنال‌هایی غیر از موارد بالا به‌طور صریح مدیریت نشده و به اقدام پیش‌فرض تعیین‌شده توسط سیستم‌عامل منجر خواهند شد.

نکات (NOTES)

لطفاً برای نحوه تماس با توسعه‌دهندگان، درخواست امکانات جدید، گزارش مشکلات و سایر پرسش‌ها به User Manual مراجعه فرمایید.

همچنین ببینید (SEE ALSO)

سایر مراجع و وب‌سایت‌های مورد توجه کاربران Privoxy:

https://www.privoxy.org صفحه اصلی Privoxy.

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

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

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

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

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

تیم توسعه (DEVELOPMENT TEAM)

Fabian Keil، توسعه‌دهنده ارشد
David Schmidt
Lee Rian
Roland Rosenfeld
Ian Silvester

حق نشر و مجوز (COPYRIGHT AND LICENSE)