Deschizi un fișier DOCX în Nextcloud, ONLYOFFICE se încarcă normal, faci o modificare, iar apoi editorul raportează „Documentul nu a putut fi salvat”. Concluzia tentantă este că browserul a pierdut fișierul sau că ONLYOFFICE în sine nu poate scrie pe disc. Într-o integrare Nextcloud, acesta este adesea locul greșit de unde să începi.
Detaliul important este cum funcționează salvarea. Nextcloud oferă către ONLYOFFICE Docs o adresă URL a documentului și o extensie callbackUrl. ONLYOFFICE descarcă fișierul, găzduiește sesiunea de editare și ulterior apelează Nextcloud înapoi, astfel încât Nextcloud să poată prelua fișierul actualizat și să înlocuiască versiunea stocată. Documentația oficială de integrare ONLYOFFICE descrie explicit acest schimb de apeluri inverse. Aceasta înseamnă că editorul se poate deschide cu succes chiar dacă calea de retur utilizată pentru salvare este întreruptă. Acțiune: tratați deschiderea și salvarea ca două teste de rețea separate.
Conform documentației oficiale actuale de integrare, conectorul Nextcloud al ONLYOFFICE utilizează un flux de lucru server-to-server: serverul de documente trebuie să fie accesibil din Nextcloud, iar Nextcloud trebuie să fie, de asemenea, accesibil din serverul de documente. La finalizarea editării, ONLYOFFICE trimite o solicitare POST la adresa URL de apel invers; Nextcloud descarcă apoi documentul editat și înlocuiește versiunea anterioară. Consultați ghidul oficial de integrare ONLYOFFICE Nextcloud și descrierea API-ului ONLYOFFICE pentru integrarea Nextcloud .
Verificat: o cale de apel invers greșită sau inaccesibilă poate produce o eroare de salvare chiar și atunci când editorul este deschis. Documentația de depanare ONLYOFFICE le spune în mod specific administratorilor să verifice jurnalele DocService și să verifice dacă adresa URL de apel invers este accesibilă atunci când apare o eroare de salvare. Acțiune: nu începeți prin a reinstala editorul sau a goli memoria cache a browserului; testați mai întâi calea de la server la server.
Pe gazda Nextcloud, rulați verificarea conectorului ONLYOFFICE ca utilizator al serverului web. Pe o instalare tipică Debian sau Ubuntu:
cd /var/www/nextcloud
sudo -E -u www-data php occ onlyoffice:documentserver --checkCalea exactă Nextcloud și utilizatorul HTTP pot diferi în funcție de distribuție sau de aspectul containerului. Manualul de administrare Nextcloud recomandă rularea occca utilizator HTTP, astfel încât proprietatea fișierelor să rămână consistentă. Documentele ONLYOFFICE sunt folosite occ onlyoffice:documentserver --checkca test de conexiune a conectorului.
Ce dovedește acest lucru: poate dezvălui o eroare evidentă de configurare sau de conectivitate a serverului de documente. Ce nu dovedește: fiecare apel invers generat în timpul unei sesiuni de editare reale va reuși prin fiecare proxy, rută DNS și strat de autentificare. Acțiune: dacă verificarea trece, dar salvarea tot eșuează, continuați la apelul invers și la jurnale în loc să declarați integrarea sănătoasă.
În Nextcloud, deschideți Setări → Administrare → ONLYOFFICE . Adresa principală ONLYOFFICE Docs trebuie să poată fi utilizată de clienții și serviciile relevante. Dacă URL-urile publice nu sunt rutabile intern din cauza politicii de rețea Docker, NAT, DNS split-horizon sau firewall, extindeți setările avansate ale serverului.
Conectorul oficial expune adrese interne separate exact pentru această situație:
De exemplu, două containere din aceeași rețea Compose pot utiliza intern nume de servicii, în timp ce browserele utilizează în continuare nume de gazdă HTTPS publice. Nu copiați orbește acest model: numele trebuie să se rezolve efectiv în rețeaua dvs. Acțiune: testați fiecare direcție de la mașina sau containerul care originează solicitarea.
Această concluzie nu este fiabilă. Browserul, Nextcloud și ONLYOFFICE Docs sunt trei participanți diferiți la rețea. Browserul poate ajunge la ONLYOFFICE office.example.comîn timp ce containerul Document Server nu poate rezolva problema sau se poate conecta la cloud.example.com. De asemenea, Nextcloud poate ajunge la ONLYOFFICE printr-un nume de gazdă intern, în timp ce apelul invers indică o adresă publică inaccesibilă.
Acțiune: introduceți containerul sau gazda ONLYOFFICE și testați adresa Nextcloud pe care se așteaptă să o utilizeze. O solicitare HTTPS de bază către gazda Nextcloud poate confirma accesibilitatea DNS/TCP/TLS, dar rețineți că o status.phpsolicitare reușită nu validează autorizarea reală de apel invers sau gestionarea POST.
JWT este o altă sursă frecventă de confuzie. Începând cu ONLYOFFICE Docs 7.2, JWT este activat în mod implicit și o cheie secretă este generată automat. Instrucțiunile oficiale necesită același secret pe serverul de documente și în conectorul ONLYOFFICE Nextcloud. Documentația actuală a conectorului expune, de asemenea, setarea antetului de autorizare pentru instalările care nu utilizează antetul implicit.
Verificat: secretul partajat trebuie să corespundă. Dependent de implementare: locul exact în care îl gestionați depinde de dacă ONLYOFFICE este instalat din pachete, pe Windows sau în Docker. În implementările Docker, JWT_SECRETse utilizează în mod obișnuit o variabilă de mediu; configurația efectivă a serverului poate fi, de asemenea, inspectată în /etc/onlyoffice/documentserver/local.json.
Acțiune: comparați setările efective ale secretului și antetului de pe ambele părți, apoi reporniți serviciile ONLYOFFICE sau containerul după modificările aduse serverului. Nu „remediați” problema dezactivând permanent JWT; acest lucru elimină un control de securitate în loc să corecteze configurația. Detaliile se găsesc în ghidul de configurare JWT de la ONLYOFFICE .
ONLYOFFICE recomandă verificarea jurnalelor DocService pentru erori de salvare. Pentru instalările Linux și Docker, jurnalele Document Server se află sub /var/log/onlyoffice/documentserver; utilizatorii Docker pot urmări și ieșirea containerului cu docker logs -f <container>. Dacă sunt necesare mai multe detalii, ONLYOFFICE documentează un mod temporar de depanare prin DS_LOG_LEVEL=DEBUGsau prin configurația log4js. Consultați ghidul oficial de înregistrare a depanării .
Pe Nextcloud, jurnalul implicit bazat pe fișiere se află în mod normal nextcloud.logîn directorul de date configurat. Puteți descoperi calea activă cu:
sudo -E -u www-data php occ log:fileNextcloud documentează log:tailși log:watchcând aplicația Log Reader este disponibilă. Acțiune: reproduceți o eroare de salvare, notați marcajul temporal, apoi corelați ambele părți. Un refuz de rețea, o eroare TLS, un răspuns 401/403, un răspuns 5xx sau o excepție de stocare indică remedieri foarte diferite.
Un certificat autosemnat sau emis privat poate întrerupe protocolul HTTPS server-to-server atunci când CA-ul corespunzător nu este de încredere. Conectorul are opțiunea Dezactivare verificare certificat (nesigur) , dar ONLYOFFICE îl descrie explicit ca fiind nesigur și recomandă înlocuirea certificatului cu unul emis de un CA de încredere. Acțiune: utilizați ocolirea verificării certificatului doar ca un pas scurt de diagnosticare într-un mediu controlat; soluția durabilă este un lanț de certificate valid, de încredere pentru ambele servere.
Dacă un proxy invers se află în fața ONLYOFFICE, confirmați că acesta păstrează schema, gazda și comportamentul de actualizare așteptate. ONLYOFFICE publică îndrumări dedicate pentru proxy-ul invers, inclusiv anteturi redirecționate și setări legate de WebSocket. Consultați ghidul de configurare a proxy-ului invers Nextcloud de la ONLYOFFICE .
Dependent de implementare: configurația exactă Nginx, Apache, Traefik, HAProxy, ingress-controller sau CDN nu poate fi dedusă doar din eroarea de salvare. Acțiune: comparați configurația proxy-ului cu exemplul furnizorului pentru topologia dvs. și examinați starea HTTP înregistrată în timpul apelului invers înainte de a modifica timeout-urile sau anteturile în mod aleatoriu.
Odată ce jurnalele dovedesc că apelul invers ajunge cu succes la Nextcloud, se trece la stivă în jos. Nextcloud trebuie să poată recupera noul document și să înlocuiască versiunea stocată. Permisiunile sistemului de fișiere local, o montare doar pentru citire, spațiul pe disc epuizat, restricțiile de cotă, stocarea externă indisponibilă sau o excepție de aplicație/stocare pot împiedica scrierea finală.
Ce se știe: Valorile de stare ale apelului invers ONLYOFFICE disting un document gata de salvare de o eroare de salvare, iar apelul invers conține o adresă URL către documentul editat pe care serviciul de stocare îl poate recupera. Documentația oficială a gestionării apelurilor inverse definește starea 2 ca fiind gata de salvare și starea 3 ca o eroare de salvare.
Ceea ce nu se știe doar din mesajul browserului: dacă eroarea s-a produs în ONLYOFFICE, pe calea de rețea, în Nextcloud sau în spațiul de stocare subiacent. Acțiune: nu modificați recursiv proprietatea fișierului dintr-un director de date Nextcloud doar pentru că editorul spune că nu poate salva. Confirmați mai întâi o eroare la nivelul spațiului de stocare în jurnalul Nextcloud.
O altă concepție greșită este că fiecare apăsare a butonului „Salvare” înlocuiește imediat fișierul stocat de Nextcloud. Conectorul poate utiliza o opțiune de salvare intermediară sau de salvare forțată. Ghidul oficial de integrare spune că atunci când este activată opțiunea „Păstrați versiunile intermediare la editare” (salvare forțată) , dacă faceți clic pe „Salvare”, modificările sunt trimise direct în spațiul de stocare; în caz contrar, modificările sunt păstrate în memoria cache a editorului, iar fluxul de lucru normal de salvare finală are loc ulterior.
Acest aspect este important pentru depanare. Dacă doar salvarea forțată eșuează, dar închiderea și salvarea normală reușește sau invers, marcajele temporale și stările de apel invers devin dovezi valoroase. Acțiune: reproduceți eroarea într-un flux de lucru clar definit și capturați jurnalele acelei încercări, în loc să combinați salvarea manuală, închiderea browserului și mai multe file simultane ale editorului.
| Simptom | Cea mai utilă verificare următoare | Nu presupune |
|---|---|---|
| Editorul nu se deschide deloc | URL-ul serverului de documente, JWT, accesibilitate browser/server | Că este o problemă de salvare exclusivă |
| Editorul se deschide, dar salvarea eșuează | Accesibilitatea apelurilor inverse și jurnalele DocService | Această deschidere reușită dovedește calea de întoarcere |
| 401/403 în jurul traficului de apel invers sau de comandă | Secretul JWT și antetul de autorizare | Că o expirare a timpului proxy este cauza |
| Erori de validare TLS/certificat | Lanț de magazine certificate și magazine de încredere | Că dezactivarea verificării este o soluție permanentă |
| Callback-ul ajunge la Nextcloud, dar fișierul este neschimbat | Jurnal Nextcloud, montare spațiu de stocare, cotă, erori de scriere | Că ONLYOFFICE a pierdut editarea. |
| Eșecuri doar în spatele proxy/NAT | URL-uri interne avansate și rutare redirecționată | URL-urile publice funcționează identic în interiorul containerelor |
Folosește un fișier DOCX de test de mici dimensiuni într-un folder necritic. Deschide-l în ONLYOFFICE, tastează o linie unică, cum ar fi un timestamp, așteaptă ca editorul să raporteze modificarea ca salvată, apoi închide editorul normal. Redeschide fișierul din Nextcloud și confirmă că textul este prezent. Apoi, inspectează istoricul versiunilor dacă implementarea ta îl folosește și verifică jurnalele serverului pentru aceeași fereastră de timp.
Apoi rulați din nou verificarea conectorului:
sudo -E -u www-data php occ onlyoffice:documentserver --checkUn rezultat bun nu este doar „se deschide editorul”. Testul complet este: Nextcloud poate ajunge la ONLYOFFICE, ONLYOFFICE poate ajunge la adresa de apel invers pe Nextcloud, autentificarea are succes, Nextcloud poate prelua fișierul actualizat, iar backend-ul de stocare acceptă înlocuirea.
Dacă niciuna dintre jurnale nu prezintă o eroare evidentă, creșteți temporar jurnalizarea ONLYOFFICE și Nextcloud în timpul unei reproduceri controlate, apoi reveniți la nivelul jurnalului la normal. Nextcloud avertizează că jurnalizarea DEBUG este detaliată și poate afecta performanța, deci ar trebui să fie o măsură de diagnosticare mai degrabă decât o setare de producție permanentă. Consultați documentația de jurnalizare Nextcloud înainte de a modifica nivelurile jurnalizării.
În acel moment, păstrați timestamp-urile exacte, codurile de stare HTTP, versiunea conectorului, versiunea Nextcloud, versiunea ONLYOFFICE Docs, topologia și liniile de jurnal redactate relevante. Aceste informații sunt mult mai utile decât mesajul generic „Documentul nu a putut fi salvat” al browserului.
Aflați cum să importați un fișier PST în Outlook 2010 sau să exportați e-mailuri, contacte, calendar și activități. Urmați meniurile corecte și evitați folderele lipsă sau duplicatele.
Aflați cum să ajustați înălțimea și lățimea grilei în Word 2010, să modificați frecvența liniilor vizibile și să setați spațierea orizontală și verticală subiacentă a grilei de desen.
Recuperează o parolă Outlook PST uitată cu pașii actuali ai Kernel, inclusiv cum să identifici fișierul corect, să faci o copie de rezervă și să verifici limitele instrumentului.
Utilizați programul de completare LiveWeb pentru a plasa un site web pe un diapozitiv PowerPoint, a seta dimensiunea și comportamentul de reîmprospătare și a verifica compatibilitatea înainte de prezentare.
Adăugați sărbători specifice fiecărei țări în noul Outlook, Outlook pe web sau Outlook clasic. Aflați cum să evitați evenimentele duplicate și să verificați dacă lipsesc datele din perioada 2026-2027.
Exportați un tabel Access 2010 în Excel 2010, alegeți dacă doriți să includeți formatarea, salvați pașii de export reutilizabili și verificați problemele comune legate de transferul de date.
Găsiți șabloane Word 2010 încorporate, începeți un document dintr-un fișier .dotx descărcat și salvați un șablon personalizat reutilizabil fără a suprascrie lucrarea.
Utilizați secțiunile PowerPoint 2010 pentru a grupa diapozitive corelate, a redenumi și a rearanja grupuri și a naviga printr-un pachet lung de diapozitive fără a modifica conținutul diapozitivelor.
Folosește Inspectorul de documente din Word pentru a revizui detaliile autorului, comentariile, modificările urmărite, textul ascuns și alte date înainte de partajare și pentru a afla ce poate omite scanarea.
Mutați filele personalizate din panglică și comenzile din bara de instrumente Acces rapid în Office 2010 cu un fișier .exportedUI și protejați setările deja existente pe PC-ul de destinație.
