How to Mount S3-Compatible Storage as External Storage in Nextcloud

To mount an S3-compatible bucket in Nextcloud, enable the built-in External storage support app, add an Amazon S3 storage entry in the administrator’s External storage settings, and supply the bucket credentials plus the provider’s endpoint details. Nextcloud uses the Amazon S3 backend for compatible services; you do not need to install a separate app for each S3 vendor. The exact hostname, region, and path-style setting depend on the object-storage provider.

This guide follows the current Nextcloud administration documentation for the S3 and external-storage backends, checked October 6, 2026. The labels may differ slightly between server versions and themes. A mount can be reachable while still behaving differently from a local Nextcloud folder, especially when files are changed directly in the bucket.

What should you check before adding the bucket?

Confirm these details with your S3 provider before opening Nextcloud settings:

• The bucket name and the credentials for an access key.
• The provider’s generic S3 endpoint hostname, such as s3.example.net. Use the endpoint itself, not a bucket-specific URL that already contains the bucket name.
• The region or signing region if the provider requires one.
• Whether requests should use virtual-hosted style (https://bucket.endpoint/) or path style (https://endpoint/bucket).
• The HTTPS port, normally 443, and whether your server can reach that endpoint through its firewall and DNS.

Create a dedicated access key for this mount and limit its permissions to the bucket and actions it needs. Do not paste secrets into a ticket, screenshot, or shell history. Nextcloud’s S3 setup requires an access key ID and secret access key; it does not validate every provider-specific permission policy for you.

Is this the same as making S3 Nextcloud’s primary storage?

No. An external-storage mount exposes an existing bucket as a folder inside Nextcloud. It is useful when you want to browse or manage files in a bucket while keeping the bucket accessible to other S3 tools. Primary object storage is a different server-wide architecture with different operational assumptions. If you need to choose between them, review Nextcloud’s primary object storage documentation before changing a production data design.

How do you add the S3-compatible mount in the web interface?

1. Enable External storage support

Sign in as a Nextcloud administrator, open Apps, and enable the bundled External storage support app. It is included with Nextcloud but may be disabled by default. If it is already enabled, continue to the storage settings.

2. Open the administrator’s External storage page

Otwórz menu profilu, wybierz Ustawienia , a następnie znajdź Pamięć zewnętrzną w sekcji Administracja. Ta strona dotyczy podłączeń konfigurowanych przez administratora. Pamięć skonfigurowana przez użytkownika w ustawieniach osobistych jest dostępna tylko dla niego; podłączenie administratora może być dostępne dla wybranych użytkowników i grup.

3. Utwórz mocowanie i wybierz zaplecze S3

W nowym wierszu wprowadź prostą nazwę folderu , na przykład [ nazwa folderu Archive]. Będzie ona widoczną nazwą folderu w NextCloud i musi być nazwą, a nie ścieżką dostępu; nie należy wpisywać ukośników. W selektorze typu magazynu wybierz Amazon S3 . W sekcji Uwierzytelnianie wybierz Klucz dostępu .

4. Wprowadź dane do wiadra i dane uwierzytelniające

Wprowadź dokładną nazwę kontenera, identyfikator klucza dostępu i tajny klucz dostępu od swojego dostawcy. Traktuj ten klucz jak hasło. Dokumentacja Nextcloud informuje, że nazwy kontenerów dla tego zaplecza muszą spełniać wymagania nazewnictwa AWS S3, nawet jeśli usługa jest hostowana gdzie indziej; podkreślenia nie są akceptowane. Jeśli nazwa kontenera dostawcy zawiera podkreślenie, przed rozwiązywaniem problemów z poświadczeniami sprawdź, czy dostawca oferuje kompatybilną nazwę kontenera.

5. Ustaw punkt końcowy, region i styl żądania

W przypadku usługi S3 hostowanej przez Amazon należy określić prawidłowy region. W przypadku usługi innej niż Amazon należy ustawić ogólną nazwę hosta dostawcy. Należy użyć wartości punktu końcowego i regionu opublikowanych przez dostawcę; nie ma uniwersalnej wartości regionu dla każdego produktu zgodnego z S3.

Aktualny podręcznik Nextcloud S3 wyraźnie zaleca używanie ogólnej nazwy hosta punktu końcowego dla pamięci masowej innej niż Amazon. Opisuje również adresowanie w stylu ścieżki jako zależne od dostawcy. Nie zmieniaj stylu ścieżki na zasadzie domysłu, jeśli możesz uzyskać oczekiwany tryb adresowania z dokumentacji dostawcy S3.

6. Ogranicz, kto może korzystać z wierzchowca

Użyj opcji Dostępne dla, aby przypisać tylko docelowych użytkowników lub grupy Nextcloud. W przeciwnym razie montowanie skonfigurowane przez administratora może być szeroko dostępne. Sprawdź również opcje montowania po zapisaniu: tryb tylko do odczytu i opcje udostępniania mogą być odpowiednie dla archiwów lub kontenerów współdzielonych. Sposób udostępniania może wpływać na to, kto może udostępniać pliki za pośrednictwem Nextcloud, dlatego należy go ustawić rozważnie.

7. Sprawdź, czy NextCloud może się połączyć

Gdy wymagane pola są prawidłowe, wiersz pamięci masowej zostanie automatycznie zapisany. Zielony wskaźnik statusu oznacza, że ​​NextCloud może korzystać ze skonfigurowanej pamięci masowej; czerwony lub żółty oznacza, że ​​połączenie lub konfiguracja wymagają uwagi. Strona administratora może tymczasowo oznaczyć uszkodzoną pamięć masową jako niedostępną na dziesięć minut. Kliknij ikonę statusu lub odśwież stronę, aby uruchomić kolejne sprawdzenie po poprawieniu wartości.

8. Przetestuj przy użyciu nieszkodliwego pliku

Otwórz pliki jako użytkownik z dostępem do montowania. Sprawdź, czy folder się pojawia, utwórz lub prześlij mały plik testowy, pobierz go ponownie i usuń, jeśli kontener ma być zapisywalny. Jeśli montowanie ma być tylko do odczytu, sprawdź, czy użytkownicy mogą odczytywać pliki i czy zapisy są blokowane. Sam zielony wskaźnik nie potwierdza, że ​​wszystkie uprawnienia użytkownika lub zamierzone zachowanie odczytu/zapisu są poprawne.

Jak sprawdzić mocowanie z poziomu wiersza poleceń?

W przypadku instalacji, w których administrujesz serwerem, Nextcloud udostępnia również occpolecenia dla pamięci zewnętrznej. Uruchom polecenia z katalogu instalacyjnego Nextcloud i użyj konta serwera WWW odpowiedniego dla Twojego systemu. W wielu instalacjach Linuksa jest to www-data, ale instalacje pakietów i kontenerów mogą się różnić.

sudo -E -u www-data php occ files_external:list
sudo -E -u www-data php occ files_external:verify <mount_id>

Zastąp <mount_id>identyfikatorem wyświetlonym przez polecenie listy. Pomyślna weryfikacja potwierdza, że ​​Nextcloud może w danym momencie nawiązać skonfigurowane połączenie. W przypadku wdrożenia Nextcloud AIO lub innego kontenera, użyj udokumentowanej metody wykonania occw kontenerze aplikacji, zamiast kopiować polecenie hosta bez zmian.

Dlaczego montaż może się nie powieść, nawet jeśli wartości wyglądają na prawidłowe?

Gdy usługa korzysta z certyfikatu podpisanego przez siebie, serwer musi ufać temu certyfikatowi; wyłączenie weryfikacji certyfikatu nie jest bezpiecznym zamiennikiem. Aktualny podręcznik Nextcloud ostrzega również, że powtarzające się ograniczniki, takie jak [ Photos//cat.pngbrakuje informacji o błędach], nie są obsługiwane, a odpowiednie prefiksy mogą zostać zignorowane.

Co się dzieje, gdy pliki zmieniają się bezpośrednio w kontenerze?

Nextcloud utrzymuje wewnętrzną pamięć podręczną plików dla pamięci zewnętrznej. Jeśli inne narzędzie doda, zmodyfikuje lub usunie obiekty bezpośrednio w S3, Nextcloud może nie zauważyć zmiany od razu. Aktualny przewodnik po pamięci zewnętrznej zaleca okresowe ponowne skanowanie typów pamięci bez powiadomień push. Identyfikator montowania można znaleźć za pomocą polecenia files_external:listi uruchomić:

sudo -E -u www-data php occ files_external:scan <mount_id>

Zaplanuj skanowanie w zależności od wymaganej świeżości i obciążenia serwera. Skanowanie to nie to samo, co natychmiastowe powiadomienia o zmianach. Nextcloud dokumentuje również ryzyko związane z metadanymi: ponowne skanowanie może zinterpretować zewnętrzną zmianę nazwy jako usunięcie starego obiektu i dodanie nowego, co spowoduje usunięcie udostępnień, tagów, komentarzy i historii aktywności po stronie Nextcloud powiązanych ze starym wpisem. Z tego powodu, jeśli zachowanie metadanych ma znaczenie, zmiany nazw należy przeprowadzać za pośrednictwem Nextcloud.

Skąd wiadomo, że konfiguracja została zakończona?

• Stan mocowania S3 jest oznaczony na zielono na stronie administratora Pamięć zewnętrzna.
• Użytkownicy z określonej grupy mogą zobaczyć wierzchowca, natomiast użytkownicy nieprzypisani nie są do niego przypisani.
• Testowe przesyłanie, pobieranie i usuwanie danych przebiega zgodnie z oczekiwaniami, ewentualnie zapisy są blokowane w przypadku montowania tylko do odczytu.
• Serwer może wykryć zmiany dokonane poza usługą Nextcloud po skonfigurowanym interwale skanowania.
• Dane uwierzytelniające przechowywane są wyłącznie w konfiguracji Nextcloud i na koncie dostawcy, a dostęp jest ograniczony do wymaganego kontenera.

Aby uzyskać szczegółowe informacje dotyczące poszczególnych wersji, zapoznaj się z oficjalnym podręcznikiem Nextcloud S3 external-storage , podręcznikiem administracji pamięcią zewnętrzną oraz oficjalnym dokumentem referencyjnym poleceń occ . Dostawcy różnią się pod względem wymagań dotyczących punktów końcowych, regionów, uprawnień i adresowania, dlatego ich dokumentacja konfiguracji S3 pozostaje miarodajna w odniesieniu do tych wartości.