Бухгалтерия требует факс: T.38, res_fax_spandsp и прием документов в PDF
Факс не умер, хотя и старается. Если контрагенты и банки требуют документы, а аппарат сдох, ставим Asterisk с модулем res_fax. Настроим T.38 через PJSIP, научимся ловить TIFF и конвертировать их в PDF для бухгалтерии. Разберем кейс «СтройКомплект-Юг» и покажу, как избежать типичных ошибок провайдера.
Почему факс через SIP — это боль и как с ней жить
Ситуация стандартная: у вас есть SIP-телефония, но вдруг приходит требование от банка или госоргана отправить документ факсом. Старый аппарат на аналоговой линии умер, а провайдер говорит: «У нас VoIP, факс не гарантируем». Это полуправда. Факс по VoIP работает, но требует правильной настройки, иначе вы получите набор точек вместо документа. Проблема в том, что факс — протокол, чувствительный к задержкам и потерям пакетов, а VoIP любит сжимать голос. Если пропустить факс через обычный кодек, он развалится на кусочки. Попробуйте отправить накладную через G.729 — получите абстракционизм, достойный музея современного искусства.
В моих проектах мы используем два подхода: T.38 (цифровой обмен данными) и G.711 pass-through (аудио-трансляция). T.38 — это золотой стандарт, он передает факс как данные, минуя аудио-поток, что надежнее. Но не все провайдеры его поддерживают корректно. Поэтому всегда нужен план Б: фолбэк на аудио-режим. Если T.38 не договорился, система должна плавно переключиться на передачу факса как обычного звука через кодек G.711 (alaw или ulaw). Без этого механизма вы будете терять факсы, особенно в часы пик. Я однажды потратил три часа на то, чтобы объяснить бухгалтеру, почему её накладная превратилась в абстракционизм из-за кодека G.729. Математика здесь простая: сжатие убивает факс.
Проверьте у провайдера поддержку T.38 и возможность его включения. Убедитесь, что провайдер не применяет компрессию голоса (G.729) для факсовых каналов. Настройте в Asterisk автоматический фолбэк на G.711, если T.38 не сработал. Используйте модуль res_fax_spandsp для обработки сигналов факса. Не тратьте время на поиск «волшебной таблетки» — настройка требует точности.
Если провайдер утверждает, что у них «всё работает», а у вас — нет, значит, проблема в их конфиге или в вашей сети. Тестируйте. Не верьте на слово. Факс не прощает ошибок в настройке кодеков и транспорта.
- Проверьте у провайдера поддержку T.38 и возможность его включения.
- Убедитесь, что провайдер не применяет компрессию голоса (G.729) для факсовых каналов.
- Настройте в Asterisk автоматический фолбэк на G.711, если T.38 не сработал.
- Используйте модуль res_fax_spandsp для обработки сигналов факса.
Архитектура решения: res_fax, spandsp и PJSIP
Сердцем системы является модуль res_fax. Он не привязан жестко к одному способу передачи, а делегирует работу специализированным модулям. В современных сборках Asterisk (начиная с 20-й версии) стандартом де-факто стал res_fax_spandsp, который поддерживает библиотеку spandsp 3.0.0. Именно он отвечает за декодирование тональных сигналов CNG и V.21, необходимых для инициации факса. Без него вы не сможете даже начать рукопожатие с факс-машиной. Важно: в старых версиях могли использоваться другие драйверы, но сейчас spandsp — это база. Не пытайтесь использовать устаревшие модули — вы только усложните себе жизнь.
Для SIP-каналов критичен модуль res_pjsip_t38. Он обрабатывает согласование T.38 на уровне PJSIP. В настройках эндпоинта (pjsip.conf) нужно явно включить t38_udptl=yes. Это активирует транспортный протокол UDPTL, по которому летят данные факса. Если оставить default (no), то Asterisk будет пытаться передать факс как аудио, что допустимо только при идеальных условиях сети. Также важно настроить t38_udptl_ec (error correction) — метод коррекции ошибок. Значения fec или redundancy могут спасти передачу при плохом интернете, но некоторые провайдеры их не любят. Здесь нужен тест. Я не раз видел, как «умные» фаерволы провайдеров блокируют пакеты с FEC, считая их атакой. Ирония судьбы: защита от атак убивает легальный факс.
В нашем кейсе с компанией «СтройКомплект-Юг» мы столкнулись с тем, что их провайдер «убивал» пакеты T.38, если они шли нестандартным размером. Пришлось играть с параметрами t38_udptl_maxdatagram и использовать t38_udptl_nat=yes, чтобы пакеты возвращались по адресу источника, а не по записям DNS. Это частая проблема при работе через NAT. Не надейтесь, что «само пройдет». Настройте NAT правильно.
Внимание: модуль res_fax_spandsp требует наличия библиотеки spandsp в системе. В Debian/Ubuntu она часто идет отдельно, в CentOS может потребоваться компиляция из исходников. Не игнорируйте зависимости — без них модуль не загрузится.
Практический разбор: случай «СтройКомплект-Юг»
Оптовая компания «СтройКомплект-Юг» (36 рабочих мест, 2 факс-номера) пришла к нам с проблемой: бухгалтерия не может принимать накладные от поставщиков, а старый факс-аппарат сгорел. Проводить новую аналоговую линию они отказались — дорого и долго. Мы поставили задачу: принимать факсы в цифровом виде, конвертировать их в PDF и отправлять бухгалтеру на почту. Использовали Asterisk 20 LTS (сейчас актуальна 22, но 20 стабильна до 2027 года).
Первая попытка настройки T.38 провалилась: факсы приходили, но были пустыми или с обрезкой страниц. Диагноз: провайдер не поддерживал корректное согласование T.38 без FEC. Мы включили t38_udptl_ec=fec в конфиге PJSIP и добавили t38_udptl_nat=yes. Это решило проблему доставки. Однако при отправке факса от нас на сторонние аппараты возникали ошибки. Причина оказалась в том, что удаленная сторона не инициировала T.38 reinvite. Мы добавили опцию 'z' в приложение SendFAX, принудительно инициируя переход в T.38. Я помню, как администратор провайдера смотрел на меня с ужасом, когда я попросил открыть UDP-порты 4000-4999. Страх перед неизвестностью — частый спутник таких задач.
Результат: 100 % успешность приема и отправки. Бухгалтерия получила скрипт, который автоматически конвертирует TIFF в PDF и шлет на email. Весь процесс занял 2 дня настройки и тестирования. Важно: мы не стали использовать платные лицензии, все решения — на базе open-source модулей. Экономия — это хорошо, но надежность важнее.
Кейс «СтройКомплект-Юг» показывает, что даже при сложных условиях провайдера можно добиться результата. Главное — не сдаваться и искать корень проблемы, а не симптомы.
Конфигурация PJSIP: что включить для факса
В файле pjsip.conf (или realtime-базе данных) для каждого эндпоинта, который будет работать с факсом, нужно прописать специальные директивы. Ключевая — t38_udptl=yes. Без неё T.38 не заработает. Далее, t38_udptl_ec=none по умолчанию, но для надежности лучше ставить fec или redundancy, если провайдер позволяет. Опция t38_udptl_nat=yes обязательна, если ваш Asterisk находится за NAT, чтобы пакеты UDPTL находили обратный путь. Также рекомендую включить fax_detect=yes, чтобы Asterisk сам слушал тон CNG и понимал, что пришел факс, еще до начала диалплана.
Не забудьте про кодеки. Для факса в режиме pass-through (если T.38 не сработал) обязательно разрешите alaw или ulaw (G.711). Используйте allow=ulaw или allow=alaw. Если у вас стоят только сжимающие кодеки типа G.729, факс не пройдет. В примере из документации часто используют allow=G.722 для телефонов, но для факса это не подходит. В конфигах «СтройКомплект-Юг» мы жестко запретили G.729 для факсовых каналов, оставив только G.711. Компрессия — враг факса.
Также полезно настроить t38_bind_udptl_to_media_address=yes, если у вас сложный сетевой дизайн с несколькими интерфейсами. Эта опция появилась в Asterisk 20 и помогает привязать UDPTL к конкретному адресу, избегая проблем с маршрутизацией. Не игнорируйте сетевые нюансы — они могут стать причиной сбоев.
t38_udptl=yes — включение поддержки T.38. t38_udptl_ec=fec — включение коррекции ошибок (если провайдер позволяет). t38_udptl_nat=yes — поддержка NAT для пакетов UDPTL. fax_detect=yes — автоопределение тона факса. allow=ulaw,allow=alaw — разрешение кодеков для фолбэка. Запомните эти параметры — они спасут вас от головной боли.
- t38_udptl=yes — включение поддержки T.38.
- t38_udptl_ec=fec — включение коррекции ошибок (если провайдер позволяет).
- t38_udptl_nat=yes — поддержка NAT для пакетов UDPTL.
- fax_detect=yes — автоопределение тона факса.
- allow=ulaw,allow=alaw — разрешение кодеков для фолбэка.
Дайлплан: прием и отправка факсов
Сама магия происходит в extensions.conf (или pjsip-wizard.conf). Для приема факса используется приложение ReceiveFAX. Синтаксис прост: ReceiveFAX(имя_файла[,опции]). Например, ReceiveFAX(/var/spool/asterisk/fax/${EXTEN}.tif,d). Параметр 'd' включит отладку, что полезно на этапе настройки. Опция 'f' разрешает откат на аудио-передачу, если T.38 не сработал. Это критично для надежности. После выполнения приложения в переменных канала появятся статусы: FAXSTATUS (SUCCESS/FAILURE), FAXPAGES (количество страниц), FAXMODE (T38 или AUDIO).
Для отправки используется SendFAX. Оно принимает список файлов через знак '&'. Пример: SendFAX(/path/to/doc1.tif&/path/to/doc2.tif,z). Опция 'z' принудительно инициирует T.38 reinvite, если удаленная сторона не сделала этого сама. Это часто требуется при работе со старыми факс-машинами. Также доступны опции 'd', 'f', 'F' (принудительно аудио). Важно помнить, что SendFAX работает только с файлами в формате TIFF/F. Обычные TIFF могут не подойти. Я всегда предупреждаю клиентов: если файл не в формате TIFF/F, Asterisk просто откажется его отправлять, и вы получите ошибку в логах. Не экономьте на преобразовании файлов.
В кейсе «СтройКомплект-Юг» мы написали простой диалплан, который при входящем вызове на номер факса сразу запускает ReceiveFAX. Если статус успеха — запускаем внешний скрипт для конвертации. Если ошибка — логируем и шлем уведомление администратору. Это позволило полностью исключить ручной контроль. Автоматизация — лучший друг бухгалтера.
Файлы сохраняются в формате TIFF/F. Для дальнейшей работы (отправка по почте) нужна конвертация в PDF, так как бухгалтерии неудобно открывать TIFF. Не заставляйте людей возиться с форматами — делайте всё автоматически.
Конвертация в PDF и отправка на почту
Asterisk не умеет конвертировать TIFF в PDF. Это задача внешних инструментов. Стандартный путь — использование утилиты tiff2pdf из пакета libtiff-tools (или аналога). После приема факса и сохранения файла в /var/spool/asterisk/fax/, нужно вызвать скрипт, который конвертирует файл и отправляет его через sendmail или curl на email бухгалтера. В «СтройКомплект-Юг» мы использовали bash-скрипт, который запускался через Action в AMI или через dialplan-приложение System().
Пример логики: ReceiveFAX сохраняет файл -> проверяем переменную FAXSTATUS -> если SUCCESS, запускаем tiff2pdf input.tif output.pdf -> отправляем output.pdf на email через mailx. Важно добавить обработку ошибок: если конвертация не прошла, файл не удалять, а отправить алерт. Также полезно добавить в тему письма номер факса и количество страниц (они есть в переменных FAXPAGES и LOCALSTATIONID).
Не забывайте про права доступа. Процесс Asterisk (обычно пользователь asterisk) должен иметь право читать файлы из директории спула и запускать утилиты конвертации. Часто проблема кроется именно в правах на выполнение скрипта или доступ к библиотекам. Однажды мы тратили час на поиск ошибки, пока не поняли, что скрипт не может прочитать файл из-за прав доступа. Простая ошибка, но она может стоить вам нервов.
Конвертация в PDF — последний шаг перед отправкой. Без неё бухгалтерия не сможет работать с документами. Делайте это автоматически и надёжно.
Что проверить у провайдера и типичные проблемы
Прежде чем винить Asterisk, спросите у провайдера: поддерживают ли они T.38? Многие говорят «да», но на практике пакеты теряются или блокируются фаерволом. Попросите включить T.38 на линии и проверить, пропускают ли они пакеты на портах UDPTL (обычно диапазон 4000-4999). Также уточните, используют ли они компрессию голоса для факсовых вызовов. Если да — просите отключить её для этих каналов. Не верьте на слово — проверяйте.
Частая проблема — NAT. Если ваш Asterisk за роутером, убедитесь, что настроен t38_udptl_nat=yes и открыты нужные UDP-порты. Иногда помогает t38_udptl_maxdatagram, если провайдер ограничивает размер пакета. Еще один нюанс: некоторые провайдеры требуют, чтобы факс шел только в режиме T.38, другие — только в аудио. Без тестов понять невозможно. В «СтройКомплект-Юг» мы потратили день на переговоры с провайдером, чтобы они включили FEC.
Если факс «зависает» на этапе рукопожатия — проверьте логи Asterisk (verbose=10 или debug). Там видно, какой этап провален: CNG, V.21 или передача данных. Часто проблема в задержках сети. Для диагностики используйте команды amidebug или monitor вызова. Логи — ваш лучший друг в таких ситуациях.
Типичные ошибки: неправильные кодеки, закрытые порты, отсутствие поддержки T.38 у провайдера. Избегайте их — настройте всё правильно с первого раза.
Частые вопросы
Можно ли отправлять факс напрямую из Asterisk без файлов?
Нет, приложение SendFAX требует готовые TIFF-файлы. Нужно сначала создать изображение документа, конвертировать в TIFF и передать в Asterisk.
Работает ли T.38 без модуля res_fax_spandsp?
Нет, res_fax_spandsp необходим для обработки сигналов факса и поддержки T.38 в современных версиях Asterisk.
Как узнать, прошел ли факс успешно?
Проверьте переменную FAXSTATUS после выполнения ReceiveFAX или SendFAX. Она будет равна SUCCESS или FAILURE. Также смотрите логи и события AMI FAXStatus.
Нужно ли устанавливать дополнительные библиотеки для spandsp?
Да, библиотека spandsp (версия 3.0.0+) должна быть установлена в системе отдельно, если не входит в пакет Asterisk вашего дистрибутива.
Можно ли использовать T.38 с провайдерами, которые его не поддерживают?
Нет, T.38 требует поддержки с обеих сторон. Если провайдер не поддерживает, придется использовать фолбэк на G.711 pass-through.
Источники
- Asterisk Documentation: ReceiveFAX — Синтаксис и опции приложения ReceiveFAX, переменные статуса. URL: https://docs.asterisk.org/Latest_API/API_Documentation/Dialplan_Applications/ReceiveFAX/
- Asterisk Documentation: SendFAX — Синтаксис и опции приложения SendFAX, включая опцию 'z' для T.38 reinvite. URL: https://docs.asterisk.org/Latest_API/API_Documentation/Dialplan_Applications/SendFAX/
- Asterisk Documentation: PJSIP Endpoint Options — Описание параметров t38_udptl, fax_detect, t38_udptl_ec и других опций T.38 в PJSIP. URL: https://docs.asterisk.org/Latest_API/API_Documentation/Module_Configuration/res_pjsip/
- Asterisk Changelog: Version 20 — Информация о поддержке spandsp 3.0.0 и модуле res_pjsip_t38. URL: https://docs.asterisk.org/Asterisk_20_Documentation/Upgrading/
- Asterisk Config Samples — Образцы конфигов res_fax.conf, udptl.conf и pjsip.conf с настройками T.38. URL: https://raw.githubusercontent.com/asterisk/asterisk/master/configs/samples/



