Установка ПринтМенеджера — онлайн, автоматические сертификаты

Цель

Установить ПринтМенеджер на сервер с выходом в интернет с использованием автоматически генерируемых системой SSL-сертификатов. Подходит, когда собственные сертификаты не требуются.

Предусловия

Сервер соответствует требованиям из страницы «Требования к серверу для установки Принтум».
Сервер имеет выход в интернет и доступ к https://s3.printum.io.
Подключение к серверу по SSH под пользователем с правами sudo.
Установлен curl.
Если нет выхода в интернет, переходите к разделу «Установка ПринтМенеджера — офлайн, автоматические сертификаты».

Что потребуется

IP-адрес сервера или доменное имя (хостнейм).
При желании — пароль для суперпользователя.
При нестандартных портах — номера портов HTTP и HTTPS.

Шаги установки

Шаг 1. Подключиться к серверу по SSH

ssh username@ip_address

Где username —логин пользователя на сервере, а ip_address — адрес удаленного сервера.

После ввода этой команды нужно будет ввести пароль от учетной записи для подключения.

Шаг 2. (Опционально) Задать пароль суперпользователя

Если требуется задать пароль администратора ПринтМенеджера на этапе установки:

export PM_ADMIN_PASSWORD=<пароль>

Пароль можно задать и позже.

Шаг 3. (Опционально) Задать нестандартные порты

Если требуется установить ПринтМенеджер с нестандартными портами:

export PM_HTTP_PORT=x

где x — порт для http протокола.

export PM_HTTPS_PORT=x

где x — порт для https протокола.

Шаг 4. Запустить установку

Установка с адресацией по IP-адресу и с использованием автоматических сертификатов:

sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E PM_HOSTNAME=<ip> bash

где <ip> — IP-адрес сервера. Не используйте адреса из пула 10.28.32.0/26, они используются внутренней сетью.

Установка с адресацией по доменному имени и с использованием автоматических сертификатов:

sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E PM_HOSTNAME=<hostname> bash

где <hostname> — доменное имя сервера.

Шаг 5. (Опционально) Установка на выделенный сервер

Для установки ПринтМенеджера на выделенный сервер (отдельно от Мониторинга) добавьте в команду установки переменную MONITORING_ADDRESS:

sudo curl -L https://s3.printum.io/distrib/printum-printmanager/install.sh | sudo -E MONITORING_ADDRESS=<mon_hostname_or_ip> PM_HOSTNAME=<hostname> bash

где <mon_hostname_or_ip> — доменное имя или IP-адрес сервера мониторинга.

Шаг 6. Дождаться завершения установки

При установке автоматически происходит сравнение чек-суммы (алгоритм sha512) скачанного архива с файлом на сервере для подтверждения его целостности. Среднее время установки — 10–20 минут.

Ожидаемый результат

Установка завершается без ошибок.
В выводе указан URL панели администратора ПринтМенеджера.
Панель администратора («зелёная админка») доступна по адресу https://<ip_address>:8080/config/.

Как проверить установку

Открыть в браузере URL панели администратора ПринтМенеджера.
Авторизоваться с учётными данными по умолчанию: логин printum, пароль printum.

Следующие шаги

«Завершение установки ПринтМенеджера — первый вход и проверка»
«Установка ПринтМенеджера — подключение к внешней PostgreSQL» (если нужна внешняя БД)

Типовые ошибки

curl недоступен на сервере — установить пакет curl или перейти к офлайн-установке.
Нет доступа к https://s3.printum.io — проверить интернет-соединение сервера; при отсутствии доступа использовать офлайн-установку.
Авторизация на панели администратора не проходит — если при установке задавался PM_ADMIN_PASSWORD, использовать его вместо пароля по умолчанию printum.
Браузер предупреждает о недоверенном сертификате — при автоматически генерируемых сертификатах предупреждение ожидаемо; для устранения используйте собственные сертификаты.
Адрес из пула 10.28.32.0/26 — эти адреса используются внутренней сетью; выбрать другой IP-адрес сервера.

Связанные страницы

Revision #9
Created 2026-05-09 12:16:37 UTC by DD
Updated 2026-05-18 08:14:56 UTC by Мария Царёва