Filegator. Menadżer plików online.

Darmowa, otwarta, samodzielnie hostowana aplikacja internetowa do zarządzania plikami i folderami z obsługą wielu użytkowników.
Poradnik: Filegator. Menadżer plików online.

FileGator to darmowy menedżer plików o otwartym kodzie źródłowym, który pozwala na zarządzanie danymi bezpośrednio przez przeglądarkę internetową. Jest to niezwykle lekkie narzędzie, które przekształca dowolny folder na Twoim serwerze w interaktywny panel, dostępny z dowolnego miejsca na świecie.

Oto najważniejsze funkcje i zastosowania tego narzędzia:

1. Zarządzanie plikami przez WWW

Dzięki FileGatorowi nie potrzebujesz klienta FTP ani dostępu przez konsolę, aby operować na swoich plikach. Możesz je przesyłać, pobierać, kopiować, przenosić oraz usuwać za pomocą intuicyjnego interfejsu przeciągnij-i-upuść.

2. Obsługa wielu użytkowników i uprawnień

Narzędzie pozwala na tworzenie kont dla wielu osób. Każdy użytkownik może mieć przypisany własny folder domowy oraz określone uprawnienia – od dostępu tylko do odczytu, po pełne prawo do modyfikacji i zarządzania plikami.

3. Szybki podgląd i edycja

FileGator posiada wbudowane przeglądarki dla najpopularniejszych formatów. Pozwala na:

  • Błyskawiczny podgląd zdjęć i obrazów
  • Odtwarzanie plików wideo oraz audio bezpośrednio w przeglądarce
  • Podgląd plików tekstowych i dokumentów PDF
  • Podstawową edycję plików tekstowych i kodu

4. Łatwe udostępnianie plików

Możesz generować bezpośrednie linki do plików lub całych folderów, co ułatwia dzielenie się danymi z osobami, które nie posiadają konta w systemie.

5. Archiwizacja i kompresja

Program umożliwia szybkie pakowanie wielu plików do formatu ZIP oraz rozpakowywanie archiwów przesłanych na serwer, co znacznie przyspiesza pracę z dużymi zestawami danych.

Podsumowując: FileGator to idealne rozwiązanie, jeśli chcesz mieć wygodny, graficzny dostęp do swoich plików na serwerze (np. dokumentów, zdjęć z Immich czy wydruków) bez konieczności instalowania skomplikowanego oprogramowania na komputerze.

Karta usługi

Podstawowe informacje o usłudze:

Nazwa
FileGator
Opis
Aplikacja do zarządzania plikami i folderami.

Plik konfiguracyjny docker compose usługi FileGator

Plik docker-compose.yml to główny element każdego projektu opartego na Docker Compose. Jest to dokument zapisany w formacie YAML, który opisuje jak uruchamiać, konfigurować i łączyć ze sobą kontenery w ramach jednej aplikacji lub całego środowiska. To tutaj opisujesz, jakie obrazy mają zostać pobrane, jakie porty otwarte i jakie relacje zachodzą między poszczególnymi elementami systemu.

Pełny opis schematu pliku konfiguracyjnego docker-compose.yml.

Poniżej znajdziesz zawartość pliku docker-compose.yml dla usługi FileGator:

YML
# Wersja składni docker-compose.
# Określa jakiej wersji specyfikacji używa plik.
# Wersja 2 jest starsza, ale nadal bardzo stabilna i często używana
# w prostych konfiguracjach docker-compose.
version: '2'

# Sekcja definiująca wszystkie kontenery (usługi), które mają być uruchomione
services:

  # Nazwa usługi. Może być dowolna, ale zwykle odpowiada nazwie aplikacji.
  # Docker Compose używa tej nazwy np. do tworzenia sieci lub referencji między usługami.
  filegator:

    # Jawna nazwa kontenera Dockera.
    # Bez tego docker-compose utworzyłby nazwę np. folder_filegator_1
    # Dzięki temu kontener będzie miał zawsze nazwę "filegator".
    container_name: filegator

    # Obraz Dockera, z którego zostanie utworzony kontener.
    # Pobierany z Docker Hub (jeśli nie ma go lokalnie).
    # filegator/filegator to gotowy obraz aplikacji FileGator
    # czyli webowego menedżera plików działającego przez przeglądarkę.
    image: filegator/filegator

    # Polityka restartu kontenera.
    # unless-stopped = kontener będzie automatycznie restartowany
    # po:
    # - restarcie systemu
    # - awarii kontenera
    # ale NIE jeśli zatrzymasz go ręcznie (docker stop).
    restart: unless-stopped

    # Mapowanie portów między hostem a kontenerem.
    ports:
      # Format:
      # HOST_PORT:CONTAINER_PORT
      #
      # Czyli:
      # port 8080 na twoim serwerze będzie przekierowany
      # do portu 8080 w kontenerze.
      #
      # Dzięki temu aplikacja będzie dostępna w przeglądarce pod adresem:
      # http://IP_SERWERA:8080
      - "8080:8080"

    # Sekcja montowania wolumenów (volume bindings).
    # Pozwala udostępnić katalogi z hosta do kontenera.
    volumes:

      # Komentarz informacyjny:
      # poniżej znajdują się przykładowe punkty montowania.
      # Bardzo ważne jest aby kontener miał prawa odczytu i zapisu
      # do tych katalogów na hoście.
      # W przeciwnym razie FileGator nie będzie mógł zapisywać plików.

      # ---------------------------------------------------------
      # GŁÓWNY KATALOG Z PLIKAMI
      # ---------------------------------------------------------

      # Montuje katalog z hosta:
      # /dane/pliki
      #
      # do katalogu w kontenerze:
      # /var/www/filegator/repository
      #
      # Ten katalog jest głównym repozytorium plików FileGatora.
      # Wszystkie pliki widoczne w interfejsie będą pochodziły stąd.
      - /dane/pliki:/var/www/filegator/repository

      # ---------------------------------------------------------
      # DODATKOWE KATALOGI JAKO PODFOLDERY
      # ---------------------------------------------------------

      # Ten katalog hosta:
      # /dane/pliki/folder1
      #
      # będzie widoczny w FileGatorze jako:
      # /repository/FolderPierwszy
      #
      # Czyli użytkownik zobaczy folder o nazwie "FolderPierwszy".
      - /dane/pliki/folder1:/var/www/filegator/repository/FolderPierwszy

      # Analogicznie:
      #
      # katalog hosta:
      # /dane/pliki/folder2
      #
      # będzie widoczny w FileGatorze jako:
      # /repository/FolderDrugi
      - /dane/pliki/folder2:/var/www/filegator/repository/FolderDrugi

      # ---------------------------------------------------------
      # PLIK Z UŻYTKOWNIKAMI
      # ---------------------------------------------------------

      # Ten wpis montuje lokalny plik users.json
      # do katalogu konfiguracyjnego FileGatora w kontenerze.
      #
      # ./users.json oznacza:
      # plik w tym samym katalogu co docker-compose.yml
      #
      # W tym pliku przechowywane są:
      # - użytkownicy
      # - hasła (zahashowane)
      # - uprawnienia
      - ./users.json:/var/www/filegator/private/users.json

      # ---------------------------------------------------------
      # OPCJONALNY PLIK KONFIGURACYJNY
      # ---------------------------------------------------------

      # Ten wpis jest zakomentowany (# na początku).
      # Jeśli go odkomentujesz, możesz używać własnej konfiguracji FileGatora.
      #
      # ./configuration.php – plik konfiguracyjny na hoście
      #
      # /var/www/filegator/configuration.php – miejsce gdzie
      # FileGator oczekuje pliku konfiguracji w kontenerze.
      #
      # Pozwala np. zmieniać:
      # - ustawienia uploadu
      # - autoryzację
      # - widoczność katalogów
      # - limity
      #
      # - ./configuration.php:/var/www/filegator/configuration.php

Plik konfiguracyjny users.json

Poniżej zostałą przedstawiona typowa struktura pliku users.json dla FileGator, do której odwołuje się docker compose opisany powyżej z usuniętymi prawdziwymi danymi i dokładnymi komentarzami.

Uwaga: JSON standardowo nie obsługuje komentarzy, więc poniższy przykład jest wersją edukacyjną (z komentarzami). W prawdziwym pliku trzeba je usunąć.

JSON
{
  /*
  GŁÓWNY OBIEKT JSON

  Każdy użytkownik jest zapisany jako element obiektu.
  Klucze ("1", "2", "3" itd.) to identyfikatory użytkowników w systemie FileGator.
  Nie mają specjalnego znaczenia poza tym, że muszą być unikalne.
  */

  "1": {
    /*
    username
    Login użytkownika używany do logowania do FileGatora.
    */
    "username": "admin",

    /*
    name
    Przyjazna nazwa użytkownika wyświetlana w interfejsie.
    */
    "name": "Administrator",

    /*
    role
    Rola użytkownika w systemie.

    Możliwe wartości:
    - admin  → pełna administracja systemem
    - user   → zwykły użytkownik
    - guest  → użytkownik anonimowy / bardzo ograniczony
    */
    "role": "admin",

    /*
    homedir
    Katalog domowy użytkownika.

    "/" oznacza główny katalog repozytorium:
    /var/www/filegator/repository

    Jeśli ustawisz np.
    "/folder"
    użytkownik zobaczy tylko ten katalog.
    */
    "homedir": "/",

    /*
    permissions
    Lista uprawnień oddzielona znakiem |

    Dostępne uprawnienia:
    read           → odczyt plików
    write          → edycja plików
    upload         → wysyłanie plików
    download       → pobieranie plików
    batchdownload  → pobieranie wielu plików naraz
    zip            → tworzenie archiwów zip
    chmod          → zmiana uprawnień plików
    */
    "permissions": "read|write|upload|download|batchdownload|zip|chmod",

    /*
    password
    Hasło zapisane jako HASH bcrypt.

    Format:
    $2y$10$....

    Oznacza:
    - algorytm bcrypt
    - koszt hash (10)
    - zahashowane hasło

    Hasło NIE jest przechowywane w formie jawnej.
    */
    "password": "$2y$10$HASH_USUNIETY_ADMIN"
  },


  "2": {
    /*
    Konto gościa.
    Zwykle używane do logowania anonimowego.
    */

    "username": "guest",
    "name": "Guest",

    /*
    Rola guest oznacza bardzo ograniczone możliwości.
    */
    "role": "guest",

    /*
    Dostęp do całego repozytorium,
    ale tylko jeśli przyznane są uprawnienia.
    */
    "homedir": "/",

    /*
    Brak uprawnień → użytkownik praktycznie nic nie może zrobić.
    */
    "permissions": "",

    /*
    Brak hasła → konto nie wymaga logowania
    lub jest wyłączone w zależności od konfiguracji.
    */
    "password": ""
  },


  "3": {
    /*
    Przykładowy użytkownik systemowy
    np. używany przez urządzenie (drukarka, skaner itp.)
    */

    "username": "drukarka",
    "name": "drukarka",

    /*
    Zwykły użytkownik
    */
    "role": "user",

    /*
    Katalog domowy użytkownika.

    Użytkownik zobaczy tylko katalog:

    /repository/drukarka
    */
    "homedir": "/drukarka",

    /*
    Pełne uprawnienia do własnego katalogu
    */
    "permissions": "read|write|upload|download|batchdownload|zip|chmod",

    /*
    Hasło bcrypt (usunięte)
    */
    "password": "$2y$10$HASH_USUNIETY_DRUKARKA"
  },


  "4": {
    /*
    Zwykły użytkownik systemu
    */

    "username": "uzytkownik",
    "name": "Użytkownik",

    "role": "user",

    /*
    Dostęp do całego repozytorium
    */
    "homedir": "/",

    /*
    Pełne uprawnienia
    */
    "permissions": "read|write|upload|download|batchdownload|zip|chmod",

    /*
    Hasło bcrypt (usunięte)
    */
    "password": "$2y$10$HASH_USUNIETY_USER"
  }
}

Opisana powyżej struktura pliku bez komentarzy:

JSON
{
  "1": {
    "username": "admin",
    "name": "Administrator",
    "role": "admin",
    "homedir": "/",
    "permissions": "read|write|upload|download|batchdownload|zip|chmod",
    "password": "$2y$10$ADMIN_HASH_TUTAJ"
  },
  "2": {
    "username": "guest",
    "name": "Guest",
    "role": "guest",
    "homedir": "/",
    "permissions": "",
    "password": ""
  },
  "3": {
    "username": "drukarka",
    "name": "drukarka",
    "role": "user",
    "homedir": "/drukarka",
    "permissions": "read|write|upload|download|batchdownload|zip|chmod",
    "password": "$2y$10$DRUKARKA_HASH_TUTAJ"
  },
  "4": {
    "username": "uzytkownik",
    "name": "Uzytkownik",
    "role": "user",
    "homedir": "/",
    "permissions": "read|write|upload|download|batchdownload|zip|chmod",
    "password": "$2y$10$USER_HASH_TUTAJ"
  }
}

Jak wygenerować hasło (bcrypt)

Najprostszy sposób na wygenerowanie hasła w docker, korzystając z obrazu filegator:

Bash
docker run --rm filegator/filegator php -r "echo password_hash('MOJE_HASLO', PASSWORD_BCRYPT).PHP_EOL;"

Wynik polecenia wklejasz w element JSON password opisany w pliku users.json.

Konteneryzacja usługi

Opisywana aplikacja zostanie uruchomiona jako kontener Dockera. Jeśli chcesz zapoznać się z tematem konteneryzacji, zacznij od tego artykułu: Podstawy Konteneryzacji: Kontener i Proces Konteneryzacji.

Instalacja Docker i Docker Compose

Jeśli chcesz uruchomić pierwszą aplikację docker compose na swoim domowym serwerze to najpierw musisz zainstalować w systemie odpowiednie pakiety oprogramowania. Zapoznaj się z poradnikiem, gdzie opisana jest Instalacja silnika Docker oraz wtyczki Docker Compose bezpośrednio z poziomu terminala Instalacja Docker i Docker Compose

Zarządzanie Usługą (Docker Compose)

Do zarządzania usługą w kontenerze na serwerze domowym użyjesz komendy docker compose. Poniższe komendy wykonuje się w katalogu, w którym znajduje się plik docker-compose.yml.

Uruchomienie Usługi (Pierwsza Instalacja)

Aby uruchomić usługę i kontener w tle (detached mode) użyj polecenia poniżej:

Bash
docker compose up -d

Opis parametrów: * up: Tworzy i uruchamia kontenery. * -` (detached): Uruchamia kontenery w tle, zwalniając terminal.

Usunięcie Usługi

Aby zatrzymać i usunąć kontener, sieć oraz wszystkie powiązane zasoby (ale zachować zmapowane woluminy work i conf na hoście):

Bash
docker compose down

Aktualizacja Obrazu

Aby zaktualizować usługę do nowszej wersji (zakładając, że obraz został zaktualizowany przez twórców):

Pobierz najnowszy obraz

Bash
docker compose pull

Zatrzymaj i ponownie utwórz kontener (używając nowego obrazu):

Bash
docker compose up -d

Docker Compose automatycznie wykryje, że obraz jest nowszy i zastąpi stary kontener nowym, zachowując wszystkie Twoje dane konfiguracyjne dzięki zdefiniowanym woluminom

Zestawienie najważniejszych poleceń

Zestawienie najważniejszych komend na potrzeby uruchamiania usług Docker Compose zdefiniowanych w plikach docker-compose.yml znajdziesz w przygotowanym poradniku Polecenia Docker Compose

Kategoria: Usługi | Autor: Rafał Wójcik
Utworzono: 2026-02-08 11:20 | Ostatnia edycja: 2026-04-07 15:53

Pytania & Komentarze

Brak komentarzy. Bądź pierwszy!

Dodaj nowy komentarz