👾 Antivirus app for Nextcloud Files
Перейти к файлу
Robin Appelman 48ce08da08 fix type of fileid iterators for background scanner
Signed-off-by: Robin Appelman <robin@icewind.nl>
2023-06-30 15:50:01 +02:00
.github we still need to support php 7.4 2023-06-15 15:46:30 +02:00
.tx [tx-robot] Update transifex configuration 2022-10-01 02:26:32 +00:00
appinfo fix type of fileid iterators for background scanner 2023-06-30 15:50:01 +02:00
css
img
js add support for ICAP RESPMOD 2023-04-13 17:25:56 +02:00
l10n Fix(l10n): Update translations from Transifex 2023-06-28 00:49:32 +00:00
lib fix type of fileid iterators for background scanner 2023-06-30 15:50:01 +02:00
screenshots
templates add support for ICAP RESPMOD 2023-04-13 17:25:56 +02:00
tests cleanup background scan job 2023-06-27 16:47:11 +02:00
.gitignore github ci 2021-06-02 16:42:24 +02:00
.nextcloudignore Version 3.2.2 2021-09-14 22:47:49 +02:00
.php-cs-fixer.dist.php Fix code style 2022-09-29 17:19:55 +02:00
.scrutinizer.yml
CHANGELOG.md 5.2.0 2023-06-29 15:14:52 +02:00
LICENSE
README.md add support for ICAP RESPMOD 2023-04-13 17:25:56 +02:00
composer.json use more upstream ci templates 2023-06-07 17:42:29 +02:00
composer.lock use more upstream ci templates 2023-06-07 17:42:29 +02:00
krankerl.toml fix krankerl config 2020-08-31 15:00:46 +02:00
psalm.xml cs/psalm 2023-06-07 17:27:27 +02:00

README.md

Nextcloud Antivirus for Files

Build Status Scrutinizer Code Quality Code Coverage

files_antivirus is an antivirus app for Nextcloud using ClamAV or Kaspersky.

Features

  • 🐿️ When the user uploads a file, it's checked
  • ☣️ Infected files will be deleted and a notification will be shown and/or sent via email
  • 🔎 It runs a background job to scan all files
  • 🦺 It will block all uploads if the file cannot be checked to ensure all files are getting scanned.

Requirements

One of

  • ClamAV as binaries on the Nextcloud server
  • ClamAV running in daemon mode
  • Kaspersky Scan Engine running in HTTP mode
  • Any virus scanner supporting ICAP (ClamAV and Kaspersky are tested, others should work)

Install

Documentation about installing ClamAV and this app can be found in our documentation.

ClamAV Details

This app can be configured to work with the executable or the daemon mode (recommended ❤️) of ClamAV. If this is used in daemon mode, it can connect through network or local file-socket. In daemon mode, it sends files to a remote/local server using the INSTREAM command.

Kaspersky HTTP Details

When running Kaspersky in HTTP mode the SessionTimeout will need to be set to a value higher than default, a value of 10 minutes (600000 millisecond) or higher is recommended to properly deal with larger uploads

ICAP (version 5.0 and later)

The app support the ICAP protocol which is a standard supported by various antivirus software products.

Some additional configuration is required depending on the antivirus software used:

  • ICAP service: The name of the service the antivirus software expects
  • ICAP virus response header: The name of the header the antivirus software send the details of the detected virus in

ClamAV ICAP

  • ICAP service: avscan
  • ICAP virus response header: X-Infection-Found

Kaspersky ICAP

  • ICAP service: req
  • ICAP virus response header: X-Virus-ID

Additionally, the Kaspersky scan engine needs some additional configuration: