Începeți prin a verifica dacă ecranul gol afectează un fișier sau toate fișierele, apoi inspectați panourile Rețea și Consolă ale browserului, alături de jurnalele Collabora și ale platformei de stocare. O pânză goală este un simptom, nu un diagnostic: editorul s-ar fi putut încărca în timp ce conexiunea la document, autorizarea WOPI sau resursele încorporate au eșuat.
Deschideți un document cunoscut ca fiind valid în aceeași aplicație, apoi încercați fișierul afectat într-un alt browser acceptat sau într-o fereastră privată. Nu editați originalul în timpul diagnosticării. Un fișier defect indică formatul, conținutul sau permisiunile fișierului; erorile generalizate indică servicii partajate sau modificări ale rețelei.
| Ceea ce observați | Cea mai utilă verificare următoare | Compromis |
|---|---|---|
| Un document este gol | Încercați un alt fișier cu același format; verificați fișierul aplicației de stocare și jurnalele WOPI. | Izolare rapidă, dar nu exclude o problemă de analiză sau permisiuni specifică fișierului. |
| Toate documentele eșuează într-un singur browser | Fereastră privată, un alt browser, extensii și consolă de browser. | Risc redus și rapid, dar o soluție alternativă pentru browser nu repară o problemă a serverului. |
| Toți utilizatorii și browserele eșuează | Cereri de rețea, proxy invers, politică de gazdă WOPI și jurnale de server. | Mai multă valoare diagnostică, dar modificările pot afecta fiecare utilizator; capturați mai întâi setările actuale. |
O fereastră privată este un test, nu o soluție. Dacă funcționează acolo, dezactivați extensiile pe rând sau ștergeți datele site-ului pentru originea afectată numai după ce confirmați că nu aveți activități nesincronizate. Ștergerea tuturor datelor browserului poate deconecta utilizatorii și elimina starea site-ului fără legătură.
În Chrome sau Chromium, deschideți Instrumente pentru dezvoltatori ( F12 sau Ctrl+Shift+I ), selectați Rețea , activați Păstrare jurnal și reîncărcați. Filtrați pentru WS (WebSocket) și inspectați erorile; referința Chrome DevTools Network explică filtrele de solicitări și detaliile despre stare. Verificați consola pentru erori CSP, certificat, conținut mixt sau JavaScript.
Interpretați dovezile în loc să aplicați o rețetă generică indirectă:
/browser/căile editorului: verifică dacă proxy-ul invers redirecționează căile Collabora curente spre dreapta, în amonte./hosting/discoveryendpoint accesibil dovedește doar acces HTTP de bază; nu dovedește că conexiunea live a editorului funcționează.Pentru cererile WebSocket, obiectivul este o confirmare de handshake reușită; starea afișată depinde de versiunea HTTP și de calea proxy, așadar nu tratați un singur număr de stare așteptat ca fiind universal.
Ghidul actual de depanare a problemelor de la Nextcloud menționează că browserul utilizatorului trebuie să acceseze ambele servere prin HTTP(S), Nextcloud trebuie să acceseze Collabora și Collabora trebuie să acceseze Nextcloud. De asemenea, solicită același protocol pentru ambele servicii. Testați adresa publică Collabora dintr-un browser la https://office.example.com/hosting/discoveryși https://office.example.com/hosting/capabilities. De la gazda Nextcloud, utilizați:
curl -fsS https://office.example.com/hosting/discovery -o /dev/null
curl -fsS https://office.example.com/hosting/capabilities -o /dev/null
Înlocuiți numele de gazdă exemplu cu adresa URL Collabora reală. Aceste verificări stabilesc accesibilitatea HTTP, nu editarea cu succes. Dacă serverul reușește, dar browserul eșuează, verificați expunerea DNS public, TLS, firewall-ului sau proxy-ului. Ghidul de depanare Nextcloud Office listează aceste verificări ale conexiunii și recomandă revizuirea ambelor jurnalele de aplicații.
Dacă resursele editorului static returnează codul 404 sau conexiunea activă returnează codul 502, comparați rutele de proxy invers cu setările oficiale de proxy ale Collabora . Asigurați-vă că proxy-ul trimite căile Collabora necesare către upstream-ul corect și acceptă conexiunea WebSocket utilizată de browser. Păstrați informațiile despre gazda externă și HTTPS așteptate de implementare. Nu copiați o configurație pentru un proxy, un prefix URL sau o versiune Collabora diferită fără a verifica ipotezele acesteia. Un nume de gazdă Collabora dedicat este adesea mai ușor de depanat; rutarea bazată pe cale necesită o gestionare consistentă a prefixelor.
WOPI este protocolul utilizat de Collabora pentru a prelua și salva un document prin platforma de stocare. Gazda WOPI este de obicei numele de gazdă Nextcloud sau al altui spațiu de stocare, nu numele de gazdă Collabora. Dacă jurnalele spun No acceptable WOPI hosts found, adăugați sau corectați gazda de stocare exactă în configurația gazdei WOPI a Collabora, atunci confirmați că lista de solicitări WOPI permise a platformei de stocare conține adresa serverului Collabora. Nextcloud recomandă limitarea solicitărilor WOPI la adresele IP Collabora așteptate și configurarea Collabora să aibă încredere în gazdele așteptate în ghidul de configurare Office .
Adăugarea unei gazde de încredere specifice este mai sigură decât dezactivarea validării gazdei sau permiterea domeniilor largi. Înregistrați setarea curentă, modificați doar intrarea relevantă și reporniți sau reîncărcați serviciile numai după cum este necesar pentru implementare. Dacă utilizați Docker, verificați ieșirea recentă Collabora cu docker logs --since=10m <collabora-container>; înlocuiți substituentul cu numele real al containerului. Pentru instalările de pachete sau Kubernetes, utilizați în schimb jurnalele de servicii sau pod-uri ale acestora.
Reîncărcați același document. Confirmați că resursele se încarcă, conexiunea activă rămâne deschisă, conținutul apare și erorile din consolă se opresc. Testați un al doilea document și un alt utilizator dacă problema a fost partajată. Salvați o editare de test inofensivă și redeschideți-o pentru a verifica citirea și salvarea.
Dacă pânza goală rămâne, dar solicitările reușesc acum, verificați jurnalele serverului pentru erori de conversie a documentelor sau erori specifice fișierelor și comparați un alt fișier cu același format. Dacă problema a început imediat după o actualizare Collabora, a browserului sau a proxy-ului, testați o revenire controlată sau o modificare a proxy-ului specifică versiunii într-o fereastră de întreținere, în loc să modificați mai multe variabile simultan. Golirea memoriei cache a browserului este utilă numai atunci când dovezile indică active client învechite; nu poate repara rutele blocate sau solicitările WOPI respinse.
Urmăriți o deconectare CODE de 10 minute la proxy-ul, echilibratorul de încărcare sau calea WebSocket, apoi corectați timeout-ul și verificați dacă sesiunea rămâne conectată.
Instalați diagrama oficială Collabora Helm, configurați accesul WOPI și afinitatea de intrare și verificați implementarea fără greșeli comune de configurare.
Folosește cererile browserului, jurnalele WOPI și verificări proxy direcționate pentru a afla de ce Collabora deschide un document gol și alege o soluție care corespunde dovezilor.
Configurați dicționarele CODE Docker și etichetați corect pasajele din documente, astfel încât engleza, franceza și alte limbi acceptate să beneficieze de verificarea ortografică corectă.
Ajustați pragul de inactivitate per vizualizare în coolwsd și distingeți-l de estomparea în fundal a filelor, descărcarea documentelor, salvarea automată și expirarea autentificării.
Opriți verificările programate ale actualizărilor CODE, revizuiți serviciile opționale la distanță și utilizați controalele de rețea de ieșire fără a întrerupe editarea documentelor.
Activați editarea securizată a documentelor în Seafile configurând URL-ul de descoperire, HTTPS și accesul WOPI din Collabora pentru implementarea dvs.
Testați clipboard-ul sistemului, ajustați permisiunile browserului și identificați când o integrare Collabora încorporată necesită o modificare a politicii iframe.
Montați fișierele de fonturi în placa de sistem Docker și Collabora, astfel încât fonturile personalizate să apară în editor și să fie redate corect în documente.
Faceți o copie de rezervă a fișierului coolwsd.xml și a surselor sale de implementare, restaurați-le în siguranță și verificați CODUL înainte ca utilizatorii să revină la editare.
