نام (NAME)

hblock - مسدودسازی تبلیغات، ردیاب‌ها و بدافزارها از طریق ساخت فایل hosts

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

hblock [OPTION]...

توضیحات (DESCRIPTION)

برنامه hBlock یک اسکریپت شل سازگار با استاندارد POSIX است که فهرستی از دامنه‌های ارائه‌دهنده تبلیغات، اسکریپت‌های ردیابی و بدافزارها را از منابع متعدد دریافت کرده و یک فایل hosts (در میان سایر قالب‌ها) می‌سازد که از اتصال سیستم شما به آن‌ها جلوگیری می‌کند.

گزینه‌ها (OPTIONS)

-O, --output <FILE|->, ${HBLOCK_OUTPUT_FILE}

محل ذخیره فایل خروجی.

اگر برابر با "-" باشد، در خروجی استاندارد چاپ می‌شود.

(پیش‌فرض: /etc/hosts)

-H, --header <FILE|builtin|none|->, ${HBLOCK_HEADER_FILE}

فایلی که در ابتدای فایل خروجی گنجانده می‌شود.

اگر برابر با "builtin" باشد، از مقدار توکار استفاده می‌شود.

اگر برابر با "none" باشد، یک مقدار خالی به کار می‌رود.

اگر برابر با "-" باشد، از محتوای ورودی استاندارد استفاده می‌شود.

در صورت مشخص نشدن و در صورتی که هر یک از فایل‌های زیر وجود داشته باشد، محتوای آن استفاده می‌شود:

${XDG_CONFIG_HOME}/hblock/header

/etc/hblock/header

(پیش‌فرض: builtin)

-F, --footer <FILE|builtin|none|->, ${HBLOCK_FOOTER_FILE}

فایلی که در انتهای فایل خروجی گنجانده می‌شود.

اگر برابر با "builtin" باشد، از مقدار توکار استفاده می‌شود.

اگر برابر با "none" باشد، یک مقدار خالی به کار می‌رود.

اگر برابر با "-" باشد، از محتوای ورودی استاندارد استفاده می‌شود.

در صورت مشخص نشدن و در صورتی که هر یک از فایل‌های زیر وجود داشته باشد، محتوای آن استفاده می‌شود:

${XDG_CONFIG_HOME}/hblock/footer

/etc/hblock/footer

(پیش‌فرض: builtin)

-S, --sources <FILE|builtin|none|->, ${HBLOCK_SOURCES_FILE}

فایلی با نشانی‌های اینترنتی جداشده با خط جدید برای تولید فهرست مسدودسازی.

اگر برابر با "builtin" باشد، از مقدار توکار استفاده می‌شود.

اگر برابر با "none" باشد، یک مقدار خالی به کار می‌رود.

اگر برابر با "-" باشد، از محتوای ورودی استاندارد استفاده می‌شود.

در صورت مشخص نشدن و در صورتی که هر یک از فایل‌های زیر وجود داشته باشد، محتوای آن استفاده می‌شود:

${XDG_CONFIG_HOME}/hblock/sources.list

/etc/hblock/sources.list

(پیش‌فرض: builtin)

-A, --allowlist <FILE|builtin|none|->, ${HBLOCK_ALLOWLIST_FILE}

فایلی با مدخل‌های جداشده با خط جدید جهت حذف از فهرست مسدودسازی (فهرست مجاز).

اگر برابر با "builtin" باشد، از مقدار توکار استفاده می‌شود.

اگر برابر با "none" باشد، یک مقدار خالی به کار می‌رود.

اگر برابر با "-" باشد، از محتوای ورودی استاندارد استفاده می‌شود.

در صورت مشخص نشدن و در صورتی که هر یک از فایل‌های زیر وجود داشته باشد، محتوای آن استفاده می‌شود:

${XDG_CONFIG_HOME}/hblock/allow.list

/etc/hblock/allow.list

(پیش‌فرض: builtin)

-D, --denylist <FILE|builtin|none|->, ${HBLOCK_DENYLIST_FILE}

فایلی با مدخل‌های جداشده با خط جدید جهت افزودن به فهرست مسدودسازی (فهرست مسدود).

اگر برابر با "builtin" باشد، از مقدار توکار استفاده می‌شود.

اگر برابر با "none" باشد، یک مقدار خالی به کار می‌رود.

اگر برابر با "-" باشد، از محتوای ورودی استاندارد استفاده می‌شود.

در صورت مشخص نشدن و در صورتی که هر یک از فایل‌های زیر وجود داشته باشد، محتوای آن استفاده می‌شود:

${XDG_CONFIG_HOME}/hblock/deny.list

/etc/hblock/deny.list

(پیش‌فرض: builtin)

-R, --redirection <REDIRECTION>, ${HBLOCK_REDIRECTION}

بازهدایت برای تمامی مدخل‌های موجود در فهرست مسدودسازی.

(پیش‌فرض: 0.0.0.0)

-W, --wrap <NUMBER>, ${HBLOCK_WRAP}

شکستن خطوط فهرست مسدودسازی پس از این تعداد مدخل.

(پیش‌فرض: 1)

-T, --template <TEMPLATE>, ${HBLOCK_TEMPLATE}

الگوی اعمال‌شده به هر مدخل.

%D = <DOMAIN>، %R = <REDIRECTION>

(پیش‌فرض: %R %D)

-C, --comment <COMMENT>, ${HBLOCK_COMMENT}

نویسه مورد استفاده برای یادداشت‌ها.

(پیش‌فرض: #)

-l, --[no-]lenient, ${HBLOCK_LENIENT}

تطبیق تمام مدخل‌ها از منابع بدون در نظر گرفتن IP آن‌ها، به جای 0.0.0.0، 127.0.0.1، ::، ::1 یا هیچ.

(پیش‌فرض: false)

-r, --[no-]regex, ${HBLOCK_REGEX}

استفاده از عبارات باقاعده پایه POSIX در فهرست مجاز به جای رشته‌های ثابت.

(پیش‌فرض: false)

-f, --[no-]filter-subdomains, ${HBLOCK_FILTER_SUBDOMAINS}

عدم درج زیردامنه‌ها زمانی که دامنه والد نیز مسدود شده است. این گزینه برای کاهش اندازه فهرست مسدودسازی در مواردی مانند مسدودسازی DNS که این زیردامنه‌ها را زاید می‌سازد مفید است.

(پیش‌فرض: false)

-n, --retry <NUMBER>, ${HBLOCK_RETRY}

تعداد دفعات تلاش مجدد برای یک بارگیری ناموفق.

(پیش‌فرض: 0)

-c, --[no-]continue, ${HBLOCK_CONTINUE}

عدم انصراف در صورت بروز خطای بارگیری.

(پیش‌فرض: false)

-p, --parallel, ${HBLOCK_PARALLEL}

بیشینه همزمانی برای بارگیری‌های موازی.

(پیش‌فرض: 4)

-q, --[no-]quiet, ${HBLOCK_QUIET}

عدم نمایش پیام‌های غیرخطا.

(پیش‌فرض: false)

-x, --color <auto|true|false>, ${HBLOCK_COLOR}

رنگی کردن خروجی.

(پیش‌فرض: auto)

-v, --version

نمایش شماره نسخه و خروج.

-h, --help

نمایش این راهنما و خروج.

گزارش باگ‌ها (REPORTING BUGS)

گزارش اشکالات به: https://github.com/hectorm/hblock/issues

نویسنده: Héctor Molinero Fernández <hector@molinero.dev>
مجوز: MIT، https://opensource.org/licenses/MIT
مخزن: https://github.com/hectorm/hblock