Conectați Seafile și Collabora cu URL-ul WOPI corect

Pentru a conecta Seafile cu Collabora Online, activați HTTPS pe Seafile, implementați Collabora și direcționați integrarea Office a Seafile către endpoint-ul de descoperire al Collabora. Dacă ambele servicii rulează pe aceeași rețea Docker, ghidul de integrare actual al Seafile utilizează adresa URL internă http://collabora:9980/hosting/discovery; dacă Collabora rulează pe o gazdă separată, utilizați în schimb adresa URL HTTPS publică.

Manualul actual de administrare Seafile documentează o collabora.ymlintegrare și setări Compose dedicate în seahub_settings.py. Fișierele exacte de implementare pot diferi în funcție de versiunea Seafile, așadar folosiți manualul corespunzător versiunii instalate atunci când adaptați aceste exemple.

Înainte de a începe

• Folosește o adresă Seafile HTTPS cu un certificat TLS valid. Seafile listează HTTPS ca o cerință pentru integrarea Collabora.
• Știți dacă Collabora va rula ca un alt container pe aceeași gazdă Docker sau ca un serviciu găzduit separat.
• Să aveți acces de administrator la directorul de implementare al Seafile și la seahub_settings.py.
• Alegeți formatele de documente pentru previzualizare și editare. Setările Seafile controlează aceste liste de extensii.

Seafile și Collabora comunică folosind WOPI. Seafile furnizează informații de acces la documente, iar Collabora solicită fișierul de la Seafile. URL-ul de descoperire îi spune lui Seafile ce serviciu Collabora să utilizeze și ce capacități de editor promovează.

1. Confirmați HTTPS pe Seafile

Deschideți Seafile într-un browser și confirmați că adresa sa normală începe cu https://și că certificatul său este valid. Pentru implementarea Docker a Seafile, manualul său actual afișează setarea SEAFILE_SERVER_PROTOCOL=httpsîn .envfișier, apoi finalizarea configurării HTTPS prin proxy-ul invers configurat. Nu continuați cu un endpoint Seafile public simplu-HTTP.

# In the Seafile deployment .env file
SEAFILE_SERVER_PROTOCOL=https

Păstrați certificatul și cheia privată sub controlul proxy-ului TLS sau al managerului de certificate. Această setare nu emite un certificat și nu configurează un proxy invers; finalizați pașii HTTPS pentru implementare înainte de a activa editarea online Office.

2. Adăugați Collabora la implementarea Seafile Docker

Pentru configurarea documentată a Docker pe aceeași gazdă, utilizați fișierul Collabora Compose furnizat de Seafile în loc să asamblați o definiție de container fără legătură. În directorul de implementare Seafile, descărcați fișierul pentru versiunea manuală corespunzătoare și adăugați-l collabora.ymlla COMPOSE_FILElista existentă din .env. Păstrați fișierele Compose deja utilizate de instalarea dvs.

# Example for a Seafile 14.0 deployment
wget https://manual.seafile.com/14.0/repo/docker/collabora.yml

Setați variabilele Collabora documentate de Seafile în .env:

COLLABORA_IMAGE=collabora/code
COLLABORA_PORT=6232
COLLABORA_USERNAME=your_admin_username
COLLABORA_PASSWORD=use_a_long_unique_secret
COLLABORA_ENABLE_ADMIN_CONSOLE=true
COLLABORA_ENABLE_FILE_LOGGING=false

Folosește o parolă puternică și unică și restricționează accesul la .envfișier, deoarece acesta conține acreditări. Portul exemplu este portul expus în configurația de integrare Seafile; nu presupune că este portul public de pe proxy-ul invers. Urmează collabora.ymlfișierul corespunzător și aranjamentul proxy pentru versiunea ta.

După ce serviciul este adăugat la implementare, porniți sau actualizați stiva Compose folosind procedura Seafile obișnuită. Evitați publicarea portului intern al Collabora direct pe internet, cu excepția cazului în care designul dvs. îl impune în mod explicit și ați securizat endpoint-ul.

3. Îndreptați Seafile către URL-ul de descoperire al Collabora

Editați fișierul activ seahub_settings.pyși adăugați setările de integrare. Pentru configurarea Compose pe aceeași gazdă, manualul Seafile utilizează numele serviciului și portul intern Collabora:

OFFICE_SERVER_TYPE = 'CollaboraOffice'
ENABLE_OFFICE_WEB_APP = True
OFFICE_WEB_APP_BASE_URL = 'http://collabora:9980/hosting/discovery'
WOPI_ACCESS_TOKEN_EXPIRATION = 30 * 60

OFFICE_WEB_APP_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)

ENABLE_OFFICE_WEB_APP_EDIT = True
OFFICE_WEB_APP_EDIT_FILE_EXTENSION = (
    'odp', 'ods', 'odt', 'xls', 'xlsb', 'xlsm', 'xlsx',
    'ppsx', 'ppt', 'pptm', 'pptx', 'doc', 'docm', 'docx'
)

URL http://-ul de aici este adresa internă serviciu-la-serviciu din rețeaua Docker documentată a Seafile. Site-ul Seafile orientat spre browser necesită în continuare HTTPS. Nu copiați această adresă internă într-o implementare cu gazdă separată.

Pentru Collabora pe o altă gazdă, configurați Collabora în spatele HTTPS pe portul public standard, cu proxy-ul invers redirecționând cererile către portul de ascultare al Collabora. Setați adresa URL de bază la numele dvs. public real de gazdă, de exemplu:

OFFICE_WEB_APP_BASE_URL = 'https://office.example.com/hosting/discovery'

Asigurați-vă că numele de gazdă din URL se rezolvă și prezintă un certificat valid de la clienții care trebuie să deschidă documente. De asemenea, configurați lista de acces permise WOPI a Collabora pentru a accepta gazda serverului Seafile. Documentația oficială Docker a Collabora descrie aliasgroupvariabila de mediu pentru declararea gazdei WOPI permise; potriviți exact gazda și schema utilizate de Seafile și evitați accesul wildcard larg pe un server de producție.

4. Reporniți și testați conexiunea

Reporniți Seafile astfel încât Seahub să încarce noile setări Python. Folosiți procedura de repornire pentru pachetul, stiva Compose sau configurarea Kubernetes; numele serviciilor și comenzile variază în funcție de implementări. Dacă ați adăugat un nou fișier Compose, confirmați că rulează containerul Collabora înainte de a testa fluxul de lucru al browserului.

Deschideți un document Office acceptat din interfața web Seafile. Fișierul ar trebui să se deschidă în editorul Collabora, să afișeze conținutul său și să salveze o mică modificare de test înapoi în Seafile. Deschiderea cu succes a unui document este mai utilă decât verificarea exclusivă a paginii de descoperire, deoarece aceasta exercită transferul de fișiere din browser, Seafile, Collabora și WOPI.

Depanarea prin verificarea fiecărei conexiuni

• Seahub raportează o eroare de descoperire: Confirmă OFFICE_WEB_APP_BASE_URLcă este accesibil din serviciul Seafile. Folosește numele intern al serviciului Docker numai atunci când ambele containere partajează acea rețea.
• Editorul încarcă, dar nu poate prelua fișierul: Verificați jurnalele Collabora și jurnalele Seafile. Confirmați că Collabora permite gazda WOPI Seafile și că certificatul HTTPS al Seafile este de încredere.
• Funcționează pe aceeași gazdă, dar nu de la distanță: Înlocuiți adresa URL internă cu adresa URL publică de descoperire HTTPS, confirmați DNS și TLS și verificați dacă proxy-ul redirecționează cererile Collabora către portul 9980.
• Se deschid doar anumite formate: Revizuire OFFICE_WEB_APP_FILE_EXTENSIONși OFFICE_WEB_APP_EDIT_FILE_EXTENSION. Păstrați aceste liste limitate la formatele de care au nevoie utilizatorii dvs. și pe care le acceptă implementarea Collabora.
• Setările apar neschimbate după repornire: Confirmați că ați editat serviciul Seafile activ seahub_settings.pyși ați repornit serviciul Seafile corect.

Pentru un nod Collabora independent, Seafile direcționează în mod specific administratorii către documentația de implementare Collabora în loc să utilizeze fișierul inclus collabora.yml. Fișierul inclus este destinat aceluiași aranjament de gazdă/rețea Docker descris mai sus.

Referințe oficiale

• Manual de administrare Seafile: Integrare Collabora Online
• Fișier Seafile 14.0 Collabora Compose
• Documentația imaginilor Docker din CODE-ul Collabora