Факс
MonoPbx отправляет и принимает факсы по SIP. Пользователи отправляют PDF из веб-клиента, а полученные факсы приходят по электронной почте в виде PDF. Протокол факса T.30 выполняется в отдельном процессе-движке (mpbx-faxd, на основе SpanDSP), поэтому в АТС ничего из него не встроено.
Установка факс-движка
Движок поставляется в виде отдельного образа и использует сеть контейнера АТС, потому что медиапорты, которые АТС выделяет для факсового звонка, привязываются именно там.
# From deploy/compose/prod: start the PBX with the fax engine next to it.
docker compose -f compose.yaml -f compose.fax.yaml up -d
docker compose -f compose.yaml -f compose.fax.yaml ps
compose.fax.yaml задаёт за вас три параметра [fax] АТС:
| Параметр | Переменная окружения | Значение |
|---|---|---|
engine | MPBX__FAX__ENGINE | tcp://127.0.0.1:7310 (управляющий порт движка, только loopback, без аутентификации) или абсолютный путь к программе движка. |
spool | MPBX__FAX__SPOOL | Каталог, общий с движком, для принятых страниц и документов на отправку. |
media_ip | MPBX__FAX__MEDIA_IP | Адрес, на котором движок привязывает свои медиапотоки; он должен быть доступен с медиаретранслятора. |
Для АТС также должны быть настроены стек SIP и файловое хранилище (PDF хранятся в файловом хранилище компании). Движок может запускаться после АТС: АТС продолжает повторные попытки и проверяет движок каждые 10 секунд. Пока движок недоступен, факсы в очереди ждут, а не завершаются ошибкой, а входящие факсовые вызовы отклоняются. Метрика mpbx_fax_engine_up равна 1, пока движок отвечает, и 0, пока он недоступен; mpbx_fax_engine_restarts_total считает переподключения. Настройте оповещение на mpbx_fax_engine_up == 0 дольше нескольких минут.
Движок работает без каких-либо привилегий (capabilities), с файловой системой только для чтения, 256 МБ памяти и одним процессором. Он обрабатывает не более 16 одновременных звонков, по 30 минут и 200 страниц каждый, и 64 МБ на документ.
Факсовые линии
В разделе Администрирование, Факсовые линии добавьте по одной линии на каждый номер факса:
- Номер: номер в формате
+E.164. Он должен быть DID одной из транковых линий компании, потому что входящий звонок на него принимает факс-движок. Номер может принадлежать только одной линии. - Отправлять на: до 10 адресов электронной почты; каждый получает все факсы этой линии.
- T.38 и Резерв G.711: см. следующий раздел.
- Включена: выключенная линия не отвечает на звонки.
Пользователь, которому разрешено отправлять факсы (право fax:write), использует раздел Факс в веб-клиенте: вводит номер назначения, выбирает PDF (до 10 МиБ) и отправляет. В списке видны факсы, отправленные этим пользователем; администратор видит все факсы компании. У каждого факса с документом есть кнопка Скачать, а факс в очереди можно отменить. У обычных пользователей нет прав на факс, пока администратор не выдаст роли fax:read или fax:write.
T.38 или G.711
- Сквозная передача G.711 (аудио) работает у любого оператора, который сохраняет звук чистым: без эхоподавления, без манипуляций с джиттер-буфером, без транскодирования. Она дольше устанавливается и чувствительна к потерям пакетов.
- T.38 передаёт факс как пакеты данных (UDPTL) и гораздо лучше переносит потери пакетов. Требуется транк с поддержкой T.38. АТС предлагает T.38 через re-INVITE, если линия это разрешает и другая сторона заявляет о поддержке, и никогда не предлагает его на участках SRTP или WebRTC.
При включённых обоих вариантах (по умолчанию) АТС сначала пробует T.38 и переходит на G.711, если оператор отказывает или не отвечает на re-INVITE. Отключайте Резерв G.711 только тогда, когда оператор гарантирует T.38; тогда отказ приводит к ошибке факса t38_refused. Отключите T.38 для оператора, который некорректно отвечает на re-INVITE. Исходящие факсы набираются по обычному плану набора от имени отправляющего пользователя, поэтому действуют правила защиты от телефонного мошенничества и правила исходящих вызовов.
Ограничения
| Что | Ограничение |
|---|---|
| Документ | PDF, не более 10 МиБ (иначе MPBX-FAX-DOCUMENT-INVALID) |
| Разрешение | PDF растеризуется в 204 x 196 dpi, чёрно-белый (по порогу) |
| Страниц в факсе | 200 |
| Длительность звонка | 30 минут |
| Параллельные звонки | 16 на движок |
| Повторные попытки | 3 попытки с интервалами 5 и 15 минут при занято, нет ответа и ошибках линии; сбои, которые повтор не исправит (неверный документ, нет общего режима, отказ T.38), завершаются ошибкой сразу |
| Хранилище | Факсы учитываются в квоте хранилища факсов компании; полученный факс сверх квоты отклоняется |
Хранение
PDF каждого завершённого факса (отправленного и полученного) по умолчанию хранится 365 дней, затем удаляется; факс остаётся в истории с пометкой, что его документа больше нет (MPBX-FAX-DOCUMENT-GONE). Задайте MPBX_FAX_RETENTION_DAYS, чтобы изменить значение по умолчанию для всей установки (0 хранит всё). Администратор компании может задать собственный срок в разделе Голос и медиа, Факсовые линии, в форме Хранение документов (от 1 до 3650 дней; 0 хранит всё для этой компании; пустое значение следует значению по умолчанию для установки). Удаления учитываются в журнале аудита. Скачивания PDF факса также попадают в аудит.
Доставка по почте
Полученный факс преобразуется в один PDF, сохраняется в файловом хранилище компании и отправляется по почте на каждый адрес линии: PDF во вложении, номер отправителя, число страниц и время в тексте письма. Почта уходит через почтовые настройки компании. Если почтовый провайдер недоступен, факс не теряется: он сохраняется и отображается как доставленный с пометкой mail_failed, а пользователи скачивают его из веб-клиента. Каждый полученный факс порождает событие fax.received, каждый отправленный — fax.sent, каждая ошибка — fax.failed; подпишитесь через вебхук или WebSocket событий.
Устранение неполадок
| Признак | Что проверить |
|---|---|
| Факсы остаются в очереди | mpbx_fax_engine_up равна 0: проверьте docker compose ps и журналы движка; см. MPBX-FAX-ENGINE-UNAVAILABLE. Факс со временем повтора ждёт этого времени. |
| Входящий звонок не принимается как факс | Номер должен точно (+E.164) совпадать с включённой линией и быть DID транка той же компании. |
Ошибка t38_refused или no_t38_media | Оператор не поддерживает T.38: разрешите резерв G.711. |
Много t30_timeout или искажённые страницы на G.711 | Потери пакетов или обработка звука на пути. Используйте T.38, отключите эхоподавление и кодеки, кроме PCMU/PCMA, на транке и убедитесь, что media_ip доступен с медиаретранслятора. |
Ошибка rasterize_failed или document_error | PDF повреждён или защищён паролем. Распечатайте его в новый PDF и отправьте снова. |
| Факс получен, но письма нет | Проверьте почтовые настройки компании; у факса отметка mail_failed. PDF по-прежнему в списке. |
| При скачивании сообщается, что документа больше нет | Его удалило хранение. |
Доказательство того, что весь путь работает, — тест с замыканием deploy/faxd/tests/e2e.sh: он отправляет PDF от имени пользователя, растеризует и передаёт его через два настоящих движка, принимает на второй линии и проверяет сохранённый PDF, письма, события и скачивание. Проверки с настоящим факсимильным аппаратом или T.38 оператора выполняются в вашей лаборатории.
В консоли
Откройте Голос и медиа, Факсовые линии (/admin/fax-lines). Для просмотра страницы нужно право settings:read, для изменения — settings:write.
- Добавляйте факсовую линию, изменяйте её (название, номер, получатели e-mail, T.38, резерв G.711 и отвечает ли линия на звонки) или удаляйте.
- Форма Хранение документов задаёт, как долго хранится PDF завершённого факса. Сам факс остаётся в истории.