Jak hostować File Browser samodzielnie w 2026 roku: wolumeny, konta i bezpieczne udostępnianie

Traktuj File Browser jako niewielki system, a nie obraz Dockera. Cel z perspektywy użytkownika jest jasny: webowy menedżer plików dla podłączonego wolumenu. Wdrożenie można uznać za poprawne dopiero wtedy, gdy da się utworzyć użytkownika z ograniczeniami, przesłać i zmienić nazwę pliku, edytować tekst, wygenerować udostępnienie oraz potwierdzić, że użytkownik nie może wyjść poza przypisany mu katalog główny.

To rozróżnienie pozwala wychwycić problem, z którym operatorzy spotykają się po lokalnych testach: zamontowane pliki korzystają z uprawnień hosta, których kontener nie może odczytać. Dzięki temu plan tworzenia kopii zapasowych i aktualizacji staje się wystarczająco konkretny, aby można go było przetestować.

Znajdź wszystkie trwałe dane File Browser

Obraz kontenera można pobrać ponownie, ale udostępniane pliki, baza danych File Browser i ustawienia już nie. Zamontuj /srv przed bootstrapem, zapisz nieszkodliwe dane testowe i wymień kontener, aby potwierdzić, że ta ścieżka jest rzeczywiście trwała. Sprawdź faktycznie używane montowanie zamiast ufać nazwie pliku Compose i upewnij się, że użytkownik uruchomieniowy może zapisywać w miejscu oczekiwanym przez File Browser.

Ustal czas przechowywania oraz lokalizację poza hostem, a następnie przećwicz odtwarzanie bez dotykania środowiska produkcyjnego. Próba jest udana tylko wtedy, gdy wracają udostępniane pliki, użytkownicy, zakresy dostępu, udostępnienia i ustawienia, a konto z ograniczeniami nadal pozostaje w przypisanym mu katalogu. W przypadku stanu opartego na bazie danych połącz snapshoty storage z eksportami spójnymi na poziomie aplikacji, zgodnie z opisem w artykule odzyskiwanie punktu w czasie a snapshoty.

Uruchom pierwszą instancję zbliżoną do produkcyjnej

Zadbaj o to, aby pierwsze wywołanie File Browser było wystarczająco powtarzalne, by można je było zweryfikować w pull requeście.

docker run -d \
  --name file-browser \
  --restart unless-stopped \
  -p 127.0.0.1:80:80 \
  -v file-browser-data:/srv \
  -v file-browser-db:/database \
  -v file-browser-config:/config \
  filebrowser/filebrowser:latest

Po pojawieniu się prawdziwych danych nie polegaj na latest. Zapisz działający digest, użytkownika kontenera i właściciela montowań. Śledź log aplikacji przez cały test — utwórz użytkownika z ograniczeniami, prześlij i zmień nazwę pliku, edytuj tekst, wygeneruj udostępnienie i potwierdź, że użytkownik nie może wyjść poza przypisany mu katalog główny — a przed skierowaniem ruchu produkcyjnego na tę trasę odnotuj ewentualne migracje.

Wyznacz granicę środowiska uruchomieniowego File Browser

Stan procesu i stan produktu to w przypadku File Browser dwie różne kwestie. Port 80 może odpowiadać, nawet jeśli transakcja z perspektywy użytkownika nadal kończy się niepowodzeniem. Lokalne wymaganie środowiska uruchomieniowego to osobna trwała ścieżka dla bazy danych i ustawień. Zweryfikuj ją przy użyciu obciążenia akceptacyjnego — bezczynny health check nie potwierdzi, że zasób jest wystarczający.

Po istotnych zmianach konfiguracji wykonaj następujące ćwiczenie gotowości: utwórz użytkownika z ograniczeniami, prześlij i zmień nazwę pliku, edytuj tekst, wygeneruj udostępnienie i potwierdź, że użytkownik nie może wyjść poza przypisany mu katalog główny. Nie umieszczaj kosztownych zewnętrznych kontroli w sondach liveness, aby awaria dostawcy nie powodowała pętli restartów. Prace nad wydajnością powinny uwzględniać przepustowość dysku bazowego, rozmiar przesyłanych plików, liczbę równoczesnych pobrań i liczbę katalogów, ponieważ te czynniki lepiej odzwierciedlają rzeczywiste obciążenie File Browser niż żądania stron.

Ujednoznacznij publiczny origin

Udostępniaj File Browser pod jednym hostem HTTPS, a surowy port 80 pozostaw prywatny. Publikuj interfejs przez HTTPS, ale starannie ogranicz katalog główny udostępniany użytkownikom. Dzięki temu przeglądarki i klienci API nie będą poznawać dwóch konkurencyjnych adresów.

Z czystego klienta wykonaj sprawdzoną transakcję i sprawdź pierwsze żądanie, które kończy się niepowodzeniem. Gdy problem dotyczy DNS lub TLS, skorzystaj z poradnika dotyczącego własnej domeny. Gdy trasa jest już potwierdzona, traktuj problem „zamontowane pliki korzystają z uprawnień hosta, których kontener nie może odczytać” jako osobną diagnozę aplikacji.

Kryterium wydania File Browser

Utwórz mały, jednorazowy fixture File Browser i zachowuj go przy każdym wydaniu. Fixture powinien odtwarzać rzeczywisty workflow: utworzenie użytkownika z ograniczeniami, przesłanie i zmianę nazwy pliku, edycję tekstu, wygenerowanie udostępnienia oraz potwierdzenie, że użytkownik nie może wyjść poza przypisany mu katalog główny. Zapisz digest obrazu, zewnętrzny hostname, adres zależności i oczekiwany wynik, aby kolejny operator mógł powtórzyć test bez interpretowania tego poradnika.

Uruchom fixture trzy razy. Najpierw użyj świeżego wdrożenia. Następnie wymień kontener bez modyfikowania trwałego stanu. Na końcu odtwórz kopię zapasową w pustym środowisku. Trzecia próba jest udana tylko wtedy, gdy wracają udostępniane pliki, użytkownicy, zakresy dostępu, udostępnienia i ustawienia, a konto z ograniczeniami nadal pozostaje w przypisanym mu katalogu. Podczas każdej próby rejestruj opóźnienia i wykorzystanie zasobów w odniesieniu do przepustowości dysku bazowego, rozmiaru przesyłanych plików, liczby równoczesnych pobrań i liczby katalogów. Stanie się to podstawą alertów zamiast arbitralnego procentowego użycia CPU.

Na koniec celowo przetestuj ścieżkę negatywną: prześlij nieszkodliwe dane w pobliżu limitu zasobu lub formatu powiązanego z tą granicą: zamontowane pliki korzystają z uprawnień hosta, których kontener nie może odczytać. Potwierdź, że File Browser kończy działanie w widoczny sposób bez uszkodzenia stanu, przywróć prawidłowe warunki i ponownie wykonaj udaną transakcję. Rekord wydania zawierający te cztery wyniki jest mocniejszym dowodem niż zrzuty ekranu dashboardu lub jednorazowa odpowiedź curl.

Kontrola wydajności i aktualizacji

Bezczynny health check niewiele mówi o File Browser. Obserwuj przepustowość dysku bazowego, rozmiar przesyłanych plików, liczbę równoczesnych pobrań i liczbę katalogów, a następnie konfiguruj alerty na podstawie objawu odczuwanego przez użytkowników: niepowodzenia akcji „utwórz użytkownika z ograniczeniami, prześlij i zmień nazwę pliku, edytuj tekst, wygeneruj udostępnienie i potwierdź, że użytkownik nie może wyjść poza przypisany mu katalog główny”. Liveness utrzymuj lokalne i lekkie, a readiness niech raportuje migracje lub inicjalizację bez wywoływania lawiny restartów.

Ryzykownym obszarem aktualizacji jest fakt, że migracje bazy danych i ustawień File Browser mają znaczenie, mimo że udostępniane pliki znajdują się na osobnym montowaniu. Przeczytaj informacje o wydaniu, utwórz snapshot stanu, wdroż wersję docelową na odtworzonej kopii i ponownie wykonaj akcję akceptacyjną. Jeśli zamontowane pliki korzystają z uprawnień hosta, których kontener nie może odczytać, skoreluj żądanie klienta z pierwszym właściwym wpisem w logu aplikacji, zamiast bez zastanowienia usuwać stan lub dodawać przekierowania.

Ogranicz uprawnienia przyznane File Browser

Dane dostępowe używane podczas bootstrapu są tymczasowe, ale model zaufania pozostaje na stałe. W przypadku File Browser zwracaj uwagę na udostępnianie / lub katalogu z sekretami zamiast dedykowanego udziału. Udostępniaj dedykowany katalog zamiast katalogu głównego hosta i nadaj każdemu kontu najwęższy zakres dostępu do plików, jakiego potrzebuje.

W tej konfiguracji bazowej File Browser nie ma obowiązkowego sekretu bootstrapu. Zabezpiecz rzeczywiste konto administratora lub uwierzytelnianie upstream. Uruchamiaj obraz bez niepotrzebnych capabilities systemu Linux i udostępniaj wyłącznie publiczną trasę aplikacji. Rejestruj aktywność administratora, ale nie zapisuj wartości sekretów.

Użyj Dockup dla warstwy platformowej

W przypadku File Browser Dockup jest najbardziej przydatny na granicy między obrazem a trwałą usługą. Utrzymuje trasę do portu 80, TLS, wartości sekretów i podłączony storage podczas wymiany kontenerów, niezależnie od tego, czy compute należy do Dockup, czy do Twojego podłączonego serwera.

Na koniec uwzględnij wiedzę o aplikacji: publikuj interfejs przez HTTPS, ale starannie ogranicz katalog główny udostępniany użytkownikom; potwierdź lokalne wymaganie — osobną trwałą ścieżkę dla bazy danych i ustawień — oraz wykonaj następującą weryfikację: utwórz użytkownika z ograniczeniami, prześlij i zmień nazwę pliku, edytuj tekst, wygeneruj udostępnienie i potwierdź, że użytkownik nie może wyjść poza przypisany mu katalog główny. Zachowaj wynik jako kontrolę wdrożenia, aby następna aktualizacja obrazu była oceniana na podstawie zachowania, a nie statusu kontenera.

Najczęściej zadawane pytania

Czego File Browser potrzebuje do wdrożenia produkcyjnego?

Skieruj kontener File Browser działający na porcie 80 przez jeden origin HTTPS. Lokalne wymaganie środowiska uruchomieniowego to osobna trwała ścieżka dla bazy danych i ustawień. Nie uznawaj File Browser za gotowy, dopóki nie utworzysz użytkownika z ograniczeniami, nie prześlesz i nie zmienisz nazwy pliku, nie wyedytujesz tekstu, nie wygenerujesz udostępnienia i nie potwierdzisz, że użytkownik nie może wyjść poza przypisany mu katalog główny.

Które dane File Browser powinny znaleźć się w kopii zapasowej?

Zachowaj /srv i uwzględnij udostępniane pliki, bazę danych File Browser oraz ustawienia w tym samym manifeście odtwarzania. Odtwarzanie File Browser jest poprawne tylko wtedy, gdy wracają udostępniane pliki, użytkownicy, zakresy dostępu, udostępnienia i ustawienia, a konto z ograniczeniami nadal pozostaje w przypisanym mu katalogu.

Czy File Browser wymaga HTTPS za reverse proxy?

Używaj HTTPS dla publicznego originu File Browser, a port 80 pozostaw na trasie wewnętrznej. Zastosuj prawidłowe ustawienie File Browser: publikuj interfejs przez HTTPS, ale starannie ogranicz katalog główny udostępniany użytkownikom. W przypadku File Browser HTTPS chroni dane logowania lub treści użytkowników podczas przesyłania i zapewnia spójne działanie klienta zależne od originu.

Jak testować aktualizację File Browser?

Odtwórz bieżący stan File Browser w izolowanym wdrożeniu, zastosuj wersję kandydującą i ponownie wykonaj transakcję akceptacyjną. Zwróć szczególną uwagę na migracje, ponieważ migracje bazy danych i ustawień File Browser mają znaczenie, mimo że udostępniane pliki znajdują się na osobnym montowaniu. Zachowaj poprzedni obraz File Browser do czasu zrozumienia granicy migracji danych i wycofania zmian.