Jak połączyć Collabora Online z Seafile: opcje konfiguracji i kroki

Seafile może otwierać obsługiwane pliki Office w Collabora Online za pośrednictwem WOPI – protokołu, który umożliwia serwerowi pamięci masowej i edytorowi online wymianę informacji o dokumentach i zawartości plików. Właściwe wdrożenie zależy od miejsca uruchomienia Seafile, sposobu zarządzania protokołem HTTPS i odwrotnymi serwerami proxy oraz od tego, czy Collabora ma działać w tej samej sieci Docker, czy na oddzielnym serwerze.

Ten przewodnik jest zgodny z aktualnymi instrukcjami integracji Collabora zawartymi w podręczniku administratora Seafile (dokumentacja Seafile 14.0, sprawdzona 6 października 2026 r.). Dokładne pliki Docker Compose i tagi obrazów mogą ulec zmianie, dlatego należy używać plików dla zainstalowanej wersji Seafile, zamiast kopiować pełną konfigurację Compose ze starszego poradnika.

Które wdrożenie powinieneś wybrać?

W przypadku nowego wdrożenia Dockera z jednym węzłem, należy rozpocząć od pliku dostarczonego przez Seafile collabora.yml. W przypadku istniejącego samodzielnego serwera Collabora lub klastra, należy skorzystać z instrukcji instalacji Collabora i ustawić adres URL wykrywania Seafile na zewnętrzny adres Collabora. Przewodnik integracji Seafile wymaga protokołu HTTPS dla Seafile i wskazuje, że oddzielny węzeł Collabora powinien używać protokołu HTTPS na standardowym porcie 443, z odwrotnym proxy do usługi Collabora na porcie 9980. Zapoznaj się z przewodnikiem integracji Seafile Collabora Online oraz dokumentacją instalacji Collabora .

Zanim zaczniesz

• Sprawdź, czy Twój serwer Seafile jest dostępny przez HTTPS z ważnym certyfikatem. Przewodnik Seafile wyraźnie wymaga protokołu HTTPS do tej integracji.
• Określ typ wdrożenia: obecny Docker z pojedynczym węzłem, instalacja binarna czy konfiguracja wielohostowa/klastrowa. Nazwy plików i routing proxy zależą od tego wyboru.
• Wybierz nazwę hosta Collabora, taką jak office.example.com, jeśli przeglądarki użytkowników będą miały niezależny dostęp do Collabora. Przed skonfigurowaniem Seafile sprawdź, czy certyfikat DNS i TLS działają.
• Uzyskaj dostęp administratora do plików Seafile seahub_settings.pyi Docker .env, jeśli dotyczy. Przechowuj hasło administratora Collabora w chronionym pliku środowiskowym i nie publikuj go na zrzutach ekranu, w logach ani w publicznym repozytorium.

Dokumentacja Seafile opisuje kroki dla Dockera z tym samym hostem dla obsługiwanego układu Compose. Jeśli Twój odwrotny serwer proxy, projekt Compose lub sieć różnią się, potraktuj poniższe przykładowe wartości jako punkt wyjścia i zweryfikuj nazwy usług i trasy we własnym wdrożeniu.

Opcja A: Dodaj Collabora do wdrożenia Seafile Docker

1. Dodaj oficjalny plik Collabora Compose

Z katalogu, w którym znajduje się konfiguracja Seafile Compose, pobierz plik Collabora dla uruchomionej wersji Seafile. Ścieżka do Seafile 14.0 w instrukcji obsługi:

wget https://manual.seafile.com/14.0/repo/docker/collabora.yml

Otwórz .envi dodaj collabora.ymldo istniejącej COMPOSE_FILElisty. Zachowaj wszystkie bieżące wpisy; na przykład instalacja, która już zawiera pliki serwera Seafile, Caddy i SeaDoc, doda plik Collabora zamiast zastąpić listę:

COMPOSE_FILE='seafile-server.yml,caddy.yml,seadoc.yml,collabora.yml'

Twoja rzeczywista lista może się różnić. Nie usuwaj bieżącego odwrotnego serwera proxy ani innych usług tylko po to, aby dopasować ją do tego przykładu. Plik Compose ustanawia ustawienia kontenera i sieci wymagane przez pakietowe wdrożenie Seafile.

2. Ustaw wartości środowiskowe Collabora

Dodaj zmienne udokumentowane przez Seafile do tego samego .envpliku. W obecnym przykładzie użyto zmiennej rolling collabora/codeimage name; zespoły wymagające powtarzalnych aktualizacji powinny wybrać tag wydania Collabora obsługiwany przez ich środowisko i celowo go przypiąć. Przed zmianą działającej usługi edytora należy zapoznać się z informacjami o wydaniu i przetestować aktualizacje.

COLLABORA_IMAGE=collabora/code
COLLABORA_PORT=6232
COLLABORA_USERNAME=admin
COLLABORA_PASSWORD=replace-with-a-long-random-secret
COLLABORA_ENABLE_ADMIN_CONSOLE=true
COLLABORA_REMOTE_FONT=
COLLABORA_ENABLE_FILE_LOGGING=false

Wartość portu to port skierowany do hosta używany w przykładzie Compose firmy Seafile; Collabora nasłuchuje na porcie 9980 w kontenerze. Zachowaj prywatność konsoli administracyjnej lub ogranicz dostęp na serwerze proxy/zaporze sieciowej. Powyższa nazwa użytkownika i hasło to przykłady — wybierz unikalne dane uwierzytelniające i chroń plik. Jeśli Twoja organizacja nie potrzebuje konsoli administracyjnej, postępuj zgodnie z obsługiwanym ustawieniem szablonu Compose, aby ją wyłączyć.

3. Skonfiguruj połączenie WOPI Seafile

Edytuj seahub_settings.pyi dodaj ustawienia integracji Collabora. W przypadku kontenerów w tej samej sieci Compose, obecny przykład Seafile używa wewnętrznej nazwy usługi collabora:

OFFICE_SERVER_TYPE = 'CollaboraOffice'
ENABLE_OFFICE_WEB_APP = True
OFFICE_WEB_APP_BASE_URL = 'http://collabora:9980/hosting/discovery'
WOPI_ACCESS_TOKEN_EXPIRATION = 30 * 60
OFFICE_PREVIEW_MAX_SIZE = 30 * 1024 * 1024
ENABLE_OFFICE_WEB_APP_EDIT = True

OFFICE_WEB_APP_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)
OFFICE_WEB_APP_EDIT_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)

Wewnętrzny adres URL do wyszukiwania służy do komunikacji Seafile-Collabora w sieci współdzielonej Docker. Przeglądarki użytkowników muszą również mieć dostęp do adresu Collabora udostępnianego im przez integrację. Postępuj zgodnie z oficjalnym plikiem Compose i konfiguracją proxy, aby trasa skierowana do przeglądarki była publikowana bezpiecznie; nazwa hosta obejmująca tylko kontener, która jest rozpoznawana tylko w Dockerze, nie jest użytecznym publicznym adresem URL przeglądarki.

Ogranicz listy rozszerzeń plików do formatów potrzebnych użytkownikom i obsługiwanych przez kompilację Collabora. Ustawienie rozmiaru podglądu pokazane powyżej to wartość 30 MiB w bieżącym przykładzie Seafile; większe dokumenty mogą wymagać celowej zmiany limitu, z uwzględnieniem związanego z tym wpływu na pamięć i wydajność.

4. Uruchom lub zaktualizuj usługi

Sprawdź konfigurację Compose, a następnie uruchom stos z katalogu projektu:

docker compose config
docker compose up -d

W poradniku Seafile zaleca się ponowne uruchomienie Seafile po zmianie seahub_settings.py. W przypadku wdrożeń Dockera, docker compose up -dzastosuj zaktualizowaną konfigurację Compose; jeśli zmiana ustawień nie zostanie wprowadzona, uruchom ponownie usługę Seafile, używając metody odpowiedniej dla swojego wydania. Unikaj metody „broad”, docker compose downchyba że zamierzasz zatrzymać cały stos.

Opcja B: Skieruj Seafile do Collabora na innym hoście

Zainstaluj i udostępnij Collabora, korzystając z oficjalnych instrukcji wdrażania i odwrotnego proxy. Użyj protokołu HTTPS w standardowym publicznym punkcie końcowym i żądań proxy do wewnętrznego portu Collabora 9980. Upewnij się, że host Seafile może połączyć się z Collabora i że Collabora może połączyć się z adresem HTTPS Seafile; oba kierunki mają znaczenie dla ładowania dokumentów WOPI.

Zachowaj pozostałe ustawienia Seafile z poprzedniej sekcji, ale zmień ustawienie wykrywania na rzeczywistą nazwę hosta Collabora:

OFFICE_WEB_APP_BASE_URL = 'https://office.example.com/hosting/discovery'

Użyj swojej rzeczywistej nazwy hosta i certyfikatu. Nie podawaj nazwy wewnętrznej usługi Docker, chyba że Seafile i Collabora rzeczywiście współdzielą sieć, w której ta nazwa jest rozpoznawana. Osobny host zapewnia niezależną kontrolę nad zasobami i konserwacją, ale dodaje obsługę DNS, zapory sieciowej, certyfikatów i odwrotnego proxy. W przypadku klastra Seafile należy postępować zgodnie z projektem proxy i wykrywania usług klastra, zamiast zakładać, że obowiązuje jednowęzłowa sieć Compose.

Jak sprawdzić, czy połączenie działa

1. Otwórz https://office.example.com/hosting/discoveryz przeglądarki, jeśli korzystasz z osobnego hosta. W przypadku konfiguracji z tym samym hostem przetestuj publiczną trasę Collabora opublikowaną przez serwer proxy. Pomyślna odpowiedź potwierdza, że ​​punkt końcowy wykrywania jest osiągalny, choć sama w sobie nie dowodzi, że edycja WOPI działa.
2. Zaloguj się do Seafile i otwórz mały, niewrażliwy plik .docx, .xlsx, lub , .odtktóry znajduje się na skonfigurowanej liście rozszerzeń.
3. Sprawdź, czy plik otwiera się w aplikacji Collabora, wprowadź nieszkodliwe zmiany, poczekaj na zakończenie zapisywania i zamknij edytor.
4. Otwórz ponownie plik w Seafile i sprawdź, czy zmiana została zachowana. Aby mieć pewność, pobierz kopię i potwierdź oczekiwaną zawartość.

Przetestuj plik, który możesz bezpiecznie zmodyfikować. Widoczny edytor bez poprawnego zapisu to tylko częściowy sukces: WOPI musi być w stanie pobrać plik i zwrócić edytowaną wersję do Seafile.

Typowe awarie i którą stronę sprawdzić

W przypadku logów Dockera i dokumentów Seafile docker logs seafile-collabora. Sprawdź logi Seafile/Seahub wraz z danymi wyjściowymi Collabora i porównaj żądania z serwerem proxy. Nie włączaj szczegółowego rejestrowania ani rejestrowania plików na czas nieokreślony, jeśli ujawnia to adresy URL dokumentów lub inne poufne szczegóły operacyjne. Oficjalny przewodnik rozwiązywania problemów z Collabora zawiera dodatkowe kontrole błędów po stronie Collabora.

Który wybór ma sens?

Wybierz kontener w pakiecie, jeśli instalacja Seafile jest pojedynczym hostem Dockera, chcesz korzystać z obsługiwanego okablowania Compose, a współdzielenie procesora i pamięci z Seafile jest dopuszczalne. Wybierz oddzielny host Collabora, jeśli już korzystasz z hosta, potrzebujesz niezależnej pojemności lub harmonogramów aktualizacji albo integrujesz architekturę wielohostową i możesz niezawodnie utrzymać protokół HTTPS i routing sieciowy. W obu przypadkach postępuj zgodnie z dokumentacją odpowiadającą Twojej wersji Seafile, zadbaj o bezpieczeństwo punktów końcowych widocznych w przeglądarce i zweryfikuj otwieranie i zapisywanie dokumentów przed zezwoleniem użytkownikom na edycję online.