Zatrzymaj Element Desktop powodujący awarię na Wayland z Xwayland
Przetestuj Element Desktop za pomocą Xwayland, zachowaj lokalne dane i wyizoluj problemy z grafiką lub pakietami, gdy Linux Wayland spowoduje awarię aplikacji.
Tak. W przypadku jednorazowych konwersji dokumentów, zbuduj mały obraz Dockera z zainstalowanym LibreOffice i uruchom go soffice --headlessza pomocą --convert-to. Zamontuj katalog wejściowy tylko do odczytu i oddzielny katalog wyjściowy z dostępem do zapisu, aby plik PDF pojawił się na hoście. W tym przykładzie użyto obrazu opartego na Debianie i przekonwertowano jeden plik DOCX do PDF; nie udostępnia on LibreOffice jako usługi sieciowej.

Tryb bezgłowy uruchamia LibreOffice bez interfejsu graficznego. LibreOffice dokumentuje ten tryb do użytku z poziomu wiersza poleceń i kontrolowanego przez API, a jego opcje wiersza poleceń obsługują konwersję plików z katalogiem wyjściowym. Docker pakuje aplikację i jej zależności, dzięki czemu skrypt lub stacja robocza może uruchomić ten sam obraz kontenera bez instalowania pakietu desktopowego na hoście.
Ten wzorzec sprawdza się w przypadku lokalnych zadań wsadowych, zadań CI lub procesu back-end, który odbiera plik i zapisuje przekonwertowany wynik. Zwykły kontener headless sam w sobie nie jest interfejsem API konwersji HTTP: nie nasłuchuje na żadnym porcie i nie akceptuje przesyłania danych przez sieć. Jeśli potrzebujesz trwałej usługi, umieść interfejs API i kolejkę zadań wokół procesu konwersji oraz dodaj walidację żądań, limity czasu, limity rozmiaru pliku i izolację.
Na hoście z systemem Linux lub macOS, używając powłoki Bash lub podobnej, utwórz folder projektu z oddzielnymi katalogami. Umieść tam dokument źródłowy inputi pozostaw go outputpustym przy pierwszym uruchomieniu:
mkdir -p lo-work/input lo-work/output
cp report.docx lo-work/input/
cd lo-work
Poniższe polecenia Dockera używają ścieżek w stylu Uniksa i składni powłoki. W systemie Windows dostosuj składnię ścieżki hosta dla programu PowerShell lub wiersza poleceń i upewnij się, że Docker Desktop ma uprawnienia do udostępniania dysku zawierającego te foldery.
Utwórz plik o nazwie Dockerfileinside lo-workz następującą zawartością:
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-writerZawiera program Writer i filtry konwersji niezbędne do obsługi popularnych formatów edytorów tekstu. Dodaj libreoffice-calclub libreoffice-impresszamknij, jeśli kontener ma konwertować arkusze kalkulacyjne lub prezentacje. Pakiet czcionek to tylko podstawa; zainstaluj czcionki wymagane w dokumentach i miej uprawnienia do ich używania, ponieważ brakujące czcionki mogą wpływać na zawijanie wierszy i podział stron.
Zbuduj obraz z katalogu zawierającego plik Dockerfile:
docker build -t lo-headless .
W przykładzie wykorzystano nazwy pakietów Debian Bookworm. Znaczniki obrazu bazowego i pakiety repozytorium zmieniają się z czasem. W przypadku kompilacji produkcyjnej wybierz utrzymywaną bazę, regularnie ją przebudowuj w celu aktualizacji zabezpieczeń i przypnij obraz bazowy za pomocą skrótu, jeśli potrzebujesz powtarzalnych kompilacji. Unikaj instalowania pakietów z niepowiązanego repozytorium tylko po to, by dopasować je do samouczka.

Uruchom kontener jednorazowego użytku i podaj opcje konwersji po nazwie obrazu. Miejsce montowania wejściowego jest tylko do odczytu; tylko katalog wyjściowy jest zapisywalny. Opcja --useruruchamia proces z identyfikatorami użytkownika i grupy hosta w systemie Linux, jednocześnie HOME=/tmpnadając LibreOffice zapisywalny katalog domowy. Dostosuj uprawnienia folderu, jeśli użytkownik hosta nie może zapisywać w pliku 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
--headlessWyłącza graficzny interfejs użytkownika, --convert-to pdf:writer_pdf_Exportwybiera filtr eksportu PDF i --outdirkieruje wynik do zamontowanego folderu wyjściowego. Unikalna ścieżka profilu użytkownika zapewnia temu procesowi zapisywalny katalog konfiguracyjny LibreOffice; jeśli uruchamiasz kilka konwersji jednocześnie w jednym kontenerze o długim czasie życia, użyj innej ścieżki profilu dla każdego procesu.
Użyj --mountzamiast tego, -vjeśli wolisz bardziej precyzyjną składnię montowania Dockera. Montowania typu „bind” są powiązane ze ścieżkami na hoście demona Dockera, a montowania typu „odczyt-zapis” pozwalają procesom kontenera na zmianę plików hosta. Używaj wąskich montowań, unikaj montowania katalogu domowego lub gniazda Dockera i nie uruchamiaj procesu konwersji dokumentów z niepotrzebnymi uprawnieniami.

Sprawdź katalog wyjściowy hosta po zamknięciu Dockera:
ls -l output/
file output/report.pdf
test -s output/report.pdf
Plik PDF powinien istnieć i być niepusty. Otwórz go w czytniku PDF i sprawdź liczbę stron, tabele, obrazy, podziały stron i czcionki, zanim zaczniesz na nim polegać. Pomyślne zakończenie procesu nie dowodzi, że każdy element został wyrenderowany zgodnie z oczekiwaniami, zwłaszcza gdy dokument używa czcionek lub funkcji niedostępnych w kontenerze. Używaj czystego katalogu wyjściowego lub nowej nazwy pliku wyjściowego dla każdego uruchomienia, aby starszy plik PDF nie został pomylony z najnowszą konwersją.

inputzostał zamontowany w /input, a także czy katalog hosta outputjest dostępny do zapisu dla wybranego użytkownika.-env:UserInstallationścieżka jest zapisywalna. Użyj osobnego katalogu profilu dla każdego jednoczesnego procesu LibreOffice.-v przed użyciem polecenia lub sprawdź, czy oba katalogi hosta istnieją --mounti czy demon ma do nich dostęp.Dokładne działanie opcji można znaleźć w dokumentacji parametrów wiersza poleceń LibreOffice . Nazwy pakietów można sprawdzić w liście pakietów Debian Bookworm dla LibreOffice Writer . Oficjalna dokumentacja Dockera wyjaśnia montowanie powiązań i instrukcje w pliku Dockerfile .
Przetestuj Element Desktop za pomocą Xwayland, zachowaj lokalne dane i wyizoluj problemy z grafiką lub pakietami, gdy Linux Wayland spowoduje awarię aplikacji.
Skonfiguruj Element Android za pomocą UnifiedPush i ntfy, a następnie sprawdź samodzielnie hostowaną bramkę Matrix i ustawienia tła Androida, gdy alerty się nie powiodą.
Przywróć wykrywanie zdjęć w tle, sprawdzając ustawienia przesyłania Nextcloud, uprawnienia iOS, tryb baterii i ograniczenia harmonogramu działania iPhone'a w tle.
Porównaj tryby podpowiedzi czcionek ONLYOFFICE, sprawdź powiększenie i dostępność czcionek w systemie Linux oraz zweryfikuj, czy rozmycie jest ograniczone do edytora, czy też ma wpływ na cały pulpit.
Konwertuj plik PDF lokalnie w edytorach ONLYOFFICE Desktop Editors, a następnie sprawdź plik DOCX pod kątem zmian układu, zeskanowanych stron i tekstu wymagającego korekty.
Dodaj swoje konto ownCloud do ONLYOFFICE Desktop Editors, dowiedz się, co umożliwia to połączenie, i wybierz pomiędzy dostępem bezpośrednim, synchronizacją i edycją w przeglądarce.
Użyj właściwego portalu lub adresu WebDAV, przetestuj dostępność protokołu HTTPS z telefonu i rozróżnij problemy związane z siecią prywatną, protokołem TLS i logowaniem.
Zbuduj i przetestuj niestandardową wtyczkę ONLYOFFICE Desktop Editors, zainstaluj jej archiwum .plugin i aktywuj narzędzia programistyczne do debugowania.
Udostępnij funkcję Pythona w programie Calc, uruchom ją w otwartym arkuszu kalkulacyjnym i rozwiąż problemy z brakującymi makrami lub importami, nie mieszając LibreOffice i systemowego Pythona.
Zablokuj konkretny fragment, uniemożliwiając jego edycję, jednocześnie zachowując użyteczność reszty dokumentu programu Writer, i dowiedz się, kiedy szyfrowanie plików jest lepszym wyborem.