Настройка QZ Tray

Настройка QZ Tray для печати
QZ Tray — это кроссплатформенное приложение, которое позволяет веб-приложениям напрямую взаимодействовать с принтерами. Используйте его, если не удалось подключить принтер стандартным способом или принтер находится в локальной сети.
Когда использовать QZ Tray
  • Принтер не определяется браузером при попытке подключения через USB/Serial/Bluetooth
  • Принтер находится в локальной сети
Шаг 1: Установка QZ Tray
Скачайте и установите QZ Tray версии 2.2.5 с официального сайта:
Скачать QZ Tray 2.2.5
Рекомендуется использовать именно версию 2.2.5 для обеспечения совместимости с приложением.
Порядок установки:
  1. Скачайте установщик для вашей операционной системы (Windows, macOS или Linux)
  2. Запустите установщик и следуйте инструкциям
  3. После установки QZ Tray автоматически запустится и появится в системном трее
  4. Убедитесь, что иконка QZ Tray отображается в области уведомлений
Шаг 2: Подключение к приложению
После установки QZ Tray приложение автоматически обнаружит его при выборе способа печати через QZ Tray в настройках принтера. При первом подключении QZ Tray запросит разрешение на взаимодействие с веб-приложением.
  1. Перейдите в настройки принтера в конфигурации бирки
  2. Выберите способ печати «QZ Tray»
  3. При появлении диалога QZ Tray нажмите «Allow» (Разрешить)
  4. Выберите нужный принтер из списка доступных
Шаг 3: Добавление сертификата (опционально)
Этот шаг не обязателен для работы, но рекомендуется для повышения безопасности и удобства использования.
Для чего нужен сертификат:
  • Автоматическое доверие: QZ Tray не будет запрашивать разрешение при каждом подключении
  • Безопасность: Сертификат подтверждает, что запросы приходят от доверенного приложения
  • Удобство: Не нужно каждый раз подтверждать подключение вручную
Скачивание сертификата
Скачайте сертификат для добавления в QZ Tray:
Скачать сертификат
Установка сертификата в QZ Tray
  1. Щёлкните правой кнопкой мыши по иконке QZ Tray в системном трее
Выберите пункт меню «Advanced» → «Site Manager»
Нажмите кнопку «+» (Add) для добавления нового сайта
Нажмите «Browse» и выберите скачанный файл сертификата
Нажмите «Close» для сохранения настроек
После добавления сертификата QZ Tray будет автоматически доверять запросам от приложения без дополнительных подтверждений.
Решение проблем
QZ Tray не обнаруживается
  • Убедитесь, что QZ Tray запущен (иконка в системном трее)
  • Перезапустите QZ Tray через контекстное меню → «Reload»
  • Проверьте, что брандмауэр не блокирует порт 8181 (WebSocket)
  • Попробуйте перезагрузить страницу браузера
Принтеры не отображаются в списке
  • Убедитесь, что принтер установлен в системе и виден в настройках ОС
  • Для сетевых принтеров проверьте сетевое подключение
  • Перезапустите службу печати в операционной системе
Ошибка подключения
  • Проверьте, что вы разрешили подключение в диалоге QZ Tray
  • Убедитесь, что используется версия QZ Tray 2.2.5
  • Попробуйте добавить сертификат (см. Шаг 3)String