Cum să conectați Collabora Online la Seafile: Opțiuni și pași de configurare

Seafile poate deschide fișiere Office acceptate în Collabora Online prin WOPI, un protocol care permite serverului de stocare și editorului online să facă schimb de informații despre documente și conținutul fișierelor. Implementarea corectă depinde de locul în care rulați Seafile, de modul în care gestionați HTTPS și proxy-urile inverse și dacă doriți ca Collabora să fie pe aceeași rețea Docker sau pe un server separat.

Acest ghid respectă instrucțiunile de integrare Collabora din Manualul de administrare Seafile actual (documentația Seafile 14.0, verificată la 6 octombrie 2026). Fișierele și etichetele de imagine Docker Compose exacte se pot schimba, așadar folosiți fișierele pentru versiunea Seafile instalată, în loc să copiați configurația completă Compose a unui tutorial mai vechi.

Ce implementare ar trebui să alegeți?

Pentru o nouă implementare Docker cu un singur nod, începeți cu fișierul furnizat de Seafile collabora.yml. Pentru un server Collabora independent existent sau un cluster, utilizați ghidul de instalare propriu Collabora și setați adresa URL de descoperire Seafile la adresa externă Collabora. Ghidul de integrare Seafile necesită HTTPS pentru Seafile și menționează că un nod Collabora separat ar trebui să utilizeze HTTPS pe portul standard 443, prin proxy invers către serviciul Collabora pe portul 9980. Consultați ghidul de integrare online Seafile Collabora și documentația de instalare Collabora .

Înainte de a începe

• Confirmați că serverul Seafile este accesibil prin HTTPS cu un certificat valid. Ghidul Seafile necesită în mod explicit HTTPS pentru această integrare.
• Identificați tipul de implementare: Docker curent cu un singur nod, instalare binară sau o configurație multi-host/cluster. Numele fișierelor Composite și rutarea proxy depind de această alegere.
• Alegeți un nume de gazdă Collabora, cum ar fi office.example.com, dacă Collabora va fi accesat independent de browserele utilizatorilor. Asigurați-vă că certificatul DNS și TLS funcționează înainte de a configura Seafile.
• Aveți acces de administrator la fișierele Seafile seahub_settings.pyși Docker .env, dacă este cazul. Stocați parola de administrator Collabora într-un fișier de mediu protejat și nu o publicați în capturi de ecran, jurnale sau într-un depozit public.

Documentația Seafile descrie pașii Docker pentru aceeași gazdă pentru layout-ul Compose acceptat. Dacă proxy-ul invers, proiectul Compose sau rețeaua diferă, tratați valorile exemplu de mai jos ca punct de plecare și verificați numele serviciilor și rutele în propria implementare.

Opțiunea A: Adăugați Collabora la o implementare Seafile Docker

1. Adăugați fișierul oficial Collabora Compose

Din directorul în care se află configurația Seafile Compose, descărcați fișierul Collabora pentru versiunea Seafile pe care o executați. Pentru calea Seafile 14.0 a manualului curent:

wget https://manual.seafile.com/14.0/repo/docker/collabora.yml

Deschideți .envși adăugați collabora.ymlla COMPOSE_FILElista existentă. Păstrați toate intrările curente; de ​​exemplu, o instalare care listează deja serverul Seafile, fișierele Caddy și SeaDoc ar adăuga fișierul Collabora în loc să înlocuiască lista:

COMPOSE_FILE='seafile-server.yml,caddy.yml,seadoc.yml,collabora.yml'

Lista reală poate fi diferită. Nu eliminați proxy-ul invers curent sau alte servicii doar pentru a se potrivi cu acest exemplu. Fișierul Compose stabilește setările de container și rețea așteptate de implementarea inclusă în pachetul Seafile.

2. Setați valorile de mediu ale Collabora

Adăugați variabilele documentate de Seafile în același .envfișier. Exemplul său actual folosește collabora/codenumele imaginii continue; echipele care necesită actualizări reproductibile ar trebui să selecteze o etichetă de lansare Collabora acceptată de mediul lor și să o fixeze în mod deliberat. Consultați notele de lansare și testați actualizările înainte de a modifica un serviciu de editare funcțional.

COLLABORA_IMAGE=collabora/code
COLLABORA_PORT=6232
COLLABORA_USERNAME=admin
COLLABORA_PASSWORD=replace-with-a-long-random-secret
COLLABORA_ENABLE_ADMIN_CONSOLE=true
COLLABORA_REMOTE_FONT=
COLLABORA_ENABLE_FILE_LOGGING=false

Valoarea portului este portul orientat spre gazdă utilizat de exemplul Compose al Seafile; Collabora ascultă pe portul 9980 din interiorul containerului. Păstrați consola de administrare privată sau restricționați accesul la proxy/firewall. Numele de utilizator și parola de mai sus sunt exemple - alegeți acreditări unice și protejați fișierul. Dacă organizația dvs. nu are nevoie de consola de administrare, urmați setările acceptate ale șablonului Compose pentru a o dezactiva.

3. Configurați conexiunea WOPI a Seafile

Editați seahub_settings.pyși adăugați setările de integrare Collabora. Pentru containerele din aceeași rețea Compose, exemplul curent al Seafile folosește numele serviciului 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_PREVIEW_MAX_SIZE = 30 * 1024 * 1024
ENABLE_OFFICE_WEB_APP_EDIT = True

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

URL-ul intern de descoperire este pentru comunicarea Seafile-Collabora în rețeaua Docker partajată. Browserele utilizatorilor trebuie să poată accesa și adresa Collabora pe care le-o furnizează integrarea. Urmați configurarea oficială a fișierului Compose și a proxy-ului, astfel încât ruta orientată spre browser să fie publicată în siguranță; un nume de gazdă exclusiv pentru container care se rezolvă doar în Docker nu este un URL public de browser utilizabil.

Păstrați listele de extensii de fișiere limitate la formatele de care au nevoie utilizatorii dvs. și pe care le acceptă versiunea Collabora. Setarea dimensiunii de previzualizare afișată mai sus este valoarea de 30 MiB din exemplul actual al Seafile; documentele mai mari pot necesita o modificare deliberată a limitei, luând în considerare impactul corespunzător asupra memoriei și performanței.

4. Porniți sau actualizați serviciile

Validați configurația Compose, apoi porniți stiva din directorul proiectului său:

docker compose config
docker compose up -d

Ghidul Seafile spune să reporniți Seafile după modificarea seahub_settings.py. În cazul implementărilor Docker, docker compose up -dse aplică configurația Compose actualizată; dacă editarea setărilor nu are efect, reporniți serviciul Seafile folosind metoda corespunzătoare versiunii dvs. Evitați o modificare broad, docker compose downcu excepția cazului în care intenționați să opriți întreaga stivă.

Opțiunea B: Indicați Seafile către Collabora pe o altă gazdă

Instalați și expuneți Collabora folosind instrucțiunile oficiale de implementare și reverse-proxy. Folosiți HTTPS pe endpoint-ul public normal și solicitările proxy către portul intern 9980 al Collabora. Confirmați că gazda Seafile poate ajunge la Collabora și că Collabora poate ajunge la adresa HTTPS a Seafile; ambele direcții sunt importante pentru încărcarea documentelor WOPI.

Păstrați celelalte setări Seafile din secțiunea anterioară, dar schimbați setarea de descoperire la numele de gazdă Collabora real:

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

Folosește numele de gazdă și certificatul tău real. Nu include numele serviciului intern Docker, cu excepția cazului în care Seafile și Collabora partajează într-adevăr o rețea în care se rezolvă acel nume. O gazdă separată îți oferă control independent asupra resurselor și întreținerii, dar adaugă DNS, firewall, certificat și funcție de reverse-proxy. Pentru un cluster Seafile, urmează designul proxy și service-discovery al clusterului, în loc să presupui că se aplică rețeaua Compose cu un singur nod.

Cum să confirmi că conexiunea funcționează

1. Deschideți https://office.example.com/hosting/discoverydintr-un browser dacă utilizați o gazdă separată. Pentru o configurație cu aceeași gazdă, testați ruta publică Collabora publicată de proxy-ul dvs. Un răspuns reușit confirmă că punctul final de descoperire este accesibil, deși nu dovedește în sine că editarea WOPI funcționează.
2. Conectați-vă la Seafile și deschideți un fișier mic, nesensibil .docx, .xlsx, sau .odtinclus în listele de extensii configurate.
3. Confirmați că fișierul se deschide în Collabora, faceți o modificare inofensivă, așteptați finalizarea salvării și închideți editorul.
4. Redeschideți fișierul în Seafile și verificați dacă modificarea a persistat. Pentru o verificare mai puternică, descărcați o copie și confirmați conținutul așteptat.

Testează cu un fișier pe care îl poți modifica în siguranță. Un editor vizibil fără o salvare reușită este doar un succes parțial: WOPI trebuie să poată recupera fișierul și să returneze versiunea editată către Seafile.

Defecțiuni frecvente și ce parte să verificați

Pentru jurnalele Docker, documentele Seafile docker logs seafile-collabora. Verificați jurnalele Seafile/Seahub alături de ieșirea Collabora și corelați cererile la proxy. Nu activați înregistrarea detaliată sau a fișierelor la nesfârșit dacă expune adresele URL ale documentelor sau alte detalii operaționale sensibile. Ghidul oficial de depanare Collabora oferă verificări suplimentare pentru erorile de pe partea Collabora.

Care alegere are sens?

Alegeți containerul inclus atunci când instalarea Seafile este o singură gazdă Docker, doriți cablajul Compose acceptat și partajarea CPU și a memoriei cu Seafile este acceptabilă. Alegeți o gazdă Collabora separată atunci când operați deja una, aveți nevoie de capacitate independentă sau de programe de upgrade sau integrați o arhitectură multi-gazdă și puteți menține rutarea HTTPS și a rețelei în mod fiabil. În ambele cazuri, urmați documentația corespunzătoare versiunii Seafile, mențineți punctele finale orientate spre browser în siguranță și verificați atât deschiderea, cât și salvarea documentelor înainte de a invita utilizatorii să se bazeze pe editarea online.