Otwierasz plik DOCX w NextCloud, ONLYOFFICE ładuje się normalnie, wprowadzasz zmianę, a edytor zgłasza: „Nie można zapisać dokumentu”. Kusząca konkluzja to, że przeglądarka zgubiła plik lub że sam ONLYOFFICE nie może zapisać go na dysku. W przypadku integracji z NextCloud często jest to niewłaściwy punkt wyjścia.
Istotnym szczegółem jest sposób działania zapisywania. Nextcloud przekazuje do ONLYOFFICE Docs adres URL dokumentu i rozszerzenie callbackUrl. ONLYOFFICE pobiera plik, hostuje sesję edycji, a następnie wywołuje Nextcloud, aby Nextcloud mógł pobrać zaktualizowany plik i zastąpić zapisaną wersję. Oficjalna dokumentacja integracji ONLYOFFICE opisuje tę wymianę wywołań zwrotnych wprost. Oznacza to, że edytor może zostać pomyślnie otwarty, nawet jeśli ścieżka powrotu używana do zapisywania jest uszkodzona. Działanie: potraktuj otwieranie i zapisywanie jako dwa oddzielne testy sieciowe.
Zgodnie z aktualną oficjalną dokumentacją integracji, łącznik Nextcloud w ONLYOFFICE korzysta z przepływu pracy serwer-serwer: serwer dokumentów musi być dostępny z Nextcloud, a serwer dokumentów również musi być dostępny z serwera dokumentów. Po zakończeniu edycji, ONLYOFFICE wysyła żądanie POST na adres URL wywołania zwrotnego; Nextcloud pobiera edytowany dokument i zastępuje poprzednią wersję. Zobacz oficjalny przewodnik integracji Nextcloud w ONLYOFFICE oraz opis interfejsu API ONLYOFFICE dotyczący integracji Nextcloud .
Zweryfikowano: nieprawidłowa lub niedostępna ścieżka wywołania zwrotnego może spowodować błąd zapisu nawet po otwarciu edytora. Dokumentacja rozwiązywania problemów ONLYOFFICE wyraźnie zaleca administratorom sprawdzenie dzienników DocService i sprawdzenie, czy adres URL wywołania zwrotnego jest dostępny w przypadku wystąpienia błędu zapisu. Działanie: nie rozpoczynaj od ponownej instalacji edytora ani czyszczenia pamięci podręcznej przeglądarki; najpierw przetestuj ścieżkę serwer-serwer.
Na hoście Nextcloud uruchom sprawdzanie konektora ONLYOFFICE jako użytkownik serwera WWW. W typowej instalacji Debiana lub Ubuntu:
cd /var/www/nextcloud
sudo -E -u www-data php occ onlyoffice:documentserver --checkDokładna ścieżka Nextcloud i użytkownik HTTP mogą się różnić w zależności od dystrybucji lub układu kontenera. Własny podręcznik administracyjny Nextcloud zaleca uruchamianie occjako użytkownik HTTP, aby zapewnić spójność własności plików. Dokumenty ONLYOFFICE occ onlyoffice:documentserver --checksłużą jako test połączenia łącznika.
Dowodzi to: może ujawnić oczywisty błąd konfiguracji lub połączenia z serwerem dokumentów. Czego nie dowodzi: każde wywołanie zwrotne wygenerowane podczas rzeczywistej sesji edycji zakończy się sukcesem przez każdy serwer proxy, trasę DNS i warstwę uwierzytelniania. Działanie: jeśli sprawdzenie zakończy się pomyślnie, ale zapis nadal się nie powiedzie, należy przejść do wywołania zwrotnego i logów zamiast deklarować poprawność integracji.
W NextCloud otwórz Ustawienia → Administracja → ONLYOFFICE . Główny adres DOCs ONLYOFFICE musi być dostępny dla odpowiednich klientów i usług. Jeśli publiczne adresy URL nie są wewnętrznie routowalne z powodu sieci Docker, NAT, DNS typu split-horizon lub polityki zapory sieciowej, rozwiń zaawansowane ustawienia serwera.
Oficjalny łącznik udostępnia oddzielne adresy wewnętrzne na wypadek właśnie takiej sytuacji:
Na przykład dwa kontenery w tej samej sieci Compose mogą używać wewnętrznie nazw usług, podczas gdy przeglądarki nadal korzystają z publicznych nazw hostów HTTPS. Nie kopiuj bezmyślnie tego wzorca: nazwy muszą być faktycznie rozpoznawane w Twojej sieci. Działanie: przetestuj każdy kierunek z maszyny lub kontenera, który wysyła żądanie.
Ten wniosek nie jest wiarygodny. Przeglądarka, Nextcloud i ONLYOFFICE Docs to trzej różni uczestnicy sieci. Przeglądarka może nawiązać połączenie, office.example.compodczas gdy kontener serwera dokumentów nie może go rozwiązać ani połączyć się z nim cloud.example.com. Podobnie, Nextcloud może nawiązać połączenie z ONLYOFFICE poprzez wewnętrzną nazwę hosta, podczas gdy wywołanie zwrotne wskazuje na niedostępny adres publiczny.
Działanie: wprowadź kontener lub host ONLYOFFICE i przetestuj adres Nextcloud, którego ma używać. Podstawowe żądanie HTTPS do hosta Nextcloud może potwierdzić dostępność DNS/TCP/TLS, ale należy pamiętać, że pomyślne status.phpżądanie nie weryfikuje rzeczywistej autoryzacji wywołania zwrotnego ani obsługi POST.
JWT to kolejne częste źródło nieporozumień. Począwszy od ONLYOFFICE Docs 7.2, JWT jest domyślnie włączony, a klucz tajny jest generowany automatycznie. Oficjalne instrukcje wymagają tego samego klucza tajnego na serwerze dokumentów i w konektorze Nextcloud ONLYOFFICE. Aktualna dokumentacja konektora ujawnia również ustawienie nagłówka autoryzacji dla instalacji, które nie używają domyślnego nagłówka.
Zweryfikowano: współdzielony klucz tajny musi być zgodny. Zależne od wdrożenia: dokładne miejsce zarządzania nim zależy od tego, czy ONLYOFFICE jest zainstalowany z pakietów, w systemie Windows czy w Dockerze. We wdrożeniach Dockera JWT_SECRETpowszechnie używana jest zmienna środowiskowa; efektywną konfigurację serwera można również sprawdzić w /etc/onlyoffice/documentserver/local.json.
Działanie: porównaj efektywne ustawienia klucza tajnego i nagłówka po obu stronach, a następnie uruchom ponownie usługi ONLYOFFICE lub kontener po zmianach po stronie serwera. Nie „naprawiaj” problemu poprzez trwałe wyłączenie JWT; usuwa to kontrolę bezpieczeństwa zamiast poprawiać konfigurację. Szczegóły znajdują się w przewodniku konfiguracji JWT ONLYOFFICE .
ONLYOFFICE zaleca sprawdzenie logów DocService pod kątem błędów zapisu. W przypadku instalacji Linux i Dockera, logi Document Server znajdują się w sekcji /var/log/onlyoffice/documentserver; użytkownicy Dockera mogą również śledzić dane wyjściowe kontenera za pomocą docker logs -f <container>. Jeśli potrzebujesz więcej szczegółów, ONLYOFFICE dokumentuje tymczasowy tryb debugowania za pomocą DS_LOG_LEVEL=DEBUGkonfiguracji log4js. Zobacz oficjalny przewodnik po logowaniu debugowania .
W NextCloud domyślny dziennik plikowy znajduje się zazwyczaj nextcloud.logw skonfigurowanym katalogu danych. Aktywną ścieżkę można znaleźć za pomocą:
sudo -E -u www-data php occ log:fileNextcloud dokumentuje również log:taildostępność log:watchaplikacji Log Reader. Działanie: odtwórz jeden błąd zapisu, zanotuj znacznik czasu, a następnie skoreluj obie strony. Odmowa sieci, błąd TLS, odpowiedź 401/403, odpowiedź 5xx lub wyjątek pamięci masowej wskazują na zupełnie inne rozwiązania.
Certyfikat podpisany samodzielnie lub wydany prywatnie może przerwać połączenie HTTPS między serwerami, gdy odpowiadający mu urząd certyfikacji nie jest zaufany. Konektor posiada opcję „ Wyłącz weryfikację certyfikatu (niezabezpieczony) , ale ONLYOFFICE wyraźnie określa ją jako niebezpieczną i zaleca zastąpienie certyfikatu certyfikatem wydanym przez zaufany urząd certyfikacji. Działanie: używaj obejścia weryfikacji certyfikatu tylko jako krótkiego kroku diagnostycznego w kontrolowanym środowisku; trwałym rozwiązaniem jest poprawny łańcuch certyfikatów zaufany przez oba serwery.
Jeśli serwer proxy odwrotnego znajduje się przed ONLYOFFICE, sprawdź, czy zachowuje on oczekiwany schemat, hosta i zachowanie aktualizacji. ONLYOFFICE publikuje dedykowane wskazówki dotyczące serwera proxy odwrotnego, w tym dotyczące przekazywanych nagłówków i ustawień związanych z WebSocket. Zapoznaj się z przewodnikiem konfiguracji serwera proxy odwrotnego Nextcloud firmy ONLYOFFICE .
Zależne od wdrożenia: dokładnej konfiguracji Nginx, Apache, Traefik, HAProxy, kontrolera wejściowego ani CDN nie można wywnioskować na podstawie samego błędu zapisu. Działanie: porównaj konfigurację serwera proxy z przykładem dostawcy dla swojej topologii i sprawdź status HTTP zarejestrowany podczas wywołania zwrotnego przed losową zmianą limitów czasu lub nagłówków.
Gdy logi potwierdzą, że wywołanie zwrotne dotarło do NextCloud, przejdź niżej w stosie. NextCloud musi być w stanie pobrać nowy dokument i zastąpić zapisaną wersję. Uprawnienia lokalnego systemu plików, montowanie w trybie tylko do odczytu, wyczerpane miejsce na dysku, ograniczenia kwotowe, niedostępność pamięci zewnętrznej lub wyjątek aplikacji/pamięci masowej mogą uniemożliwić ostateczny zapis.
Co wiadomo: wartości statusu wywołania zwrotnego ONLYOFFICE odróżniają dokument gotowy do zapisania od błędu zapisu, a wywołanie zwrotne zawiera adres URL do edytowanego dokumentu, który usługa pamięci masowej może pobrać. Oficjalna dokumentacja obsługi wywołania zwrotnego definiuje status 2 jako gotowy do zapisania, a status 3 jako błąd zapisu.
Czego nie wiadomo z samego komunikatu przeglądarki: czy awaria wystąpiła w ONLYOFFICE, na ścieżce sieciowej, w Nextcloud, czy w pamięci masowej. Działanie: nie zmieniaj rekurencyjnie właściciela pliku w katalogu danych Nextcloud tylko dlatego, że edytor zgłasza, że nie może go zapisać. Najpierw sprawdź błąd po stronie pamięci masowej w logu Nextcloud.
Kolejnym błędnym przekonaniem jest to, że każde naciśnięcie przycisku „Zapisz” natychmiast zastępuje plik zapisany w NextCloud. Konektor może korzystać z opcji pośredniego zapisu lub wymuszonego zapisu. Oficjalny przewodnik integracji podaje, że po włączeniu opcji „Zachowaj wersje pośrednie podczas edycji (wymusza zapis)” kliknięcie przycisku „Zapisz” powoduje wysłanie zmian bezpośrednio do pamięci masowej; w przeciwnym razie zmiany są zachowywane w pamięci podręcznej edytora, a normalny proces ostatecznego zapisu odbywa się później.
Ma to znaczenie przy rozwiązywaniu problemów. Jeśli tylko wymuszenie zapisu się nie powiedzie, ale zwykłe zamknięcie i zapisanie się powiedzie, lub odwrotnie, znaczniki czasu i statusy wywołań zwrotnych staną się cennym dowodem. Działanie: odtwórz awarię w jednym, jasno zdefiniowanym przepływie pracy i przechwyć logi z tej próby zamiast łączyć ręczne zapisywanie, zamykanie przeglądarki i jednoczesne otwieranie wielu kart edytora.
| Objaw | Najbardziej przydatne następne sprawdzenie | Nie zakładaj |
|---|---|---|
| Edytor w ogóle się nie otworzy | Adres URL serwera dokumentów, JWT, dostępność przeglądarki/serwera | Że to problem, który można jedynie zapisać |
| Edytor otwiera się, ale zapisywanie nie udaje się | Dostępność wywołania zwrotnego i dzienniki DocService | To udane otwarcie dowodzi drogi powrotnej |
| 401/403 w ruchu wywołań zwrotnych lub poleceń | Tajemnica JWT i nagłówek autoryzacji | Powodem jest przekroczenie limitu czasu serwera proxy |
| Błędy walidacji TLS/certyfikatu | Łańcuchy certyfikatów i sklepy zaufane | Wyłączenie weryfikacji jest trwałym rozwiązaniem |
| Wywołanie zwrotne dociera do NextCloud, ale plik pozostaje niezmieniony | Dziennik Nextcloud, montowanie pamięci masowej, limit, błędy zapisu | Tylko ONLYOFFICE zgubił edycję |
| Awarie występują tylko za serwerem proxy/NAT | Zaawansowane wewnętrzne adresy URL i przekierowane trasy | Publiczne adresy URL działają identycznie wewnątrz kontenerów |
Użyj małego, testowego pliku DOCX w folderze niekrytycznym. Otwórz go w ONLYOFFICE, wpisz unikatowy wiersz, taki jak znacznik czasu, poczekaj, aż edytor zgłosi zmianę jako zapisaną, a następnie zamknij edytor normalnie. Otwórz plik ponownie z poziomu NextCloud i upewnij się, że tekst jest obecny. Następnie sprawdź historię wersji, jeśli Twoje wdrożenie z niej korzysta, i sprawdź logi serwera pod kątem tego samego przedziału czasowego.
Następnie ponownie uruchom sprawdzanie złącza:
sudo -E -u www-data php occ onlyoffice:documentserver --checkDobrym wynikiem nie jest po prostu „otwarcie edytora”. Pełny test wygląda następująco: Nextcloud może nawiązać połączenie z ONLYOFFICE, ONLYOFFICE może nawiązać połączenie z adresem wywołania zwrotnego w Nextcloud, uwierzytelnianie kończy się powodzeniem, Nextcloud może pobrać zaktualizowany plik, a zaplecze pamięci masowej akceptuje plik zastępczy.
Jeśli żaden z logów nie wskazuje na ewidentny błąd, tymczasowo zwiększ poziom logowania ONLYOFFICE i Nextcloud podczas jednego kontrolowanego odtwarzania, a następnie przywróć normalny poziom logowania. Nextcloud ostrzega, że logowanie DEBUG jest rozwlekłe i może wpływać na wydajność, dlatego powinno być środkiem diagnostycznym, a nie stałym ustawieniem produkcyjnym. Przed zmianą poziomów logowania zapoznaj się z dokumentacją Nextcloud dotyczącą logowania .
W tym momencie zachowaj dokładne znaczniki czasu, kody statusu HTTP, wersję łącznika, wersję Nextcloud, wersję ONLYOFFICE Docs, topologię i odpowiednie zredagowane wiersze logu. Te informacje są o wiele bardziej przydatne niż ogólny komunikat przeglądarki „Nie można zapisać dokumentu”.
Dowiedz się, jak przeciągać obraz w programie Word, wybierać opcje zawijania tekstu, zachowywać go w akapicie lub mocować na stronie oraz rozwiązywać problemy z obrazami, których nie można przenieść.
Dowiedz się, jak wstawić pole wyboru w programie Excel za pomocą narzędzia w komórce, zliczyć zaznaczone elementy za pomocą formuł lub dodać powiązany formant formularza w starszych wersjach programu na komputery stacjonarne.
Generuj litery od A do Z, małe litery lub etykiety powyżej Z w programie Excel za pomocą formuły z uchwytem wypełniania, SEKWENCJI lub wielokrotnego użytku listy niestandardowej.
Dowiedz się, jak przekreślać wiersze w programie Excel w systemie Windows, na komputerze Mac i w przeglądarce, formatować część komórki i usuwać wiersze bez usuwania ich wartości.
Microsoft Access to aplikacja bazy danych systemu Windows do przechowywania powiązanych rekordów, tworzenia zapytań, tworzenia formularzy wprowadzania danych i generowania raportów. Dowiedz się, jak działa i kiedy się sprawdza.
Dowiedz się, jak zaimportować plik PST do programu Outlook 2010 lub wyeksportować pocztę, kontakty, kalendarz i zadania. Postępuj zgodnie z odpowiednimi menu i unikaj pominiętych folderów lub duplikatów.
Dowiedz się, jak dostosować wysokość i szerokość linii siatki w programie Word 2010, zmienić widoczną częstotliwość linii oraz ustawić odstępy między liniami siatki w pionie i w poziomie.
Za pomocą dodatku LiveWeb możesz umieścić witrynę internetową na slajdzie programu PowerPoint, ustawić jej rozmiar i sposób odświeżania oraz sprawdzić zgodność przed prezentacją.
Odzyskaj zapomniane hasło PST programu Outlook, korzystając z bieżących instrukcji Kernela, obejmujących m.in. identyfikację właściwego pliku, wykonanie kopii zapasowej i sprawdzenie ograniczeń narzędzia.
Dodaj święta krajowe w nowym Outlooku, Outlooku w przeglądarce lub klasycznej wersji Outlooka. Dowiedz się, jak unikać duplikatów wydarzeń i sprawdzać, czy nie brakuje dat z lat 2026–2027.
