VFS_VIRUSFILTER(8) ابزارهای مدیریت سیستم VFS_VIRUSFILTER(8)

vfs_virusfilter - پویشگر ویروس هنگام دسترسی برای سامبا

vfs objects = virusfilter

این ماژول مجموعه‌ای از ماژول‌های مختلف VFS سامبا است که با استفاده از یک پویشگر ضدویروس، پرونده‌های آلوده به ویروس را روی سرویس‌های پرونده سامبا پویش و پالایش می‌کند.

این ماژول پشته‌پذیر (stackable) است و قابلیت ترکیب با دیگر ماژول‌ها را دارد.

virusfilter:scanner

موتور پویش ضدویروس.
•sophos، پویشگر ضدویروس Sophos
•fsav، پویشگر ضدویروس F-Secure
•clamav، پویشگر ضدویروس ClamAV
•dummy، پویشگر ساختگی مورد استفاده در آزمون‌ها. مقادیر را با پارامتر infected files بررسی کرده و هر نام منطبق را به عنوان آلوده علامت‌گذاری می‌کند.

virusfilter:socket path = PATH

مسیر سوکت محلی برای پویشگر ویروس.

اگر این گزینه تنظیم نشود، مسیر پیش‌فرض به موتور پویش ضدویروس پیکربندی‌شده بستگی دارد.

برای بک‌اند sophos مسیر پیش‌فرض /var/run/savdi/sssp.sock است.

برای بک‌اند fsav مسیر پیش‌فرض /tmp/.fsav-0 است.

برای بک‌اند clamav مسیر پیش‌فرض /var/run/clamav/clamd.ctl است.

virusfilter:connect timeout = 30000

مدت زمان انتظار برای برقراری اتصال به فرایند پویشگر ویروس پیش از اتمام مهلت زمانی (timeout) را تعیین می‌کند. مقدار به میلی‌ثانیه است.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 30000 است.

virusfilter:io timeout = 60000

مدت زمان انتظار برای ارتباط با فرایند پویشگر ویروس پیش از اتمام مهلت زمانی را کنترل می‌کند. مقدار به میلی‌ثانیه است.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 60000 است.

virusfilter:scan on open = yes

این گزینه تعیین می‌کند که آیا پرونده‌ها هنگام باز شدن پویش شوند یا خیر.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض yes است.

virusfilter:scan on close = no

این گزینه تعیین می‌کند که آیا پرونده‌ها هنگام بسته شدن پویش شوند یا خیر.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض no است.

virusfilter:max file size = 100000000

بزرگ‌ترین اندازه پرونده برحسب بایت است که پویش خواهد شد.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 100MB است.

virusfilter:min file size = 10

کوچک‌ترین اندازه پرونده برحسب بایت است که پویش خواهد شد.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 10 است.

virusfilter:infected file action = nothing

اقدامی که باید در برابر یک پرونده آلوده انجام شود. گزینه‌ها عبارتند از nothing (هیچ‌کدام)، quarantine (قرنطینه)، rename (تغییر نام) و delete (حذف).

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض nothing است.

virusfilter:infected file errno on open = EACCES

کد خطایی (errno) که در صورت آلوده بودن پرونده هنگام باز شدن بازگردانده می‌شود.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض EACCES است.

virusfilter:infected file errno on close = 0

کد خطایی (errno) که در صورت آلوده بودن پرونده هنگام بسته شدن بازگردانده می‌شود.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 0 است.

virusfilter:quarantine directory = PATH

مسیری که پرونده‌های آلوده باید به آن منتقل شوند. این مسیر باید یک مسیر مطلق باشد.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض ".quarantine" به صورت نسبی نسبت به مسیر اشتراک است.

virusfilter:quarantine prefix = virusfilter.

پیشوند پرونده‌های قرنطینه‌شده.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض "virusfilter." است.

virusfilter:quarantine suffix = .infected

پسوند پرونده‌های قرنطینه‌شده. این گزینه تنها زمانی استفاده می‌شود که keep name برابر با true باشد؛ در غیر این صورت نادیده گرفته می‌شود.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض ".infected" است.

virusfilter:rename prefix = virusfilter.

پیشوند پرونده‌های آلوده.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض "virusfilter." است.

virusfilter:rename suffix = .infected

پسوند پرونده‌های آلوده.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض ".infected" است.

virusfilter:quarantine keep tree = yes

اگر keep tree فعال باشد، ساختار دایرکتوری نسبت به مسیر اشتراک در دایرکتوری قرنطینه حفظ می‌شود.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض yes است.

virusfilter:quarantine keep name = yes

آیا نام پرونده، به جز افزودن پسوند و/یا پیشوند و یک نام پسوند تصادفی مطابق با تعاریف virusfilter:rename prefix و virusfilter:rename suffix، بدون تغییر باقی بماند یا خیر.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض yes است.

virusfilter:infected file command = @SAMBA_DATADIR@/bin/virusfilter-notify --mail-to virusmaster@example.com --cc "%U@example.com" --from samba@example.com --subject-prefix "Samba: Infected File: "

دستور خارجی برای اجرا هنگام پیدا شدن پرونده آلوده.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض none است.

virusfilter:scan archive = true

این گزینه تعیین می‌کند که آیا بایگانی‌ها (فایل‌های فشرده) پویش شوند یا خیر.

پویشگرهای Sophos و F-Secure از این گزینه پشتیبانی می‌کنند و پیش‌فرض آن false است.

virusfilter:max nested scan archive = 1

این گزینه حداکثر عمق را برای جستجوی بایگانی‌های تو در تو تعیین می‌کند.

پویشگرهای Sophos و F-Secure از این گزینه پشتیبانی می‌کنند و مقدار پیش‌فرض آن 1 است.

virusfilter:scan mime = true

این گزینه تعیین می‌کند که آیا پرونده‌های mime پویش شوند یا خیر.

تنها پویشگر fsav از این گزینه پشتیبانی می‌کند و مقدار پیش‌فرض آن false است.

virusfilter:scan error command = @SAMBA_DATADIR@/bin/virusfilter-notify --mail-to virusmaster@example.com --from samba@example.com --subject-prefix "Samba: Scan Error: "

دستور خارجی برای اجرا هنگام وقوع خطای پویش.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض none است.

virusfilter:exclude files = empty

پرونده‌هایی که باید از پویش مستثنی شوند.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض empty است.

virusfilter:infected files = empty

پرونده‌هایی که پویشگر dummy در virusfilter آن‌ها را به عنوان آلوده علامت‌گذاری می‌کند.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض empty است.

virusfilter:block access on error = false

تعیین می‌کند که آیا در صورت بروز خطای پویش، دسترسی باید مسدود شود یا خیر.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض false است.

virusfilter:scan error errno on open = EACCES

کد خطایی (errno) که در صورت بروز خطا در پویش پرونده و true بودن block access on error، هنگام باز شدن پرونده بازگردانده می‌شود.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض EACCES است.

virusfilter:scan error errno on close = 0

کد خطایی (errno) که در صورت بروز خطا در پویش پرونده و true بودن block access on error، هنگام بسته شدن پرونده بازگردانده می‌شود.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 0 است.

virusfilter:cache entry limit = 100

حداکثر تعداد مدخل‌ها در حافظه نهان نتایج پویش. با توجه به نحوه عملکرد memcache در سامبا، این مقدار تقریبی است.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 100 است.

virusfilter:cache time limit = 10

حداکثر زمانی (به ثانیه) که یک نتیجه پویش در حافظه نهان نتایج باقی خواهد ماند. مقدار -1 محدودیت را غیرفعال می‌کند. مقدار 0 نهان‌سازی را غیرفعال می‌کند.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 10 است.

virusfilter:quarantine directory mode = 0755

حالت مبنای هشت (اکتال) برای دایرکتوری قرنطینه و زیردایرکتوری‌های آن هنگام ایجاد.

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض 0755 یا S_IRUSR | S_IWUSR | S_IXUSR | S_IRGRP | S_IXGRP | S_IROTH | S_IXOTH است.

مجوزها باید به گونه‌ای باشند که همه کاربران بتوانند بخوانند و جستجو کنند؛ یعنی تا زمانی که دقیقاً نمی‌دانید چه کاری انجام می‌دهید، این مقدار را دستکاری نکنید.

virusfilter:block suspected file = false

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

اگر این گزینه تنظیم نشود، مقدار پیش‌فرض false است.

این ماژول می‌تواند جریان‌های داده‌ای غیر از جریان پیش‌فرض را نیز پویش کند، مشروط بر آن‌که جریان‌های متناوب داده هر یک در قالب پرونده‌های جداگانه ذخیره و پشتیبانی شوند، مانند عملکرد ماژول vfs با نام streams_depot.

برای کارکرد صحیح، ماژول پشتیبانی از جریان‌ها باید پیش از ماژول virusfilter در فهرست vfs objects قرار گیرد (یعنی streams_depot باید قبل از ماژول virusfilter فراخوانی شود).

این ماژول با ارائه قابلیت پویش ویروس روی سرور، با هدف ایجاد دفاع در عمق (defense in depth) طراحی شده است. این ماژول برای استفاده به جای امنیت مناسب مبتنی بر کلاینت در نظر گرفته نشده است. ماژول‌های امنیتی دیگری نیز ممکن است وجود داشته باشند که برای دفاع در عمق روی سرور سودمند باشند.

نرم‌افزار اصلی سامبا و ابزارهای مرتبط با آن توسط Andrew Tridgell ساخته شده‌اند. سامبا اکنون توسط تیم سامبا (Samba Team) به عنوان یک پروژه متن‌باز مشابه نحوه توسعه هسته لینوکس توسعه داده می‌شود.

08/16/2026 Samba 4.8