Remediați eroarea „Gazdă WOPI neautorizată” în CODE-ul Collabora Online

Cea mai rapidă și fiabilă soluție este să faceți ca Collabora Online CODE să aibă încredere în numele de gazdă și portul exact care apar în URL-ul sursă WOPI trimis de platforma dvs. de stocare. Pentru un singur server Nextcloud, setați lista de permisiuni pentru gazdele CODE la acel nume de gazdă Nextcloud, recreați containerul și testați din nou. Dacă operați mai multe instanțe Nextcloud, permiteți-le explicit pe fiecare. Nu rezolvați eroarea deschizând accesul WOPI la fiecare gazdă.

„Gazdă WOPI neautorizată” înseamnă de obicei că Collabora a respins gazda de stocare menționată în solicitarea WOPI. Nu dovedește, în sine, că parola utilizatorului, permisiunile pentru documente, certificatul TLS sau proxy-ul invers sunt greșite. Aceste componente pot cauza alte erori de conectare, așadar utilizați jurnalele Collabora pentru a confirma cauza specifică înainte de a modifica setările.

Alegeți modificarea care corespunde implementării dvs.

Exemplele de mai jos presupun că Nextcloud se află la https://cloud.example.comși Collabora la https://office.example.com. Înlocuiți ambele nume și portul cu valorile utilizate în instalarea dvs. Ghidul de configurare Docker al Nextcloud utilizează aliasgroup1pentru o singură gazdă de stocare și descrie adăugarea unui alt grup de aliasuri pentru o a doua gazdă Nextcloud. Configurația WOPI a Collabora definește potrivirea gazdelor în jurul numelui de gazdă și portului; aliasurile sunt pentru nume alternative ale aceleiași gazde de stocare.

1. Confirmați ce gazdă a fost respinsă de Collabora

Începeți cu jurnalele containerului CODE. Pe o implementare Docker Compose, executați:

docker compose logs --since=10m collabora

Înlocuiți collaboracu numele serviciului din fișierul Compose. Cu Docker simplu, utilizați docker logs --since 10m CONTAINER_NAME. Căutați lângă încercarea eșuată de deschidere a documentului un mesaj precum No acceptable WOPI hosts found matching the target host [cloud.example.com] in config. Numele de gazdă între paranteze este indiciul: adăugați gazda de stocare afișată acolo, nu numele de gazdă public al serverului Collabora.

De asemenea, înregistrați gazda și portul în URL-ul WOPI, dacă sunt afișate în jurnal. Comparați-le cu intrarea configurată. O solicitare către s- cloud.example.com:443ar putea să nu corespundă unei intrări pentru un nume de container intern, cum ar fi nextcloud, chiar dacă ambele nume ajung la aceeași mașină. Proxy-urile inverse, DNS-ul cu orizont divizat și adresele URL publice multiple pot face ca această nepotrivire să fie ușor de trecut cu vederea.

Dacă jurnalele afișează o altă eroare, cum ar fi o eroare de căutare DNS, o conexiune refuzată sau o eroare de certificat, remediați problema respectivă în loc să extindeți lista de gazde WOPI.

2. Actualizați setarea gazdei WOPI de încredere a CODE

Pentru o instalare Docker Compose care deservește o singură gazdă Nextcloud, partea relevantă a serviciului poate arăta astfel:

services:
  collabora:
    image: collabora/code
    environment:
      - aliasgroup1=https://cloud.example.com:443

Păstrați restul opțiunilor de serviciu existente, secretele, volumele, porturile și setările de proxy invers. Exemplul prezintă doar intrarea din lista de permise; nu este un fișier Compose complet pentru producție. Utilizați stilul de setări deja acceptat de versiunea CODE pe care o executați și verificați configurația redată sau de pornire după modificarea acesteia. Imaginile containerelor și interfețele de configurare se pot modifica în timp.

Pentru o singură gazdă, o intrare exactă a gazdei este mai ușor de auditat decât o expresie regulată largă. Dacă instalarea se bazează domainîn schimb pe variabila de mediu, verificați regulile de escape documentate pentru imaginea dvs. și asigurați-vă că expresia se potrivește doar cu numele de gazdă de stocare dorit. Nu copiați un wildcard fără escape sau un model de domeniu părinte care s-ar potrivi cu subdomenii fără legătură.

Pentru mai multe instanțe Nextcloud, adăugați un grup explicit separat pentru fiecare gazdă independentă utilizând mecanismul acceptat de versiunea dvs. de CODE. De exemplu, ghidul de integrare Docker de la Nextcloud arată o aliasgroup2intrare suplimentară pentru un al doilea nume de gazdă în cloud. Adăugați aliasuri numai atunci când un server Nextcloud este accesat cu adevărat sub mai multe nume, cum ar fi un nume intern și un nume public. Păstrați o listă scrisă a acestor nume, astfel încât un nume de gazdă vechi să poată fi eliminat după o migrare.

3. Recreați containerul și verificați lista separată de permisiuni a Nextcloud

După editarea fișierului Compose, recreați serviciul astfel încât noul mediu să fie aplicat:

docker compose up -d --force-recreate collabora

Folosește numele corect al serviciului. Apoi verifică dacă containerul pornește corect și dacă gazda așteptată apare în configurația sau jurnalele sale de pornire. Evită să inserezi dump-uri complete ale mediului în solicitările de asistență: acestea pot expune parole sau alte secrete.

Nextcloud are o setare separată numită „Listă de permisiuni pentru solicitări WOPI” în setările de administrare Office. Această listă restricționează adresele IP care pot trimite solicitări WOPI către Nextcloud; Collabora recomandă limitarea acesteia la adresele de server Collabora așteptate. Dacă Nextcloud raportează acest avertisment, adăugați adresa pe care Nextcloud o vede efectiv pentru solicitare, care poate diferi atunci când este implicată o rețea proxy sau de containere. Păstrați această verificare separată de intrarea gazdă CODE: CODE are încredere în numele gazdelor de stocare, în timp ce lista de permisiuni a Nextcloud se referă la adresa IP a serverului solicitant.

Dacă utilizați un proxy invers, confirmați că numele de gazdă pe care Nextcloud îl publică în linkurile WOPI este același nume de gazdă pentru care CODE este configurat să aibă încredere. Verificați adresa URL a serverului Nextcloud Office și configurația gazdei publice a proxy-ului invers. Nu adăugați numele de gazdă Office la lista de permisiuni pentru stocarea WOPI decât dacă este de fapt gazda de stocare din adresa URL WOPI.

4. Verificați conexiunea completă

Mai întâi, verificați punctele finale ale serviciului Collabora dintr-un browser și de pe serverul Nextcloud. Înlocuiți numele de gazdă exemplu cu adresa URL Office:

curl -fsS https://office.example.com/hosting/capabilities
curl -fsS https://office.example.com/hosting/discovery

Aceste verificări stabilesc dacă endpoint-urile răspund; nu dovedesc că o solicitare de document WOPI va fi autorizată. Apoi, verificați dacă CODE poate ajunge la Nextcloud folosind aceeași gazdă pe care Nextcloud o publică, de exemplu:

curl -fsS https://cloud.example.com/status.php

În final, deschideți un document de test și urmăriți simultan jurnalele CODE și Nextcloud. Un rezultat pozitiv este că editorul se încarcă, mesajul specific „Fără gazde WOPI acceptabile” dispare și salvarea unei mici modificări funcționează. Testați dintr-un cont de utilizator normal cu aceleași permisiuni de partajare și editare ca și utilizatorul afectat.

Cum se compară principalele opțiuni

O gazdă exactă versus o expresie regulată

Un nume de gazdă exact cu portul dorit este de obicei cea mai potrivită opțiune pentru o implementare într-un singur cloud: este ușor de revizuit și limitează potrivirile accidentale. O expresie regulată poate fi utilă atunci când un set de nume de gazdă gestionate în mod deliberat partajează un model, dar este mai greu de auditat și poate autoriza subdomenii neintenționate dacă sunt scrise prea larg. Folosește cea mai restrânsă expresie care satisface o nevoie verificată.

O instanță de COD versus instanțe separate

Un serviciu CODE partajat reduce numărul de servicii de întreținut, iar grupurile explicite pot suporta mai multe instanțe Nextcloud. Instanțele CODE separate pot fi utile atunci când echipele au nevoie de o izolare mai puternică a configurației sau de ferestre de întreținere independente. Compromisul este o infrastructură mai mare de aplicat patch-uri, monitorizat și direcționat. Niciuna dintre opțiuni nu remediază automat un nume de gazdă WOPI nepotrivit; fiecare instanță trebuie să aibă încredere în gazda de stocare corectă.

Setările mediului containerului versus editarea XML-ului

Pentru o implementare Docker CODE, utilizați interfața de configurare acceptată de imagine și păstrați-o în Compose sau într-o altă sursă de implementare. Acest lucru face ca modificările să fie repetabile atunci când containerul este recreat. Editarea coolwsd.xmldirectă poate fi utilă pentru un pachet gestionat sau o implementare personalizată deliberată, dar editarea unui fișier generat în interiorul unui container care rulează este fragilă și poate dispărea la înlocuire sau actualizare. Urmați instrucțiunile pentru pachetul exact, diagrama Helm sau imaginea pe care o utilizați.

Greșeli frecvente de evitat

• Permiterea office.example.commomentului în care gazda de stocare WOPI respinsă este cloud.example.com.
• Introducerea unui nume de container privat atunci când adresa URL WOPI conține un nume DNS public sau invers.
• Presupunând că o listă de adrese IP WOPI Nextcloud goală și configurația gazdei CODE reprezintă același control.
• Adăugarea unui wildcard larg sau dezactivarea validării gazdei doar pentru a face ca editorul să se încarce.
• Schimbarea simultană a regulilor proxy, TLS și WOPI, ceea ce face ca rezultatul să fie mai dificil de diagnosticat.
• Testarea doar a punctului final de descoperire și tratarea acestuia ca dovadă că autorizarea documentelor funcționează.

Când să folosești o altă soluție

Dacă gazda respinsă se schimbă între solicitări, verificați adresa URL canonică Nextcloud, anteturile proxy de încredere și orice rădăcini web alternative înainte de a adăuga mai multe nume. Dacă toate numele de gazdă se potrivesc, dar eroarea persistă, comparați configurația CODE activă cu fișierul sau setările de mediu pe care le-ați editat și confirmați că containerul a fost recreat. Pentru Kubernetes sau Helm, editați valorile diagramei sau sursa configurației gestionate în loc de un pod live. Dacă jurnalele arată în schimb erori de certificat, firewall, WebSocket sau DNS, depanați acel strat utilizând jurnalele de server și verificările de rețea corespunzătoare.

Acești pași respectă Manualul de administrare Nextcloud 35 disponibil pe 6 octombrie 2026 și schema de configurare WOPI publicată de Collabora. Cheile de configurare specifice pot varia în funcție de metoda de implementare și versiunea imaginii, așadar verificați-le în raport cu documentația pentru versiunea instalată înainte de a aplica o modificare.

Referințe oficiale

• Depanare Nextcloud Office și verificări ale conectivității
• Exemplul Docker din Nextcloud pentru Collabora, inclusiv setările gazdei WOPI
• Configurarea Nextcloud Office și îndrumări pentru lista de IP-uri permise WOPI
• Schema de configurare coolwsd.xml publicată de Collabora Online
• Documentația setărilor proxy Collabora Online