Urmăriți erorile de conexiune Collabora cu jurnalele coolwsd

Pentru un container Collabora Online Development Edition (CODE), ridicați coolwsdjurnalizarea la debug, asigurați-vă că zonele Socketși WebSocketnu sunt dezactivate, apoi reproduceți un document deschis eșuat, urmărind jurnalele containerului. În Docker Compose, transmiteți setările prin extra_paramsvariabila de mediu a imaginii CODE și recreați serviciul. Utilizați tracenumai dacă ieșirea de depanare nu arată unde se oprește conexiunea și reveniți la nivelul anterior când terminați.

Această metodă se potrivește unei implementări Docker sau Compose unde puteți actualiza configurația containerului. O instalare nativă a unui pachet folosește /etc/coolwsd/coolwsd.xmlîn schimb și managerul său de servicii. Setarea adaugă detalii de diagnosticare; nu repară singură o problemă de proxy, gazdă WOPI, certificat sau rețea.

1. Începeți cu o reproducere controlată

Alegeți un document și notați ora la care încercați să îl deschideți, adresa URL publică Collabora și numele containerului sau al serviciului Compose. Evitați reîmprospătarea repetată a mai multor fișiere: o singură încercare facilitează alinierea simptomului browserului, a jurnalului proxy, a jurnalului serverului de integrare și a intrărilor coolwsd.

Verificați dacă containerul funcționează și identificați numele acestuia:

docker ps --format 'table {.Names}	{.Status}	{.Ports}'

Înlocuiți collaboramai jos cu numele containerului afișat pe gazdă. Începeți să urmați rezultatul cu puțin timp înainte de a reproduce problema:

docker logs --since 2m --follow --timestamps collabora

--followtransmite în flux noile ieșiri, --sincelimitează istoricul inițial și --timestampsadaugă marcaje temporale Docker. Docker documentează aceste opțiuni în referința jurnalelor de container . În Compose, puteți utiliza docker compose logs --since=2m --follow collabora, unde collaboraeste cheia de serviciu.

2. Creează comanda coolwsd pentru depanare pentru test

Schema de configurare Collabora acceptă niveluri denumite, inclusiv warning, notice, information, debug, și trace. De asemenea, definește disabled_areas; valoarea implicită documentată dezactivează ieșirea cu conținut ridicat de detalii de la Socketși WebSocket, printre alte zone. Acest lucru este important pentru depanarea conexiunii: modificarea nivelului în sine poate lăsa în continuare suprimate cele mai utile detalii ale handshake-ului. Aceste opțiuni sunt documentate în șablonul de configurare Collabora coolwsd și în manualul SDK-ului Collabora Online (secțiunea de configurare Docker; verificată în octombrie 2026).

Pentru imaginea oficială collabora/code, adăugați cele două opțiuni la valoarea existentă a serviciului extra_params. Păstrați orice opțiuni deja necesare pentru instalare, cum ar fi terminarea SSL sau numele serverului:

services:
  collabora:
    environment:
      extra_params: "--o:logging.level=debug --o:logging.disabled_areas=Admin,Pixel"

A doua opțiune lasă `` Socketși ` WebSocket` disponibile pentru înregistrarea în jurnal cu detalii detaliate în timp ce `` Adminși ` Pixel` sunt dezactivate. Nu adăugați aceste două zone înapoi în lista de dezactivate în timpul acestui test. Documentația imaginii CODE descrie `` extra_paramsca o modalitate de a transmite opțiuni din linia de comandă către coolwsd. Dacă implementarea dvs. utilizează un fișier de configurare montat sau o imagine gestionată de furnizor, urmați în schimb metoda de configurare a implementării respective.

Aplică editarea Compose prin recrearea serviciului:

docker compose up -d --force-recreate collabora

Folosește numele real al serviciului Compose. Pentru un container cu viață scurtă pornit cu docker run, actualizează configurația sa de rulare și recreează-l cu aceleași volume, rețele, porturi și alte opțiuni. Manualul CODE spune că imaginea acceptă extra_paramsla pornire; nu presupune că schimbarea mediului unui container deja creat modifică procesul coolwsd care rulează.

3. Citiți conexiunea în ordine

Reproduceți eroarea o singură dată și verificați doar acel interval. Căutați în rezultat termeni precum WebSocket, WOPI, ERRși WRN, apoi comparați timestamp-urile. Formularea exactă și zonele de jurnal variază în funcție de versiunea Collabora, așadar tratați-le ca pe niște categorii de inspectat, mai degrabă decât ca pe niște mesaje literale garantate.

• Nu există intrări coolwsd noi în momentul testării: este posibil ca solicitarea să nu ajungă la acest container. Verificați adresa URL publică configurată, DNS-ul, echilibratorul de încărcare, jurnalele de acces/erori reverse-proxy și dacă urmăriți replica corectă.
• Browserul ajunge la serviciu, dar WebSocket-ul nu rămâne deschis: verificați gestionarea de către proxy a actualizării WebSocket, a gazdei și schemei redirecționate, a terminării TLS, a rutarii căii și a timeout-urilor de inactivitate. Comparați cu consola dezvoltatorului browserului și jurnalele proxy; coolwsd nu poate explica o cerere pe care proxy-ul nu o redirecționează niciodată.
• Apare o solicitare WOPI, dar aceasta eșuează: verificați adresa URL WOPI a serverului de integrare, lista de acces permise a gazdei sau configurația aliasului, accesibilitatea din containerul Collabora și răspunsul serverului de integrare. O eroare WOPI este o etapă separată de conexiunea browser-Collabora WebSocket.
• WOPI reușește, dar browserul se deconectează în continuare: concentrați-vă în continuare pe ruta WebSocket și pe erorile de conexiune din partea browserului. Această secvență restrânge căutarea; nu dovedește care setare de proxy sau de rețea este greșită.

Dacă Docker nu afișează nicio ieșire chiar dacă serviciul este activ, verificați configurația de înregistrare în jurnal din interiorul containerului. Comanda log a Docker citește ieșirea standard și fluxurile de erori ale containerului; o instalare configurată să scrie într-un fișier poate utiliza în schimb o cale precum /var/log/coolwsd.log, așa cum este definită de configurația sa. Inspectați fișierul propriu-zis în loc să presupuneți acea cale:

docker exec collabora sh -c 'grep -n -A25 "<logging>" /etc/coolwsd/coolwsd.xml'

Dacă este activată înregistrarea în jurnal a fișierelor, utilizați calea configurată, de exemplu:

docker exec collabora sh -c 'tail -n 200 /var/log/coolwsd.log'

4. Verificați rezultatul și restabiliți înregistrarea normală în jurnal

După test, rulați o citire limitată pentru a confirma că încercarea intenționată a produs intrări noi:

docker logs --since 5m --timestamps collabora

Ai un rezultat util atunci când poți alinia deschiderea eșuată cu un eveniment coolwsd sau să stabilești că solicitarea nu a ajuns niciodată la acest container, apoi să identifici ce etapă a conexiunii necesită urmărire. Dacă trebuie să filtrezi ieșirea, folosește mai întâi o fereastră de timp scurtă:

docker logs --since 5m collabora | grep -Ei 'coolwsd|WOPI|WebSocket|ERR|WRN'

Restaurați valorile anterioare logging.levelși disabled_areas, apoi recreați din nou serviciul. Nivelurile de depanare și de urmărire pot produce mult mai multe rezultate și pot include detalii operaționale sensibile. Înainte de a partaja jurnalele, redactați token-urile de acces, numele documentelor, identificatorii de utilizatori, numele de gazdă și adresele interne. Dacă serviciul nu este imaginea CODE oficială, confirmați calea de configurare și parametrii acceptați cu administratorul acelei imagini.