Установка драйвера принтера Pantum P2516 на Debian 12 с KDE Plasma

Недавно я купил новый монохромный лазерный принтер Pantum P2516. Компактный, скорость печати до 22 страниц в минуту — для домашних задач самое то. Однако, как пользователь Debian 12 с KDE Plasma, я знал, что установка проприетарных драйверов в Linux иногда превращается в небольшое приключение. Так и вышло.

Скачивание и подготовка

Первым делом я отправился на официальный сайт Pantum https://global.pantum.com/support/download/driver/, нашёл там свой принтер и скачал архив «Pantum Linux Driver V1_1_167.zip». Распаковал его в домашнюю папку:

cd ~/distrib
unzip Pantum\ Linux\ Driver\ V1_1_167.zip

Структура распакованного архива выглядела так:

.
├── install.sh
└── Resources
    ├── built_i386.sh
    ├── built_x86-64.sh
    ├── installer.c
    ├── installer_i386
    ├── installer_x86-64
    ├── locale
    │   └── ... (папки с локалями)
    ├── pantum_1.1.167-1_amd64.deb
    └── uninstall

Внутри папки Resources находился сам установщик installer_x86-64 и готовый DEB-пакет. Я решил использовать установщик, так как он должен был автоматически скопировать все нужные файлы и зарегистрировать принтер в системе.

Первая попытка установки

Запустил installer_x86-64 прямо из терминала, без всяких дополнительных команд:

cd ~/distrib/Pantum\ Linux\ Driver\ V1.1.167/Resources
./installer_x86-64

На экране появилось графическое окно с лицензионным соглашением. Я прочитал условия и нажал кнопку «Установить».

Но к моему удивлению, ничего не произошло. Кнопка не срабатывала, установка не начиналась. Я посмотрел в терминал, откуда был запущен установщик, и увидел следующие строки:

./installer_x86-64
ru_RU.UTF-8

(installer_x86-64:27762): Gtk-WARNING **: 11:31:17.179: Загружаемый модуль тем не найден в module_path: «adwaita»,
sh: 1: pkexec: not found
system return 32512
delete event occurred

Ошибка pkexec: not found сразу указала на причину. Установщик пытался повысить привилегии с помощью pkexec, но этой утилиты в системе не было. В Debian 12 устанавливается пакет policykit-1, который содержит pkexec. Без него установщик просто игнорировал нажатие кнопки, потому что не мог получить права root.

Установка policykit-1

Я быстро исправил ситуацию, установив необходимый пакет:

sudo apt update
sudo apt install policykit-1

После этого снова запустил установщик точно так же, как и раньше:

./installer_x86-64

На этот раз, при нажатии кнопки «Установить», система запросила пароль root (через стандартный диалог PolicyKit), и установка пошла. Установщик показал ход распаковки, скопировал файлы и сообщил об успешной установке. В терминале появился такой вывод:

ru_RU.UTF-8

(installer_x86-64:28038): Gtk-WARNING **: 11:33:00.559: Загружаемый модуль тем не найден в module_path: «adwaita»,
64bit system
Выбор ранее не выбранного пакета pantum.
(Чтение базы данных … на данный момент установлено 261775 файлов и каталогов.)
Подготовка к распаковке pantum_1.1.167-1_amd64.deb …
Распаковывается pantum (1.1.167-1) …
Настраивается пакет pantum (1.1.167-1) …
Debian 12
ippusbxd:0
ipp-usb:1
cp: не удалось выполнить stat для '/opt/pantum/ptpackages/Debian/Debian_12/x86_64/x86_64-linux-gnu/*': Нет такого файла или каталога
cp: не удалось выполнить stat для '/opt/pantum/ptpackages/Debian/Debian_12/x86_64/libcupsimage2/*': Нет такого файла или каталога
Debian12_x86_64:copy libcupsimage.so.2
Pantum-1.1.167-1 installed
system return 0

Первая проблема: «Filter failed»

Я добавил принтер в систему через штатное средство KDE:

Но печать тестовой страницы завершалась с ошибкой. В очереди печати (в системных настройках KDE) задание зависало со статусом «Filter failed». Это означало, что один из фильтров CUPS, отвечающих за преобразование данных в команды для принтера, не работает.

Я решил заглянуть в логи CUPS, чтобы понять причину. Для этого открыл терминал и выполнил команду для просмотра последних 50-ти строк лога ошибок подсистемы печати:

tail -50 /var/log/cups/error_log

Затем отправил тестовую страницу на печать. В логах я увидел множество строк, но ключевая ошибка была внутри Ghostscript:

D [03/Aug/2026:11:40:47 +0500] [Job 2] **** Error: Page drawing error occurred.
D [03/Aug/2026:11:40:47 +0500] [Job 2] Could not draw this page at all, page will be missing in the output.

Стандартный фильтр gstoraster не мог правильно обработать страницу. Тогда я решил проверить, какой именно фильтр использует PPD-файл принтера. PPD-файлы хранятся в /etc/cups/ppd/. Я выполнил:

grep -i cupsfilter /etc/cups/ppd/Pantum_P2510_series.ppd

И получил:

*cupsFilter: "application/vnd.cups-raster 0 pt2510Filter"

Значит, драйверу нужен собственный фильтр pt2510Filter, а не универсальный. Я проверил, существует ли этот файл в стандартном каталоге фильтров CUPS:

ls -l /usr/lib/cups/filter/pt2510Filter

Вывод показал:

-rwxr-xr-x 1 root root 335304 мая 23  2025 /usr/lib/cups/filter/pt2510Filter

Файл на месте и имеет права на выполнение. Но почему же он не работает? Я решил проверить его библиотечные зависимости с помощью команды ldd:

ldd /usr/lib/cups/filter/pt2510Filter

Среди множества строк увидел критическую:

libcupsimage.so.2 => not found

Вот оно! Фильтру не хватало библиотеки libcupsimage.so.2.

Решение: установка libcupsimage2

Я проверил, установлен ли пакет, предоставляющий эту библиотеку:

dpkg -l | grep libcupsimage

Команда ничего не вывела, значит пакет отсутствовал. Установил его:

sudo apt update
sudo apt install libcupsimage2

После установки снова выполнил ldd для проверки:

ldd /usr/lib/cups/filter/pt2510Filter

Теперь строка с libcupsimage.so.2 показывала путь:

libcupsimage.so.2 => /lib/x86_64-linux-gnu/libcupsimage.so.2 (0x00007f811d8e2000)

Библиотека найдена.

Дополнительные проверки и настройки

Чтобы убедиться, что принтер виден системе и все демоны работают корректно, я выполнил несколько дополнительных команд.

Проверка доступных устройств печати

lpinfo -v

В выводе увидел строку с моим принтером:

direct usb://Pantum/P2510%20series?serial=CK4SV00HFD

Это подтвердило, что система определяет принтер по USB.

Перезапуск CUPS

После всех изменений перезапустил службу CUPS, чтобы она подхватила новые библиотеки и настройки:

systemctl restart cups

Финальная проверка: печать тестовой страницы

Я снова отправил тестовую страницу. На этот раз печать прошла успешно — принтер ожил и выдал лист с информацией о модели, драйвере и настройках.

На тестовой странице были указаны все параметры: модель Pantum P2516, драйвер P2510.PPD (драйвер для серии P2510 подходит для P2516), разрешение и другие настройки.

Итоги и выводы

Установка драйвера Pantum на Debian 12 оказалась нетривиальной, но вполне решаемой задачей. Вот что я вынес из этого опыта:

• Фильтр pt2510Filter собран с зависимостью libcupsimage.so.2. Но разработчики Pantum либо забыли добавить зависимость в control-файл DEB, либо рассчитывали, что библиотека уже есть в системе.
• Не доверяйте полностью автоматическим установщикам. Даже если они сообщают об успехе, стоит проверить логи и зависимости.
• Всегда проверяйте библиотечные зависимости фильтров с помощью ldd. В моём случае проблема была в отсутствующей libcupsimage2, которая не была указана в зависимостях DEB-пакета.
• Логи CUPS (journalctl -u cups -f и /var/log/cups/error_log) — лучший друг. Без них я бы долго гадал, почему фильтр не работает.
• Полезно проверить наличие устройства через lpinfo -v и убедиться, что службы не конфликтуют.

Донаты принимаются на кошельки:

Yoomoney:
4100118091867315

Карта Т-Банк (бывший Тиньков):
2200 7017 2612 2077

Карта Альфа-Банк:
2200 1539 1357 2013