Rulați LibreOffice Headless în Docker pentru conversia PDF

Da. Pentru conversii unice de documente, construiți o mică imagine Docker cu LibreOffice instalat și rulați soffice --headlesscu --convert-to. Montați directorul de intrare ca acces doar pentru citire și un director de ieșire separat cu acces de scriere, astfel încât PDF-ul să apară pe gazdă. Acest exemplu folosește o imagine bazată pe Debian și convertește un fișier DOCX în PDF; nu expune LibreOffice ca serviciu de rețea.

Ce face modul headless și când este util Docker?

Modul Headless pornește LibreOffice fără interfața sa grafică. LibreOffice documentează acest mod pentru utilizare din linia de comandă și controlată prin API, iar opțiunile sale din linia de comandă acceptă conversia fișierelor cu un director de ieșire. Docker împachetează aplicația și dependențele sale astfel încât un script sau o stație de lucru să poată rula aceeași imagine a containerului fără a instala suita desktop pe gazdă.

Acest model funcționează bine pentru joburi batch locale, task-uri CI sau un worker backend care primește un fișier și salvează un rezultat convertit. Un container headless simplu nu este, în sine, un API de conversie HTTP: nu ascultă pe niciun port și nu acceptă încărcări web. Dacă aveți nevoie de un serviciu persistent, instalați un API și o coadă de joburi în jurul procesului de conversie și adăugați validarea cererilor, timeout-uri, limite de dimensiune a fișierelor și izolare.

1. Creați folderele de intrare și ieșire

Pe o gazdă Linux sau macOS folosind Bash sau un shell similar, creați un folder de proiect cu directoare separate. Puneți documentul sursă acolo inputși lăsați-l outputgol pentru prima rulare:

mkdir -p lo-work/input lo-work/output
cp report.docx lo-work/input/
cd lo-work

Comenzile Docker de mai jos utilizează căi și sintaxă shell în stil Unix. Pe Windows, ajustați sintaxa căii gazdă pentru PowerShell sau Command Prompt și asigurați-vă că Docker Desktop are permisiunea de a partaja unitatea care conține aceste foldere.

2. Construiește o imagine cu LibreOffice

Creați un fișier numit Dockerfileîn interior lo-workcu acest conținut:

FROM debian:bookworm-slim

RUN apt-get update && apt-get install -y --no-install-recommends \
    libreoffice-writer fonts-liberation \
    && rm -rf /var/lib/apt/lists/*

ENTRYPOINT ["soffice"]

libreoffice-writerfurnizează Writer și filtrele de conversie necesare pentru formatele comune de procesare a textului. Adăugați libreoffice-calcsau libreoffice-impressdacă containerul trebuie să convertească foi de calcul sau prezentări. Pachetul de fonturi este doar o bază; instalați fonturile necesare documentelor dvs. și aveți drepturi de utilizare, deoarece fonturile lipsă pot modifica încadrarea pe rând și sfârșiturile de pagină.

Construiți imaginea din directorul care conține Dockerfile-ul:

docker build -t lo-headless .

Exemplul folosește nume de pachete Debian Bookworm. Etichetele imaginii de bază și pachetele repozitoriului se schimbă în timp; pentru o compilare de producție, alegeți o bază întreținută, reconstruiți-o periodic pentru actualizări de securitate și fixați imaginea de bază prin digest dacă aveți nevoie de compilații reproductibile. Evitați instalarea de pachete dintr-un repozitoriu fără legătură doar pentru a se potrivi cu un tutorial.

3. Rulați LibreOffice cu monturi separate

Porniți un container de unică folosință și transmiteți opțiunile de conversie după numele imaginii. Montarea de intrare este doar pentru citire; doar directorul de ieșire este permisă scrierea. Opțiunea --userrulează procesul cu ID-urile de utilizator și grup gazdă pe Linux, în timp ce HOME=/tmpoferă LibreOffice un spațiu de acces cu drept de scriere. Ajustați permisiunile folderului dacă utilizatorul gazdă nu poate scrie în output.

docker run --rm \
  --user "$(id -u):$(id -g)" \
  --env HOME=/tmp \
  -v "$PWD/input:/input:ro" \
  -v "$PWD/output:/output" \
  lo-headless \
  --headless --nologo \
  -env:UserInstallation=file:///tmp/lo-profile \
  --convert-to pdf:writer_pdf_Export \
  --outdir /output \
  /input/report.docx

--headlesssuprimă interfața grafică, --convert-to pdf:writer_pdf_Exportselectează filtrul de export PDF și --outdirdirecționează rezultatul către folderul de ieșire montat. Calea unică de profil de utilizator oferă acestui proces un director de configurare LibreOffice în care se poate scrie; dacă rulați mai multe conversii simultan într-un container cu durată lungă de viață, utilizați o cale de profil diferită pentru fiecare proces.

Folosește --mountîn loc de -vdacă preferi sintaxa de montare mai explicită a Docker. Montajele bind sunt legate de căi pe gazda daemonului Docker, iar montajele de citire-scriere permit proceselor containerului să modifice fișierele gazdă. Păstrează montajele înguste, evită montarea directorului principal sau a socketului Docker și nu rulează un worker de conversie a documentelor cu privilegii inutile.

4. Confirmați că PDF-ul a fost creat

Verificați directorul de ieșire al gazdei după ce Docker se închide:

ls -l output/
file output/report.pdf
test -s output/report.pdf

Fișierul PDF trebuie să existe și să nu fie gol. Deschideți-l într-un cititor PDF și verificați numărul de pagini, tabelele, imaginile, sfârșiturile de pagină și fonturile înainte de a vă baza pe el. O ieșire reușită a procesului nu dovedește că fiecare element a fost redat conform așteptărilor, mai ales atunci când un document utilizează fonturi sau funcții indisponibile în container. Folosiți un director de ieșire curat sau un nume de fișier de ieșire nou pentru fiecare rulare, astfel încât un PDF mai vechi să nu poată fi confundat cu cea mai recentă conversie.

Ce ar trebui să verific dacă conversia eșuează?

• Niciun fișier de ieșire: confirmați numele fișierului sursă și calea containerului, care inputa fost montat la /inputși că outputdirectorul gazdă poate fi scris de utilizatorul selectat.
• Erori de profil sau de blocare: confirmați că -env:UserInstallationse poate scrie pe cale. Folosiți un director de profil separat pentru fiecare proces LibreOffice simultan.
• Aspect modificat: instalați fonturile necesare în imagine și examinați PDF-ul. Randarea poate diferi față de un sistem desktop din cauza disponibilității fonturilor, a filtrelor de export și a diferențelor de versiune.
• Eroare de montare Docker: verificați existența ambelor directoare gazdă înainte de a utiliza -vsau --mountși verificați dacă daemonul le poate accesa.

Pentru comportamentul exact al opțiunilor, consultați referința parametrilor din linia de comandă a LibreOffice . Numele pachetelor pot fi verificate în lista de pachete Debian Bookworm pentru LibreOffice Writer . Documentația oficială a Docker explică montările bind și instrucțiunile Dockerfile .