Zainstaluj ownCloud Infinite Scale z Docker Compose

W przypadku instalacji serwerowej należy rozpocząć od oficjalnego ocis_fullprzykładu Docker Compose firmy ownCloud dla stabilnej wersji 8.2. Zawiera on usługę Infinite Scale, odwrotny serwer proxy oraz opcjonalne usługi współpracy biurowej; .envprzed uruchomieniem należy skonfigurować domeny, nadawcę SMTP i ścieżki danych w pliku docker compose up -d. Ta konfiguracja jest przeznaczona dla pojedynczej instancji i wymaga publicznego DNS oraz dostępnych portów dla zaufanych certyfikatów Let's Encrypt. W przypadku wewnętrznej oceny bez domeny należy przestrzegać ograniczeń dotyczących certyfikatów podpisanych samodzielnie opisanych poniżej.

Przed instalacją

Ta procedura jest zgodna z przewodnikiem „Infinite Scale 8.2 production Compose” firmy ownCloud , sprawdzonym 9 października 2026 r. Przewodnik dotyczy Ubuntu LTS 24.04 lub 22.04 z zainstalowanym Docker Engine i Docker Compose. Zalecane jest co najmniej 4–6 GB pamięci. Domyślnie włączone usługi wymagają około 2,4 GB miejsca na dysku, zanim zostaną uwzględnione pliki użytkowników, logi, kopie zapasowe i przyszły rozwój.

Wybierz ten pełny przykład, jeśli możesz zarządzać systemem DNS, regułami zapory sieciowej i hostem Linux. Obejmuje on więcej niż tylko podstawową platformę plików; w celu oceny bez domen, ownCloud twierdzi, że konfiguracja korzysta z certyfikatów podpisanych przez siebie.

• Host: Ubuntu 24.04 LTS lub 22.04 LTS z dostępem SSH i sudo.
• Sieć: domena, której wymagane rekordy DNS odnoszą się do adresu WAN serwera; zezwala na ruch przychodzący na porty TCP 22, 80 i 443 w zaporze sieciowej i dowolnym routerze nadrzędnym.
• Oprogramowanie: Docker Engine i wtyczka Compose. W systemie Linux Docker dokumentuje instalację za pośrednictwem repozytorium pakietów; po instalacji należy sprawdzić, czy Compose odpowiada komunikatem docker compose version.
• Poczta: wartość SMTP_SENDERjest wymagana, aby ten przykład się uruchomił. Uzupełnij pozostałe ustawienia SMTP, jeśli chcesz, aby powiadomienie e-mail zostało dostarczone.

1. Zainstaluj Docker Compose i przygotuj hosta

Jeśli Docker Engine jest już zainstalowany, zainstaluj wtyczkę Compose, korzystając z metody odpowiedniej dla Twojej dystrybucji Linuksa, opisanej w oficjalnych instrukcjach instalacji Compose w Dockerze . W systemach Ubuntu lub Debian, w których skonfigurowano repozytorium Dockera, udokumentowane polecenie package to:

sudo apt-get update
sudo apt-get install docker-compose-plugin
docker compose version

Docker zaleca tę wtyczkę i docker composeformularz poleceń dla obecnych instalacji. W razie potrzeby zainstaluj Docker Engine zgodnie z oficjalną instrukcją Ubuntu .

Przed pobraniem konfiguracji wskaż domenę lub subdomeny, których planujesz używać, na publiczny adres IP hosta. Przykład ownCloud wymaga OCIS_DOMAIN; może również używać COLLABORA_DOMAIN, ONLYOFFICE_DOMAINgdy te usługi biurowe są skonfigurowane. Nazwy DNS muszą być zgodne z wartościami w .env. Sprawdź, czy router przekierowuje porty 80 i 443 do tego hosta i czy lokalna zapora sieciowa na to pozwala.

2. Pobierz oficjalny przykład Compose

Użyj ocis_fullkatalogu z stable-8.2gałęzi oficjalnych przykładów wdrożeń ownCloud . Pobierz plik ZIP na komputer z przeglądarką, przenieś go na serwer bez interfejsu użytkownika za pomocą [brakuje nazwy użytkownika] scpi rozpakuj zgodnie /opt/compose/ocis/ocis_fullz opisem w przewodniku ownCloud.

Zapisz aktualną wersję .envprzed wyodrębnieniem zaktualizowanej kopii: ownCloud ostrzega, że ​​plik może zostać nadpisany. Uruchom polecenia Compose z katalogu projektu.

3. Skonfiguruj domeny, certyfikaty, pocztę e-mail i ścieżki danych

Otwórz /opt/compose/ocis/ocis_full/.envw edytorze tekstu. Zachowaj nazwy zmiennych i składnię przykładu, a edytuj tylko wartości, które dotyczą Twojej instalacji:

• Ustaw OCIS_DOMAINnazwę hosta, którą będą wprowadzać użytkownicy. Ustaw nazwy hostów Collabora lub OnlyOffice tylko wtedy, gdy te usługi są włączone w przykładzie.
• W przypadku serwera z dostępem do internetu należy dodać komentarz INSECUREzgodnie z instrukcją w przykładzie. Nie należy pozostawiać ustawienia niezabezpieczonego włączonego do użytku publicznego.
• Ustaw TRAEFIK_ACME_MAILna kontrolowany przez siebie adres e-mail. Do wstępnego testowania certyfikatu ustaw TRAEFIK_ACME_CASERVERserwer testowy Let's Encrypt. Certyfikaty testowe nie są zaufane do normalnego użytkowania; pomagają one przetestować DNS i dostępność przed żądaniem certyfikatów produkcyjnych.
• Ustaw SMTP_SENDER, nawet jeśli jeszcze nie skonfigurowałeś działającego przekaźnika poczty. Oficjalny przewodnik informuje, że wdrożenie nie rozpocznie się bez niego. Dodaj hosta SMTP, port, dane uwierzytelniające, uwierzytelnianie i ustawienia zabezpieczeń, jeśli są dostępne; bez pozostałych ustawień poczty instancja może się uruchomić, ale nie może wysyłać powiadomień.
• Przejrzyj OCIS_DOCKER_IMAGEi sprawdź tagi obrazów w przykładzie. Nie zmieniaj przypadkowo kanałów wydania podczas instalacji wersji stabilnej.
• W przypadku serwera produkcyjnego należy rozważyć przypisanie OCIS_DATA_DIRi OCIS_CONFIG_DIRdo zaplanowanych ścieżek hosta na pamięci masowej o wystarczającej pojemności i zasięgu kopii zapasowych. Domyślnie używane są woluminy zarządzane przez Dockera, co jest wygodne, ale ownCloud zauważa, że ​​ich lokalizacja, migawki, kopie zapasowe, przywracanie, resetowanie i migracja zależą od pamięci masowej hosta Dockera.

Ogranicz dostęp do serwera i jego pliku konfiguracyjnego. Certyfikat podpisany samodzielnie nadaje się wyłącznie do ewaluacji wewnętrznej, a nie do zaufanego wdrożenia publicznego.

Przed uruchomieniem kontenerów sprawdź poprawność scalonej konfiguracji w katalogu projektu:

cd /opt/compose/ocis/ocis_full
docker compose config

Przed kontynuowaniem popraw zgłoszone błędy zmiennych lub YAML. To polecenie renderuje konfigurację Compose do inspekcji; nie dowodzi to, że DNS, certyfikaty, uprawnienia do magazynu ani łączność SMTP działają.

4. Uruchom usługi i zakończ konfigurację certyfikatu

Uruchom stos w tle:

docker compose up -d

Pierwsze uruchomienie pobiera obrazy i uruchamia usługi, więc może to potrwać dłużej niż późniejsze restarty. Sprawdź stan usługi za pomocą:

docker compose ps -a

Następnie sprawdź logi, jeśli usługa zostanie zamknięta lub adres internetowy się nie załaduje:

docker compose logs --follow

Zacznij od logów Traefika. Błędy certyfikatów często wskazują na niezgodność DNS i .envwartości, zablokowane porty 80/443 lub nieprawidłowy adres e-mail ACME. Usuń przyczynę przed ponowną próbą. Nie używaj tego docker compose down -vjako resetu: usuwa wszystkie woluminy projektu, w tym dane.

Po pomyślnym sprawdzeniu certyfikatu przejściowego wykonaj procedurę certyfikatu ownCloud: zatrzymaj wdrożenie, usuń tylko przykładowy wolumin certyfikatu ( ocis_full_certs), wyczyść ustawienia urzędu certyfikacji przejściowego i uruchom ponownie, aby zażądać zaufanych certyfikatów produkcyjnych. Przed usunięciem woluminu potwierdź jego dokładną nazwę docker volume ls. Nie usuwaj woluminów danych ani konfiguracji.

Zweryfikuj dostęp i chroń wdrożenie

Otwórz adres URL ustawiony w OCIS_DOMAIN. Pomyślny wynik oznacza, że ​​przeglądarka przejdzie do strony logowania przez HTTPS bez ostrzeżenia o certyfikacie i docker compose ps -awyświetli uruchomione wymagane usługi. Zaloguj się, używając początkowych danych uwierzytelniających udokumentowanych przez ownCloud ( admin/ admin, chyba że ustawisz inne hasło początkowe), a następnie niezwłocznie zmień hasło administratora.

Jeśli witryna jest niedostępna, sprawdź DNS, przekierowanie portów, logi ACME Traefika, a następnie logi usługi Infinite Scale. Jeśli logowanie działa, ale powiadomienia e-mail nie, sprawdź ustawienia SMTP.

Przed zapisaniem ważnych plików upewnij się, że kopia zapasowa obejmuje zarówno konfigurację, jak i dane. Woluminy zarządzane przez Dockera są wygodne do ewaluacji; jawne ścieżki hosta łatwiej umieścić na osobnym dysku i uwzględnić w kopiach zapasowych hosta. Gotowość do pracy jest zapewniona, gdy protokół HTTPS jest prawidłowy, usługi działają po ponownym uruchomieniu, logowanie administratora działa, a kopie zapasowe obejmują wybraną pamięć masową.