PDF 변환을 위해 Docker에서 LibreOffice Headless를 실행하세요.

예. 일회성 문서 변환의 경우, LibreOffice가 설치된 소형 Docker 이미지를 빌드하고 soffice --headless다음 명령으로 실행하세요 --convert-to. 입력 디렉터리는 읽기 전용으로 마운트하고, 별도의 출력 디렉터리는 쓰기 권한으로 마운트하여 PDF 파일이 호스트에 표시되도록 합니다. 이 예제는 Debian 기반 이미지를 사용하고 DOCX 파일 하나를 PDF로 변환합니다. LibreOffice를 네트워크 서비스로 노출하지는 않습니다.

LibreOffice Writer와 글꼴이 설치된 Debian 기반 Dockerfile을 표시하는 터미널 편집기
Dockerfile은 LibreOffice Writer와 기본 글꼴 패키지를 설치한 다음 soffice를 컨테이너 명령으로 사용합니다.

헤드리스 모드는 어떤 기능을 하며, Docker는 언제 유용할까요?

헤드리스 모드는 그래픽 인터페이스 없이 LibreOffice를 시작합니다. LibreOffice는 명령줄 및 API 제어 사용에 대한 이 모드를 문서화했으며, 명령줄 옵션은 출력 디렉터리를 지정하여 파일을 변환하는 기능을 지원합니다. Docker는 애플리케이션과 그 종속성을 패키징하므로 ​​스크립트나 워크스테이션에서 호스트에 데스크톱 제품군을 설치하지 않고도 동일한 컨테이너 이미지를 실행할 수 있습니다.

이 패턴은 로컬 배치 작업, CI 작업 또는 파일을 받아 변환 결과를 저장하는 백엔드 워커에 적합합니다. 일반 헤드리스 컨테이너는 그 자체로 HTTP 변환 API가 아닙니다. 포트를 사용하지 않고 웹 업로드도 허용하지 않습니다. 지속적인 서비스가 필요한 경우 변환 프로세스 주변에 API와 작업 큐를 배치하고 요청 유효성 검사, 시간 초과, 파일 크기 제한 및 격리 기능을 추가해야 합니다.

1. 입력 폴더와 출력 폴더를 생성합니다.

Linux 또는 macOS 호스트에서 Bash 또는 유사한 셸을 사용하여 프로젝트 폴더를 만들고 그 안에 별도의 디렉토리를 생성합니다. 소스 문서를 해당 디렉토리에 넣고 처음 실행할 때는 비워 input두십시오 .output

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

아래 Docker 명령어는 Unix 스타일의 경로와 셸 구문을 사용합니다. Windows에서는 PowerShell 또는 명령 프롬프트에 맞게 호스트 경로 구문을 조정하고 Docker Desktop이 해당 폴더가 포함된 드라이브를 공유할 수 있도록 허용해야 합니다.

2. LibreOffice를 사용하여 이미지 빌드

Dockerfile다음 내용을 포함 하는 파일을 생성하세요 lo-work:

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-writerWriter와 일반적인 워드 프로세싱 형식에 필요한 변환 필터를 제공합니다. 컨테이너가 스프레드시트나 프레젠테이션을 변환해야 하는 경우 libreoffice-calc해당 옵션을 추가하세요 libreoffice-impress. 글꼴 패키지는 기본 구성품일 뿐이므로 문서에 필요한 글꼴을 설치하고 사용 권한을 확보해야 합니다. 글꼴이 누락되면 줄 바꿈 및 페이지 나누기가 변경될 수 있습니다.

Dockerfile이 포함된 디렉토리에서 이미지를 빌드합니다.

docker build -t lo-headless .

이 예제에서는 Debian Bookworm 패키지 이름을 사용합니다. 기본 이미지 태그와 저장소 패키지는 시간이 지남에 따라 변경될 수 있습니다. 프로덕션 환경에서 빌드할 때는 유지 관리되는 기본 이미지를 선택하고, 보안 업데이트를 위해 정기적으로 다시 빌드하며, 재현 가능한 빌드가 필요한 경우 다이제스트를 사용하여 기본 이미지를 고정하십시오. 튜토리얼을 따라 하기 위해 관련 없는 저장소에서 패키지를 설치하는 것은 피하십시오.

터미널에 `docker build -t lo-headless .` 명령어가 실행 중이며 컨테이너 이미지 빌드가 완료되었음을 보여줍니다.
변환 컨테이너를 실행하기 전에 Dockerfile을 사용하여 로컬 이미지를 빌드하십시오.

3. LibreOffice를 개별 마운트로 실행

일회용 컨테이너를 시작하고 이미지 이름 뒤에 변환 옵션을 전달합니다. 입력 마운트는 읽기 전용이며 출력 디렉터리만 쓰기 가능합니다. `--` 옵션은 --userLinux에서 호스트 사용자 및 그룹 ID로 프로세스를 실행하고 HOME=/tmpLibreOffice에 쓰기 가능한 홈 디렉터리를 제공합니다. 호스트 사용자가 해당 디렉터리에 쓰기 권한이 없는 경우 폴더 권한을 조정하십시오 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

--headlessGUI를 숨기고 --convert-to pdf:writer_pdf_ExportPDF 내보내기 필터를 선택한 다음 --outdir마운트된 출력 폴더로 결과를 보냅니다. 고유한 사용자 프로필 경로를 통해 이 프로세스는 LibreOffice 구성 디렉터리에 쓰기 권한을 갖게 됩니다. 하나의 장기 실행 컨테이너에서 여러 변환 작업을 동시에 실행하는 경우 각 프로세스에 대해 서로 다른 프로필 경로를 사용하십시오.

--mountDocker의 보다 명확한 마운트 구문을 선호한다면 대신 를 사용하십시오 -v. 바인드 마운트는 Docker 데몬 호스트의 경로에 연결되고, 읽기/쓰기 마운트는 컨테이너 프로세스가 호스트 파일을 변경할 수 있도록 합니다. 마운트는 범위가 좁게 유지하고, 홈 디렉터리나 Docker 소켓을 마운트하지 마십시오. 또한 불필요한 권한으로 문서 변환 워커를 실행하지 마십시오.

터미널 명령어를 사용하여 읽기 전용 입력, 쓰기 가능 출력, 헤드리스 변환 및 별도 프로필을 활성화한 상태에서 lo-headless 컨테이너를 실행합니다.
실행 명령은 호스트의 접근 권한을 두 프로젝트 폴더로 제한하면서 소스 파일을 soffice로 전달합니다.

4. PDF 파일이 생성되었는지 확인하십시오.

Docker가 종료된 후 호스트 출력 디렉토리를 확인하십시오.

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

PDF 파일은 존재해야 하며 비어 있지 않아야 합니다. PDF 리더로 파일을 열어 페이지 수, 표, 이미지, 페이지 나누기 및 글꼴을 확인한 후 사용하십시오. 프로세스가 성공적으로 종료되었다고 해서 모든 요소가 의도대로 렌더링되었다는 것을 보장하는 것은 아닙니다. 특히 문서에서 컨테이너에 없는 글꼴이나 기능을 사용하는 경우에는 더욱 그렇습니다. 이전 PDF 파일이 최신 변환 파일로 오인되지 않도록 매번 실행할 때마다 깨끗한 출력 디렉터리를 사용하거나 새로운 출력 파일 이름을 사용하십시오.

터미널 목록 보고서(report.pdf)가 출력 디렉터리에 있으며 PDF 문서임을 나타냅니다.
출력 파일이 존재하고 PDF 형식으로 인식되는지 확인한 후, 페이지 레이아웃 변경 사항을 검토하십시오.

변환이 실패하면 무엇을 확인해야 할까요?

  • 출력 파일이 없습니다. 소스 파일 이름과 컨테이너 경로( input마운트 위치 포함 /input) 및 호스트 output디렉터리에 선택한 사용자가 쓰기 권한이 있는지 확인하십시오.
  • 프로필 또는 잠금 오류: 경로에 쓰기 권한이 있는지 확인하십시오 -env:UserInstallation. 동시에 실행되는 각 LibreOffice 프로세스마다 별도의 프로필 디렉터리를 사용하십시오.
  • 레이아웃이 변경되었습니다. 이미지에 필요한 글꼴을 설치하고 PDF를 검토하십시오. 글꼴 사용 가능 여부, 내보내기 필터 및 버전 차이로 인해 데스크톱 시스템과 렌더링 결과가 다를 수 있습니다.
  • Docker 마운트 오류:-v 또는 를 사용하기 전에 두 호스트 디렉터리가 모두 존재하는지 확인 --mount하고 데몬이 해당 디렉터리에 접근할 수 있는지 확인하십시오.

옵션의 정확한 동작 방식은 LibreOffice의 명령줄 매개변수 참조를 확인하세요. 패키지 이름은 Debian Bookworm의 LibreOffice Writer 패키지 목록 에서 확인할 수 있습니다 . Docker 공식 문서에서는 바인드 마운트 및 Dockerfile 사용법을 설명합니다 .

댓글 남기기

Nextcloud 아이폰 사진 업로드 기능을 백그라운드에서 실행하세요

Nextcloud 아이폰 사진 업로드 기능을 백그라운드에서 실행하세요

Nextcloud 업로드 설정, iOS 권한, 배터리 모드 및 iPhone 백그라운드 예약 기능의 제한 사항을 확인하여 백그라운드 사진 감지 기능을 복원하세요.

ONLYOFFICE Desktop에서 더 선명한 텍스트 보기: Linux에서 글꼴 힌팅 설정 조정

ONLYOFFICE Desktop에서 더 선명한 텍스트 보기: Linux에서 글꼴 힌팅 설정 조정

ONLYOFFICE의 글꼴 힌팅 모드를 비교하고, 확대/축소 및 Linux 글꼴 사용 가능 여부를 확인하고, 흐림 효과가 편집기에만 적용되는지 아니면 데스크톱 전체에 영향을 미치는지 검증하십시오.

ONLYOFFICE Desktop에서 PDF 파일을 편집 가능한 DOCX 파일로 변환하기

ONLYOFFICE Desktop에서 PDF 파일을 편집 가능한 DOCX 파일로 변환하기

ONLYOFFICE 데스크톱 편집기에서 PDF를 로컬로 변환한 다음 DOCX 파일을 검토하여 레이아웃 변경 사항, 스캔한 페이지 및 수정이 필요한 텍스트를 확인하십시오.

ONLYOFFICE 데스크톱 편집기를 ownCloud 파일에 연결하세요

ONLYOFFICE 데스크톱 편집기에 ownCloud 계정을 추가하고, 연결을 통해 얻을 수 있는 이점을 이해한 다음, 직접 액세스, 동기화 및 브라우저 편집 중에서 선택하세요.

ONLYOFFICE 모바일 시간 초과 오류를 해결하려면 서버 URL을 확인하세요.

ONLYOFFICE 모바일 시간 초과 오류를 해결하려면 서버 URL을 확인하세요.

올바른 포털 또는 WebDAV 주소를 사용하고, 휴대폰에서 HTTPS 연결 가능 여부를 테스트하고, 사설 네트워크, TLS 및 로그인 문제를 구분하십시오.

ONLYOFFICE 데스크톱 플러그인 개발 및 디버깅 활성화

ONLYOFFICE 데스크톱 플러그인 개발 및 디버깅 활성화

ONLYOFFICE 데스크톱 편집기용 사용자 지정 플러그인을 빌드하고 테스트한 다음, 해당 .plugin 아카이브를 설치하고 디버깅을 위해 개발자 도구를 활성화합니다.

LibreOffice의 매크로 시스템을 통해 Calc에서 Python 실행하기

LibreOffice의 매크로 시스템을 통해 Calc에서 Python 실행하기

Calc에서 Python 함수를 사용할 수 있도록 만들고, 열려 있는 스프레드시트에서 해당 함수를 실행하고, LibreOffice와 시스템 Python을 혼동하지 않고 누락된 매크로 또는 가져오기 문제를 해결하세요.

선택한 작성자 텍스트를 섹션 암호로 보호하세요

선택한 작성자 텍스트를 섹션 암호로 보호하세요

Writer 문서의 나머지 부분은 계속 사용할 수 있도록 유지하면서 특정 구절에 대한 일반적인 편집을 차단하는 방법과 파일 암호화가 더 나은 선택인 경우를 알아보세요.

LibreOffice Calc 다크 모드에서 스프레드시트 텍스트를 읽기 쉽게 만들기

LibreOffice Calc 다크 모드에서 스프레드시트 텍스트를 읽기 쉽게 만들기

Calc에서 테마, 셀 글꼴 색상, 채우기 및 조건부 서식을 확인하여 잘 보이지 않는 스프레드시트 텍스트를 수정하세요.

LibreOffice Calc에서 수식이 텍스트로 표시되나요? 결과 복원하기

LibreOffice Calc에서 수식이 텍스트로 표시되나요? 결과 복원하기

Calc에서 계산된 값 대신 수식 텍스트가 표시되는 이유를 알아보고, 표시 모드, 텍스트 서식 셀, 작은따옴표 또는 오래된 결과 문제를 해결하세요.