# DOCX в PDF: быстро и без Word

Нужно перевести документ Word в PDF? Запустите LibreOffice во временной Linux-машине без установки офисного пакета на свой компьютер. Схема «файл → инструмент → готовый файл» подходит для множества консольных программ.

* **Скачайте:** [набор инструментов](/example-assets/file-toolbox.zip) · [тестовый DOCX](/example-assets/toolbox-sample.docx) · [локально полученный PDF](/example-assets/toolbox-sample.pdf)
* **Вам понадобится:** Python 3.10+ локально. Устанавливать офисный пакет не придется.

## Запуск[​](#run "Прямая ссылка на Запуск")

Распакуйте архив `file-toolbox`. Ваш аккаунт должен иметь квоту на создание как минимум одной песочницы (2 vCPU, 2048 МиБ RAM, 4096 МиБ диска) и права на шаблон `base` с доступом к apt-репозиториям и настроенным sudo без пароля.

Используйте DOCX без пароля размером до **64 МиБ**. Учитывайте, что на скачивание действует ограничение в 256 МиБ на файл, а весь процесс ожидания выполнения фоновой задачи ограничен 20 минутами.

Настройка доступа к API (один раз)

Задайте HTTPS-адрес своей платформы и персональный токен с правами *Полные* локально:

```
export JUSTRUN_API="https://your-just-run-host"
read -rsp 'just-run PAT: ' JUSTRUN_PAT; printf '\n'
export JUSTRUN_PAT
```

```
cd file-toolbox
python3 run.py pdf sample.docx
```

Замените `sample.docx` на путь к вашему документу. Исходный файл не изменится. Скрипт создаст новую песочницу, установит LibreOffice (вместе со шрифтами DejaVu/Liberation и инструментами проверки PDF), конвертирует файл без графического интерфейса, проверит результат и удалит песочницу. Публичные порты не нужны, персональный токен остается на вашем компьютере.

## Что получится[​](#result "Прямая ссылка на Что получится")

Готовый документ сохранится в **`pdf-result/document.pdf`**. В файле `result.json` вы найдете версию LibreOffice, размеры файлов и техническую информацию из `pdfinfo`. Скрипт проверяет не только отсутствие ошибок при выполнении, но и наличие PDF-сигнатуры и читаемых страниц в итоговом файле.

В приложенном тестовом документе есть таблица, принудительный разрыв страницы и кирилица. Обработка локально создает **две страницы**. Обязательно проверяйте свой результат — переносы страниц, таблицы и шрифты. LibreOffice может сверстать DOCX иначе, чем Word, особенно если в системе нет оригинальных шрифтов документа. Документы с паролем в этом примере не поддерживаются.

## Как адаптировать[​](#customise "Прямая ссылка на Как адаптировать")

Основная команда конвертации внутри песочницы выглядит так:

```
libreoffice -env:UserInstallation=file:///workspace/office-profile \
  --headless --convert-to pdf:writer_pdf_Export \
  --outdir /workspace/output /workspace/input.docx
```

Скачанный `job.py` управляет установкой пакетов, таймаутами и проверкой результата, а `run.py` отвечает за передачу файлов и жизненный цикл ресурса. Если нужны дополнительные параметры, сверьтесь с [документацией LibreOffice](https://help.libreoffice.org/latest/en-US/text/shared/guide/start_parameters.html).

Второй запуск того же рецепта завершится ошибкой: папка `pdf-result` уже существует. Для другого документа укажите отдельную папку:

```
python3 run.py pdf "another document.docx" --output another-pdf
```

## Удаление ресурсов[​](#cleanup "Прямая ссылка на Удаление ресурсов")

И после успеха, и после ошибки скрипт пытается удалить песочницу. Если процесс прервался, сохраните `.file-toolbox-state.json` и повторите:

```
python3 run.py --cleanup
```

Если API недоступен, позднее найдите выведенный ID в разделе *Песочницы*. Удаление песочницы оставляет исходник и скачанные файлы локально. Оборванное скачивание может оставить `.part`-файл; возобновление загрузки не обещается. При ошибке конвертации смотрите `job.log`, если он скачался.

**Дальше:** [конвертация видео и извлечение звука через FFmpeg](/examples/convert-video-with-ffmpeg.md).
