ملف Readme الخاص بـ clamtk

ملاحظة: لم يعد هذا البرنامج قيد الصيانة.
https://gitlab.com/dave_m/clamtk/-/issues/144

تمت آخر مراجعة أو تحديث لملف README هذا في 20240402.

جدول المحتويات:

1. حول
2. المساهمة
3. التثبيت
4. الاستخدام
5. الإضافات
6. استكشاف الأخطاء وإصلاحها
7. أخرى
8. شكرًا
9. الاتصال

حول

clamtk هو واجهة أمامية لـ ClamAV (مضاد الفيروسات Clam). وهو مصمم ليكون ماسحًا ضوئيًا سهل الاستخدام وخفيف الوزن ويعمل عند الطلب لأنظمة Linux.

على الرغم من أن أقدم نسخ clamtk تعود إلى عام 2003، فقد تم رفع clamtk لأول مرة للتوزيع في عام 2004 إلى حساب على rootshell.be وأخيرًا إلى Sourceforge.net في عام 2005. وفي نهاية عام 2013، تم نقله إلى صفحة Google Code، ثم إلى Github وGitlab وBitbucket. نحن الآن في عام 2024 ولسبب ما لا يزال التطوير مستمرًا. في الواقع، يمثل فبراير 2024 مرور 20 عامًا من النشاط (أي من التوفر العام).

المساهمة

1. أبلغ عن الأخطاء أو الاقتراحات في ما يلي:

   https://github.com/dave-theunsub/clamtk/issues
   https://gitlab.com/dave_m/clamtk/issues
   https://launchpad.net/clamtk

2. هل تتحدث أكثر من لغة؟ راجع صفحة Launchpad.

3. إذا أردت ذلك، ضع "نجمة" على clamtk أو مشاريعه ذات الصلة في أحد الرابطين التاليين أو كليهما:

   https://github.com/dave-theunsub/clamtk/
   https://gitlab.com/dave_m/clamtk/

روابط مهمة

روابط clamtk الرسمية

https://github.com/dave-theunsub/clamtk/
https://gitlab.com/dave_m/clamtk/wikis/home
https://gitlab.com/dave_m/clamtk/
https://launchpad.net/clamtk

روابط ذات صلة

ClamAV
Gtk2-Perl
Gtk3
Virustotal

التثبيت

حزم RPM

أسهل طريقة لتثبيت clamtk هي استخدام حزم rpm. سيقوم الأمران dnf وyum بجلب المتطلبات.

أولاً، ابدأ بالمستودعات الرسمية.

sudo yum install clamtk أو sudo dnf install clamtk.

إذا لم ينجح ذلك، قم بتنزيل الملف من الموقع الرسمي. يجب أن يكفي النقر المزدوج على الملف للتثبيت أو الترقية.

في هذه الأمثلة، سنستخدم الإصدار 6.17. قد يختلف اسم الملف حسب توزيعتك.

للتثبيت باستخدام نافذة طرفية:

sudo yum install clamtk-6.17-1.el9.noarch.rpm أو sudo dnf install clamtk-6.17-1.fc39.noarch.rpm

لإزالة clamtk:

sudo yum erase clamtk أو sudo dnf erase clamtk.

المصدر

تحذير: لا تفعل هذا. من الأسهل بكثير مجرد النقر المزدوج على ملف .deb أو .rpm. حقًا، اترك المصدر جانبًا.

يحتوي ملف tarball على جميع المصادر. إحدى الطرق للقيام بذلك، كما تم اختبارها على Fedora، هي تشغيل الأوامر التالية:

tar xzf clamtk-6.17.tar.xz  
sudo mkdir -p /usr/share/perl5/vendor_perl/ClamTk  
sudo cp lib/*.pm /usr/share/perl5/vendor_perl/ClamTk  
sudo chmod +x clamtk  
sudo cp clamtk /usr/local/bin (or /usr/bin)  

أمثلة:

perl clamtk

أو

chmod +x /path/to/clamtk
/path/to/clamtk

• إذا كنت قد ثبّت هذا البرنامج كحزمة rpm أو .deb، فلست بحاجة إلى اتخاذ هذه الخطوات.
• هل واجهت أخطاء مع هذا؟ راجع قسم "استكشاف الأخطاء وإصلاحها" في النهاية.

حزم DEB

يجب أن يكفي النقر المزدوج على ملف .deb لتثبيته. يجب أن يقوم مدير الحزم لديك بجلب أي تبعيات ضرورية.

من سطر الأوامر، يمكنك القيام بذلك:

sudo apt install clamtk

إذا قمت بتنزيل الملف، فاستخدم هذا:

sudo apt install clamtk_6.17-1_all.deb

لإزالة clamtk:

sudo dpkg --purge clamtk

لاحظ أن إصدارات Debian/Ubuntu لم تعد موقّعة بـ gpg.

التحقق من السلامة

يُوصى بتثبيت clamtk من المستودعات الرسمية. تحقق من توزيعتك أولاً، وقم دائمًا بالتثبيت من مصادر موثوقة.

بينما كانت حزم .deb الخاصة بـ Debian/Ubuntu موقّعة رقميًا في السابق، إلا أنها لم تعد كذلك؛ فالطريقة التي كنت أستخدمها للقيام بذلك لم تعد تعمل. حزم rpm موقّعة رقميًا. إليك كيفية التحقق من حزم rpm:

1. احصل على المفتاح واستورده في خطوة واحدة:
   rpm --import https://davem.fedorapeople.org/RPM-GPG-KEY-DaveM-20230506
2. تحقق من قائمة مفاتيح gpg المثبتة في قاعدة بيانات RPM:
   rpm -q gpg-pubkey --qf '%{name}-%{version}-%{release} --> %{summary}\n'
3. تحقق من توقيع حزمة rpm. في هذا المثال، سنستخدم الإصدار 6.17:
   rpm --checksig clamtk-6.17-1.fc39.noarch.rpm
4. يجب أن ترى شيئًا مثل هذا:
   /home/you/clamtk-6.17-1.fc39.noarch.rpm: rsa sha1 (md5) pgp md5 OK

يمكنك أيضًا التحقق من ملف tarball. باستخدام 6.17 كإصدار مثال، تأكد من أنك قمت بتنزيل ملف tarball وتوقيعه المنفصل (.asc) والمفتاح من الخطوة 1 أعلاه.

1. احصل على المفتاح (تخطَّ هذه الخطوة إذا كان لديك بالفعل):
   wget https://davem.fedorapeople.org/RPM-GPG-KEY-DaveM-20230506
2. استورده (تخطَّ هذه الخطوة إذا كنت قد قمت بذلك بالفعل):
   gpg --import RPM-GPG-KEY-DaveM-20230506
3. تحقق كما يلي:
   gpg2 --verify clamtk-6.17.tar.xz.asc clamtk-6.17.tar.gz أو
   gpg --verify clamtk-6.17.tar.xz.asc clamtk-6.17.tar.xz
4. يجب أن ترى شيئًا مثل هذا:
   gpg: Signature made Sun 11 Sep 2016 06:29:41 AM CDT using RSA key ID (مقتطع للاختصار).

يمكنك الآن استخدام minisign أيضًا!
Minisign

أولاً، ستحتاج إلى مفتاح minisign العام الخاص بي:
مفتاح minisign العام

ثم ستحتاج إلى ملف minisig للبرنامج الذي تتحقق منه.

سيكون الرابط الخاص به مع بقية التنزيلات.

في هذا المثال:
https://github.com/dave-theunsub/clamtk/releases/download/v6.17/clamtk-6.17.tar.xz.minisig

بعد ذلك، تحقق كما يلي:

minisign -V -x clamtk-6.17.tar.xz.minisig -p davemminisign.pub -m clamtk-6.17.tar.xz

الاستخدام

تشغيل clamtk

• أي إصدار حديث من clamtk سيبحث تلقائيًا عن التوقيعات إذا لم تكن قد عيّنتها مسبقًا. وبهذه الطريقة يجب أن يعمل مباشرة دون أي إعداد.
• فكّر في خيارات الفحص الإضافية في الإعدادات (Settings).
• حدد خيار "Scan files beginning with a dot (.*)" لفحص الملفات التي تبدأ بنقطة ".". يُشار إلى هذه الملفات أحيانًا باسم الملفات "المخفية".
• حدد خيار "Scan directories recursively" لفحص جميع الملفات والدلائل الموجودة داخل دليل.
• يتيح خيار "Scan for PUAs" إمكانية الفحص بحثًا عن التطبيقات غير المرغوب فيها (Potentially Unwanted Applications) وكذلك الملفات التنفيذية المعطوبة. لاحظ أن هذا قد يسفر عن نتائج قد تكون إيجابية خاطئة.
• افتراضيًا، سيتجنب clamtk فحص الملفات الأكبر من 20 ميجابايت. لفرض فحص هذه الملفات، حدد مربع "Scan files larger than 20 MB".
• يمكنك أيضًا التحقق من وجود تحديثات عند بدء التشغيل. يتطلب ذلك اتصال إنترنت نشطًا.
• تتوفر معلومات حول العناصر المعزولة ضمن خيار "Quarantine". إذا كنت تعتقد أن أحد العناصر يحتوي على نتيجة إيجابية خاطئة، يمكنك بسهولة إعادته إلى دليلك الرئيسي. يمكنك أيضًا حذف هذا الملف (أو هذه الملفات). لا توجد سلة محذوفات - بمجرد الحذف، تختفي الملفات إلى الأبد.
• افحص ملفًا أو دليلًا بالنقر بزر الماوس الأيمن عليه داخل مدير الملفات (مثل Nautilus). تتطلب هذه الوظيفة حزمة إضافية (clamtk-gnome).
• يمكنك إيقاف الفحص بالنقر فوق زر "Cancel". ومع ذلك، ونظرًا لسرعة الفحص، قد لا يتوقف فورًا؛ فسيستمر في فحص وعرض الملفات التي "قرأها" بالفعل حتى يصل إليه أمر الإيقاف.
• اعرض عمليات الفحص السابقة بتحديد خيار "History".
• مساعد التحديث "Update Assistant" ضروري لأن بعض الأنظمة مهيأة لإجراء التحديثات تلقائيًا، بينما يتعين على البعض الآخر تحديثها يدويًا.
• إذا كنت بحاجة إلى إعدادات وكيل محددة، فحدد خيار "Network".
• اعتبارًا من الإصدار 5.xx، يمكنك استخدام زر "Analysis" لمعرفة ما إذا كان ملف معين يُعتبر ضارًا بواسطة منتجات مكافحة فيروسات أخرى. يستخدم ذلك نتائج Virustotal. إذا رغبت، يمكنك إرسال ملف لمزيد من المراجعة. يرجى عدم إرسال ملفات تحتوي على معلومات شخصية أو مالية أو أمنية.
• يوفر خيار "Whitelist" القدرة على تخطي دلائل محددة أثناء الفحص. على سبيل المثال، قد ترغب في تخطي الدلائل التي تحتوي على موسيقى أو فيديوهات.

سطر الأوامر

يمكن أيضًا تشغيل clamtk من سطر الأوامر:

clamtk file_to_be_scanned  

أو

clamtk directory_to_be_scanned  

السبب الرئيسي لخيار سطر الأوامر (مهما كان أساسيًا) هو السماح بالفحص عبر النقر بزر الماوس الأيمن داخل مدير الملفات لديك (مثل Files أو Caja أو Dolphin). إذا كنت بحاجة إلى خيارات أكثر شمولًا لسطر الأوامر، فمن المستحسن استخدام الملف التنفيذي clamscan نفسه. (اكتب man clamscan في سطر الأوامر).

بعد ذلك

يمكنك عرض سجلات الفحص وحذفها بتحديد خيار "History".

لديك أيضًا بعض الخيارات المتاحة مع الملفات المعروضة. انقر على الملف المفحوص لتحديده، ثم انقر بزر الماوس الأيمن: يجب أن تظهر لديك أربعة خيارات.

• "Quarantine this file": يضع هذا الخيار الملف المحدد في مجلد "معزول" مع إزالة بت التنفيذ. يتم الاحتفاظ بمجلد العزل في مجلد clamtk الخاص بالمستخدم (~/.clamtk/viruses).
• "Delete this file": كن حذرًا: لا توجد سلة محذوفات!
• "Cancel": يلغي هذه القائمة.

العزل/الصيانة

إذا كنت قد عزلت ملفات لفحصها لاحقًا، فلديك خيار استعادتها إلى موقعها السابق (إذا كان معروفًا) أو حذفها.

الإضافات

لإضافة القدرة على إرسال الملفات والدلائل إلى الماسح الضوئي عبر قائمة السياق بالنقر بزر الماوس الأيمن، ثبّت الإضافة المناسبة. روابط أحدث الإصدارات متاحة هنا:

https://github.com/dave-theunsub/clamtk/
https://gitlab.com/dave_m/clamtk/wikis/Downloads

فيما يلي الصفحات المحددة. لاحظ أن هذه متاحة أيضًا كنسخ مطابقة على Github.

Gnome (مدير ملفات Files):
https://github.com/dave-theunsub/clamtk-gnome
https://gitlab.com/dave_m/clamtk-gnome

KDE (مدير ملفات Dolphin):
https://github.com/dave-theunsub/clamtk-kde
https://gitlab.com/dave_m/clamtk-kde

XFCE (مدير ملفات Thunar):
https://github.com/dave-theunsub/thunar-sendto-clamtk
https://gitlab.com/dave_m/thunar-sendto-clamtk

Mate (مدير ملفات Nemo):
https://github.com/dave-theunsub/nemo-sendto-clamtk
https://gitlab.com/dave_m/nemo-sendto-clamtk

استكشاف الأخطاء وإصلاحها

• هل توقيعاتك محدثة، لكن clamtk يقول إنها ليست كذلك؟

  من المحتمل أن لديك أكثر من دليل واحد لتوقيعات الفيروسات. راجع الإجابة أدناه للعثور على التوقيعات.

• إذا كنت تواجه خطأً يفيد بأن clamtk لا يمكنه العثور على توقيعاتك:

  يحاول clamtk العثور على تعريفات الفيروسات الخاصة به. عادةً ما تكون هذه التعريفات محفوظة في /var/lib/clamav أو /var/clamav أو في مكان آخر. إذا كنت متأكدًا من وجود هذه الملفات، فيرجى تحديد موقعها وإرساله. جرب ما يلي لتحديد موقعها:

  1. find /var -name "daily.cvd" -print
  2. find /var -name "daily.cld" -print

• هل تستخدم المصدر وترى شيئًا مثل هذا: Can't locate Foo/Bar.pm in @INC. (إلخ، إلخ).

  هذا يعني أنك تفتقد بعض التبعيات. حاول العثور على التبعية من خلال مستودعات توزيعتك، أو ببساطة انتقل إلى CPAN. جرّب دائمًا مستودع توزيعتك أولاً. فمن المرجح جدًا أن توزيعتك تقوم بالفعل بتعبئة هذه التبعيات لتسهيل التثبيت. اعتمادًا على توزيعتك، من المرجح أنك ستستخدم yum أو dnf أو apt أو بعض "مدير التحديثات" وما شابه ذلك.

• لم أعد أستطيع النقر بزر الماوس الأيمن على الملفات/الدلائل لفحصها!

  ذلك لأننا لم نعد نضمّن هذه الوظيفة. فليس الجميع يستخدم Gnome. توجد إضافات لـ XFCE وKDE وMate وGnome - وهي حزم صغيرة وسهلة التثبيت وتحتوي على تلك الوظيفة.

القيود/الأخطاء

من المحتمل أن يوجد الكثير منها. فأخبرني بها من فضلك. فالتذمر في لوحة إعلانات في مكان ما على أحد عشرات مواقع Linux لن يصلح الأخطاء أو يحسّن البرنامج. راجع القسم أدناه للحصول على معلومات الاتصال.

أخرى

اعتبارًا من الإصدار 3.10، لن يقوم clamtk بفحص دلائل البريد القياسية، مثل .evolution أو .mozilla أو .thunderbird. ويعود ذلك إلى مشاكل في التحليل (parsing). إذا ظهرت طريقة ذكية للقيام بذلك، فستتم إضافتها.

أيضًا، يرجى ملاحظة أن أرقام الإصدارات لا تعني شيئًا على الإطلاق. لا يوجد منطق أو سبب للأرقام الفردية أو الزوجية (أي أن الرقم الفردي لا يعني "غير مستقر"). الإصدار الجديد يعني أن الرقم يزيد بمقدار 1 (أو بالأحرى .01).

الواجهة الرسومية

بدأ clamtk باستخدام مكتبات Tk (ومن هنا جاء اسمه). في عام 2005، تم تغيير ذلك إلى perl-Gtk2 (أو Gtk2-perl، أيهما شئت). لا تزال نسخة Tk متاحة على sourceforge.net لكنها لم تُحدَّث منذ فترة ويجب عدم استخدامها.

كانت خطة سلسلة 5.xx هي استخدام Gtk3. لسوء الحظ، لم يتوفر لدى Debian وUbuntu إصدار حديث من libgtk3-perl، ولم يتوفر لدى CentOS perl-Gtk3. لذا، وفي اللحظة الأخيرة، تمت إعادة كتابة الإصدار 5.00 لاستخدام Gtk2. مرة أخرى.

تمت كتابة الإصدار 6.xx لاستخدام Gtk3، نظرًا لأن Gtk2 أصبح مهملًا (deprecated). لا يوجد تصميم جديد هذه المرة، حيث كان هذا جهدًا لضمان إمكانية تضمين نسخة Gtk3 في إصدارات التوزيعات القادمة (مثل Debian).

من المرجح أن يحصل الإصدار 7.xx على تصميم جديد، وقد يُكتب أيضًا بلغة مختلفة.

وهناك أيضًا نسخة Gtk4 قيد الإعداد.

شكرًا

ساهم العديد من الأشخاص بوقتهم وطاقتهم وآرائهم وتوصياتهم وخبراتهم في هذا البرنامج. لا يمكنني أن أشكرهم بما فيه الكفاية. أسماؤهم مدرجة في ملف الاعتمادات (credits).

كما أتوجه بشكر كبير إلى:

• كل من ساهم بشكل أو بآخر في clamtk - بما في ذلك ملفات اللغات والإبلاغ عن الأخطاء وطلبات الميزات
• Dag، الذي لولاه لما كانت حزم rpm موجودة على الأرجح
• جميع القائمين على gtk2-perl وgtk3-perl على وقتهم وجهدهم
• Perlmonks

الاتصال

• Dave M، dave.nerd @gmail.com 0xC81DF0FAC4AFEB22