Spis treści dokumentacji

Przechowywanie plików i skaner antywirusowy

Włączysz załączniki, podłączając magazyn zgodny z S3 i skaner ClamAV.

Po instalacji instalatorem .run przesyłanie plików jest wyłączone, a aplikacja ukrywa załączniki. Żeby je włączyć, potrzebujesz magazynu obiektów zgodnego z S3. Gadka nie przechowuje plików w lokalnym katalogu.

Jak to działa

  • Pliki zawsze przechodzą przez serwer Gadki. Aplikacje nigdy nie łączą się z magazynem bezpośrednio.
  • Każdy plik jest skanowany przez ClamAV, zanim da się go pobrać. Do końca skanowania użytkownik widzi Skanowanie…, a plik zainfekowany jest blokowany.

Zanim zaczniesz

  • Magazyn zgodny z S3 (np. SeaweedFS, Ceph RGW, Garage albo usługa chmurowa), dostępny tylko dla serwera Gadki.
  • Utworzony zasobnik (bucket) oraz klucz dostępu i klucz tajny.
  • Działający demon clamd z ClamAV, osiągalny z serwera.

Krok 1. Zapisz klucze magazynu

sudo install -o root -g gadka -m 0640 /dev/null /etc/gadka/s3-access-key
sudo install -o root -g gadka -m 0640 /dev/null /etc/gadka/s3-secret-key
sudo nano /etc/gadka/s3-access-key
sudo nano /etc/gadka/s3-secret-key

Krok 2. Uzupełnij konfigurację

W /etc/gadka/gadka.yaml dodaj sekcję s3 i zmień istniejącą sekcję antivirus:

s3:
  endpoint: s3.example.com:9000
  bucket: gadka-files
  region: us-east-1
  access_key_file: /etc/gadka/s3-access-key
  secret_key_file: /etc/gadka/s3-secret-key
  use_tls: true
antivirus:
  enabled: true
  clamd_addr: 127.0.0.1:3310
KluczZnaczenie
s3.endpointhost i port magazynu; puste oznacza pliki wyłączone
s3.bucketnazwa istniejącego zasobnika
s3.use_tlsszyfrowane połączenie z magazynem
antivirus.enabledfalse oznacza pliki oznaczone jako niezeskanowane
antivirus.clamd_addrhost i port clamd
files.max_file_bytesnajwiększy plik, domyślnie 1 GiB

Krok 3. Uruchom ponownie i sprawdź

sudo systemctl restart gadka

W aplikacji w polu wiadomości kliknij + (Dodaj), potem Dołącz plik, i wyślij mały plik. Po chwili status Skanowanie… zniknie i pojawi się przycisk Pobierz.

Praca bez antywirusa

Ustawienie antivirus.enabled: false jest świadomą decyzją administratora. Pliki są wtedy dostępne bez skanowania.

Kopie zapasowe

Kopia bazy danych nie obejmuje plików. Zadbaj o wersjonowanie albo kopie po stronie magazynu S3.

Co dalej