Перейти к основному содержимому

MonoPbx как IMS для частной сети 4G/5G на Open5GS

Это руководство подключает к MonoPbx частную сеть LTE или 5G, построенную на Open5GS. Open5GS отвечает за радио и передачу данных (attach, bearer-каналы, IP-адреса). MonoPbx выступает как IMS: это P-CSCF, с которым регистрируются телефоны; он проверяет SIM-карту (IMS-AKA) и выдаёт каждой SIM обычный внутренний номер MonoPbx для голоса и SMS.

В итоге телефон в вашей сети сможет зарегистрироваться для VoLTE, позвонить на внутренний номер и принять звонок с него.

:::info Справочная страница Это руководство пошаговое. Каждая настройка IMS описана в разделе Режим IMS (VoLTE и VoWiFi). Используете чисто 5G-ядро на free5GC? См. IMS для частной сети с free5GC. :::

Что вы построите​

data (internet APN)
Phone ──radio── eNB / gNB ──┬──────────────────────────────▶ internet
(SIM) │
┌─────────▼───────────── Open5GS ─────────────┐
│ MME / AMF SGW-U/UPF SMF HSS / UDM │
│ │ PCRF (4G) / PCF (5G)
└──────────┬───────────────┼─────────┬────────┘
│ "ims" APN/DNN │ │ Diameter Rx (4G)
│ (own subnet) │ │ TCP 3868
┌──────────▼───────────────┘ │
│ MonoPbx │
│ P-CSCF + S-CSCF + registrar ◀────┘
│ SIP 5060, built-in subscriber data (HSS role)
│ rtpengine for media, extensions, SMS
└──────────▲────────────────────────────────────┘
│ IKEv2 / ESP, UDP 500 and 4500 (optional)
Phone ──Wi-Fi── internet ─────┘ ePDG (VoWiFi)

Как всё связано:

  • Телефон подключается (attach) к APN по умолчанию (internet), а затем открывает второе PDN-соединение на APN ims (DNN в 5G). Open5GS выделяет этой сессии собственный диапазон адресов и при установке сессии сообщает телефону адрес P-CSCF. Этот адрес и есть MonoPbx.
  • Телефон отправляет SIP REGISTER в MonoPbx по сессии ims. MonoPbx запрашивает аутентификацию IMS-AKA и проверяет ответ по ключу SIM, поэтому MonoPbx нужны те же K и OPc, что и у абонента в Open5GS.
  • Rx (4G): для каждого звонка MonoPbx просит PCRF Open5GS создать выделенный канал (bearer) для голосового потока. Это необязательно; без него звонки идут по основному каналу ims.
  • VoWiFi (необязательно): телефон строит туннель IKEv2 до ePDG MonoPbx через любую сеть Wi-Fi. Open5GS в этом не участвует.

Перед началом​

Что нужноПримечания
Open5GSРабочая сеть, в которой телефон уже подключается и имеет интернет через APN internet. Ключи конфигурации ниже проверены по файлам Open5GS 2.8.0. См. быстрый старт Open5GS.
SIM-карты, которые можно программироватьНужно знать IMSI, K и OPc (или OP) каждой SIM. В Open5GS и MonoPbx значения должны совпадать. В руководстве используется тестовая PLMN 001/01. Open5GS по умолчанию поставляется и с 999/70; если используете её, замените везде mnc001.mcc001 на mnc070.mcc999.
ТелефоныТелефоны с поддержкой VoLTE, которым можно указать использовать её в вашей PLMN (см. шаг 6).
Хост MonoPbxLinux, доступный из пользовательской плоскости Open5GS (UPF) по постоянному IP-адресу. Шаг 1 ссылается на руководства по установке.
СетьМаршрут из подсети UE ims до хоста MonoPbx и обратно (см. шаг 3) и отсутствие NAT между UPF и MonoPbx.
Ваши именаRealm IMS строится из PLMN: ims.mnc<MNC>.mcc<MCC>.3gppnetwork.org, где MNC дополняется нулями до трёх цифр. Для PLMN 001/01: ims.mnc001.mcc001.3gppnetwork.org. Телефоны строят его по SIM; регистрировать его в публичном DNS не нужно.

В примерах используются адреса из диапазонов для документации. Замените их своими.

ИмяПример
Хост MonoPbx (P-CSCF)192.0.2.10
Хост ядра Open5GS (SMF, PCRF, UPF)192.0.2.20
Подсеть UE internet10.45.0.0/16
Подсеть UE ims10.46.0.0/16
Адрес ePDG (VoWiFi)192.0.2.30
Идентификатор Diameter MonoPbxmpbx.ims.mnc001.mcc001.3gppnetwork.org, realm ims.mnc001.mcc001.3gppnetwork.org

Шаг 1. Установите MonoPbx​

Установите MonoPbx с помощью установщика для ВМ, Docker Compose, пакетов или Kubernetes и завершите первый запуск. Затем создайте как минимум одного пользователя с внутренним номером для каждой SIM, как в разделе Добавление пользователей, внутренних номеров и телефонов. SIM регистрируется только на включённый внутренний номер активного пользователя.

Откройте эти порты для пользовательской плоскости Open5GS (подсеть UE ims): UDP и TCP 5060 (SIP) и диапазон RTP для rtpengine. MonoPbx сам подключается к PCRF по TCP 3868, поэтому порт Diameter ничего не слушает. Полный список приведён в разделе Требования к сети.

:::tip Куда телефоны отправляют SIP Телефоны отправляют SIP на адрес P-CSCF, который им выдаёт Open5GS. Используйте реальный адрес хоста (192.0.2.10) как адрес прослушивания SIP и как sip.advertise. В Linux-пакете Compose SIP-периметр (mpbx-sip) уже слушает порт 5060 на хосте. :::

Шаг 2. Включите режим IMS и задайте realm​

По умолчанию IMS выключен. Системный администратор включает его в конфигурации установки, затем перезапускает MonoPbx.

При установке из пакетов или в виртуальной машине добавьте в файл конфигурации (mpbx.toml):

[ims]
enabled = true

Та же настройка в виде переменной окружения: MPBX__IMS__ENABLED=true. В Linux-пакете Docker Compose задайте её для сервисов, на которых работают API и SIP-движок, с помощью дополнительного файла переопределений рядом с пакетом (compose.ims.yaml) и добавьте его в команду docker compose ... up -d из руководства по установке. start.sh дополнительный файл не включает, поэтому для запуска и перезапуска используйте эту команду:

services:
mpbx:
environment:
MPBX__IMS__ENABLED: "true"
mpbx-sip-engine:
environment:
MPBX__IMS__ENABLED: "true"
docker compose -f compose.yaml -f compose.linux.yaml -f compose.ims.yaml up -d --wait

После перезапуска в консоли администратора появится раздел Мобильная сеть (VoLTE / VoNR). Откройте Сеть (для системных администраторов) и задайте:

Поле консолиЗначение для этого руководстваЗачем
Код страны (MCC)001Ваша PLMN
Код сети (MNC)01Ваша PLMN. 2 или 3 цифры
Домашний домен IMSims.mnc001.mcc001.3gppnetwork.orgRealm, который телефоны строят по SIM
Источник данных абонентовЭта установка (встроенный)См. шаг 4
Алгоритм по умолчанию для новых абонентовMilenageТо, что использует Open5GS
Защищать регистрации с помощью IPsecВыключено для этой первой проверкиСм. примечание ниже
Разрешить голос по Wi-FiВыключено до необязательного раздела про VoWiFi

Сохраните. IMPI по умолчанию для новой SIM станет <IMSI>@ims.mnc001.mcc001.3gppnetwork.org.

:::note IPsec (TS 33.203) При выключенном IPsec регистрации идут по обычному SIP в сессии ims, то есть в вашей собственной частной сети. Это самый простой способ получить первый звонок. Чтобы защитить регистрации с помощью IPsec, запустите роль P-CSCF и направьте на неё движки, как описано в разделе Режим IMS, VoLTE. SIM с политикой IPsec required получает отказ, пока это не настроено. :::

Шаг 3. Open5GS: APN ims и адрес P-CSCF​

Телефонам нужна вторая сессия ims с собственным диапазоном адресов и адрес P-CSCF при установке сессии. Внесите изменения ниже, затем перезапустите демоны, названные в конце.

SMF: пул адресов для ims и P-CSCF​

В smf.yaml выделите каждому DNN свою подсеть (такая структура приведена в образце файла Open5GS) и укажите в p-cscf адрес MonoPbx. Оба ключа находятся под smf:.

smf:
session:
- subnet: 10.45.0.0/16
gateway: 10.45.0.1
dnn: internet
- subnet: 10.46.0.0/16
gateway: 10.46.0.1
dnn: ims
p-cscf:
- 192.0.2.10

В образце файла Open5GS предупреждается, что UE, запросивший DNN, которого нет в списке, может привести к сбою SMF и UPF, поэтому перечислите все DNN, которые используют ваши телефоны. В 5G, если вы ограничиваете DNN блоком info: в SMF, добавьте ims в список DNN слайса.

UPF: соответствующий интерфейс​

В upf.yaml нужны те же два пула, и у каждого есть сетевое устройство с адресом шлюза (из образца файла Open5GS):

upf:
session:
- subnet: 10.45.0.0/16
gateway: 10.45.0.1
dnn: internet
- subnet: 10.46.0.0/16
gateway: 10.46.0.1
dnn: ims
dev: ogstun2

Создайте второе устройство и назначьте ему адрес шлюза (пул internet сохраняет ogstun по умолчанию):

sudo ip tuntap add name ogstun2 mode tun
sudo ip addr add 10.46.0.1/16 dev ogstun2
sudo ip link set ogstun2 up

Маршрутизация и брандмауэр​

Подсеть ims должна достигать MonoPbx, а MonoPbx должен достигать её в ответ:

  • Если MonoPbx на другом хосте, добавьте на нём (или на используемом им маршрутизаторе) обратный маршрут: sudo ip route add 10.46.0.0/16 via 192.0.2.20
  • Не применяйте NAT к подсети ims в сторону MonoPbx. MonoPbx запрашивает у PCRF канал по адресу телефона, каким он виден в SIP, и PCRF находит сессию именно по этому адресу.
  • Если вы применили усиление защиты из быстрого старта Open5GS (правила, отбрасывающие трафик из подсетей UE к хосту ядра), разрешите 10.46.0.0/16 к 192.0.2.10 по UDP/TCP 5060 и для диапазона rtpengine.
  • Оставьте включённой пересылку (net.ipv4.ip_forward=1), как и для пула internet.

QoS сессии ims​

QCI 5 (5QI 5) — стандартное QoS для сигнализации IMS, и Open5GS требует его на основном канале сессии ims. Вы задаёте его для каждого абонента на шаге 4.

Перезапустите демоны, читающие эти файлы:

sudo systemctl restart open5gs-smfd open5gs-upfd

Шаг 4. Абоненты​

Каждая SIM существует в двух местах: в Open5GS (чтобы телефон мог подключиться) и в MonoPbx (чтобы телефон мог зарегистрироваться для голоса). В обоих должны совпадать IMSI, K, OPc и AMF.

В WebUI Open5GS​

Откройте http://<open5gs host>:9999, Subscriber, и добавьте или измените SIM:

Поле WebUIЗначение
IMSI001010000000001 (IMSI этой SIM)
Subscriber Key (K)ключ K этой SIM
USIM Type / Operator KeyOPc (или OP) и его значение
Authentication Management Field (AMF)8000 (по умолчанию)
MSISDNнеобязательно, номер телефона

В Slice Configurations, Session Configurations добавьте две сессии:

DNN/APNТип5QI/QCIARP Priority LevelCapabilityVulnerability
internetIPv498DisabledDisabled
imsIPv451DisabledDisabled

Значения взяты из руководства Open5GS по VoLTE. Задайте для сессии ims значение Session-AMBR (например, 3850 Кбит/с на приём и 1530 Кбит/с на передачу, из того же руководства).

Для выделенных каналов (необязательный шаг Rx) добавьте в сессию ims PCC Rule: 5QI/QCI 1 (голос), ARP priority 2, Capability Enabled, Vulnerability Enabled, MBR и GBR по 128 Кбит/с в обе стороны. PCRF Open5GS ищет правило с QCI 1 для каждого аудиопотока и отклоняет запрос, если такого правила нет. Сохраните.

В MonoPbx​

  1. Откройте Мобильная сеть (VoLTE / VoNR), Абоненты IMS, Добавить абонента.
  2. Введите IMSI, ключ абонента K и ключ оператора (OPc или OP; MonoPbx один раз преобразует его и не хранит). Оставьте Разрешённый доступ равным VoLTE и VoWiFi, а IPsec — Как в настройках установки.
  3. Выберите Внутренний номер, которому принадлежит эта SIM. SIM регистрируется только на включённый внутренний номер активного пользователя.
  4. MonoPbx сам добавляет публичный идентификатор (IMPU), с которым регистрируется SIM без приложения ISIM, sip:001010000000001@ims.mnc001.mcc001.3gppnetwork.org, и IMPI по умолчанию 001010000000001@ims.mnc001.mcc001.3gppnetwork.org. В разделе Публичные идентификаторы (IMPU) добавляйте только дополнительные идентификаторы, например tel:+15551230001 (номер телефона; необязательно, но нужно, чтобы дозвониться до телефона по номеру). Для большого числа SIM используйте массовый импорт, описанный в разделе Режим IMS, абоненты. Чтобы сменить внутренний номер уже добавленной SIM, откройте её через Управление и выберите другой Внутренний номер.

K и OPc доступны только для записи: после сохранения MonoPbx больше их не показывает, поэтому храните собственную запись.

SIM регистрируется, только если она активна, связана с включённым внутренним номером активного пользователя и её политика доступа разрешает этот доступ. Во всех остальных случаях возвращается просто 403.

:::info Где хранятся ключи Вы вводите ключи дважды, потому что Open5GS аутентифицирует attach (собственным HSS), а MonoPbx аутентифицирует регистрацию IMS. Им не нужно взаимодействовать друг с другом. MonoPbx ведёт собственный порядковый номер для каждой SIM, поэтому первая регистрация может занять один дополнительный обмен, пока SIM и MonoPbx согласуют его. Это нормально.

MonoPbx может также получать данные абонентов от внешнего HSS по Cx, если HSS реализует Cx; см. Режим IMS. В этом руководстве он не используется. :::

Шаг 5. Управление политиками по Rx (4G)​

Этот шаг необязателен. Он заставляет Open5GS создавать для каждого звонка выделенный голосовой канал (QCI 1). Если его пропустить, звонки идут по основному каналу ims, чего достаточно для первой проверки.

MonoPbx открывает соединение Diameter с PCRF Open5GS и отправляет запросы Rx для медиа звонка. Open5GS отвечает, создавая канал через SMF.

Сторона Open5GS: freeDiameter​

Open5GS работает на freeDiameter. PCRF принимает только известные ему узлы, поэтому добавьте MonoPbx в pcrf.conf (в установке Open5GS это /etc/freeDiameter/pcrf.conf) и сделайте так, чтобы PCRF слушал адрес, доступный для MonoPbx. В образце файла он слушает только 127.0.0.9:

Identity = "pcrf.localdomain";
Realm = "localdomain";
ListenOn = "127.0.0.9";
ListenOn = "192.0.2.20";
NoRelay;

ConnectPeer = "smf.localdomain" { ConnectTo = "127.0.0.4"; No_TLS; };
ConnectPeer = "mpbx.ims.mnc001.mcc001.3gppnetwork.org" { ConnectTo = "192.0.2.10"; No_TLS; };
  • Оставьте строки, которые уже есть в вашем файле (Identity, Realm, TLS_*, LoadExtension, узел smf). Добавьте только второй ListenOn и ConnectPeer для mpbx.
  • Имя в ConnectPeer должно в точности совпадать с Origin-Host, который вы зададите в MonoPbx ниже. freeDiameter разрывает соединение, если идентификатор в ответе о возможностях отличается.
  • No_TLS означает отсутствие TLS на этом канале, как в образце файла. MonoPbx не слушает Diameter, поэтому собственные попытки PCRF подключиться к 192.0.2.10 будут неудачными и повторяться; это безвредно. Трафик несёт соединение, которое MonoPbx открывает к PCRF.
  • Identity и Realm по умолчанию в Open5GS — pcrf.localdomain и localdomain. Если вы их изменили, используйте свои значения в MonoPbx.
  • Если ваша сборка freeDiameter не принимает две строки ListenOn, замените строку с loopback новым адресом и измените ConnectTo в smf.conf на тот же адрес.

Перезапустите PCRF и SMF:

sudo systemctl restart open5gs-pcrfd open5gs-smfd

Сторона MonoPbx: узел Diameter и управление политиками​

В Мобильная сеть (VoLTE / VoNR):

  1. В разделе Управление политиками (выделенные каналы) установите Сервер политик в значение PCRF по Diameter Rx.
  2. Задайте Наш Origin-Host Diameter — mpbx.ims.mnc001.mcc001.3gppnetwork.org и Наш Origin-Realm Diameter — ims.mnc001.mcc001.3gppnetwork.org.
  3. В разделе Узлы Diameter нажмите Добавить узел:
Поле консолиЗначение
Названиеopen5gs-pcrf
Идентификатор узла (Destination-Host)pcrf.localdomain
Realm узла (Destination-Realm)localdomain
Имя хоста или IP-адрес192.0.2.20
Порт3868
ТранспортTCP
Использовать TLSвыключено (узел PCRF использует No_TLS)
НазначениеRx (управление политиками)
Приоритет (меньшее значение первым)1
Отправлять запросы watchdogвключено, 30 секунд
Используетсявключено
  1. Сохраните, затем перезапустите движок MonoPbx, чтобы он открыл соединение (узлы Diameter и управление политиками читаются при запуске движков): docker compose -f compose.yaml -f compose.linux.yaml -f compose.ims.yaml restart mpbx-sip-engine в Linux-пакете Compose или перезапустите сервис mpbx при установке в один процесс.

Realm узла должен быть собственным realm PCRF: MonoPbx адресует ему каждый запрос, а PCRF не ретранслирует сообщения для других realm.

Карточка Состояние внизу страницы настроек через несколько секунд показывает узел как Подключено. Обмен возможностями (CER/CEA) требует, чтобы PCRF поддерживал приложение Rx и отвечал с заданным вами идентификатором; иначе карточка указывает причину, по которой узел недоступен.

Чтобы защитить канал Diameter с помощью TLS, передайте MonoPbx CA сертификата PCRF и включите Использовать TLS; на стороне Open5GS уберите No_TLS из этого ConnectPeer. Настройка сертификата в этом руководстве не рассматривается.

5G (N5 к PCF)​

В ядре 5G PCRF Open5GS не используется. MonoPbx обращается к PCF по HTTP с той же целью (Сервер политик: PCF по HTTP (N5), Базовый URL PCF, аутентификация и необязательные исходные сети PCF). Это рассчитано на PCF, который принимает запросы сессии приложения Npcf_PolicyAuthorization в том виде, в каком их отправляет MonoPbx.

Open5GS работает с N5, начиная с этой версии MonoPbx. MonoPbx отправляет атрибут поддерживаемых функций (suppFeat, функция IMS-SBI), который PCF Open5GS требует в запросе создания сессии приложения; прежние версии его не отправляли, и PCF отклонял каждый запрос с HTTP 400. Используйте эту версию MonoPbx или новее. В WebUI Open5GS задайте сессии ims PCC Rule, как для Rx (5QI 1, шаг 4), и после звонка проверьте в журнале PCF запрос сессии приложения. Если запрос отклонён, звонок всё равно идёт по потоку QoS по умолчанию сессии ims (5QI 5).

Шаг 6. Телефоны​

  1. Вставьте запрограммированную SIM. Телефон должен подключиться к вашей PLMN (001/01) и иметь данные на APN internet.
  2. Добавьте APN IMS: имя ims, APN ims, тип ims (на некоторых телефонах тип называется «IMS» и отделён от APN данных по умолчанию). Имя APN должно совпадать с DNN, созданным в Open5GS.
  3. Включите VoLTE.
    • Телефоны используют VoLTE только там, где конфигурация оператора разрешает это для PLMN SIM, а у лабораторной PLMN её нет. Телефоны здесь различаются, поэтому проверьте, что поддерживает ваш аппарат.
    • Android: решает конфигурация оператора. Соответствующие ключи в CarrierConfigManager — KEY_CARRIER_VOLTE_AVAILABLE_BOOL (carrier_volte_available_bool) для VoLTE и KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL (carrier_wfc_ims_available_bool) для звонков по Wi-Fi. Их можно задать из приложения с привилегиями оператора (SIM с правилами carrier privilege) или инженерными средствами устройства. См. справочник Android.
    • iPhone: VoLTE и звонки по Wi-Fi включаются профилем оператора, установленным для SIM, поэтому лабораторной SIM нужен профиль, который их разрешает. Спросите у поставщика SIM, какие аппараты он проверял.
  4. Если телефон запрашивает адрес SMSC, укажите тот, который вы задали в MonoPbx (шаг 7).
  5. Включите и выключите режим полёта, чтобы телефон подключился заново и построил сессию ims. После регистрации телефон должен показать индикатор VoLTE или HD Voice.

Если SMF вернул адрес P-CSCF, телефон будет его использовать. На многих телефонах его можно прочитать в журнале модема или IMS; он должен быть 192.0.2.10.

Шаг 7. Первый звонок и SMS​

Звонки.

  1. В консоли откройте Абоненты IMS и проверьте, что абонент этой SIM Действует.
  2. После регистрации телефона (см. контрольный список) позвоните на внутренний номер SIM со стационарного телефона или софтфона, зарегистрированного в MonoPbx. Телефон звонит.
  3. Позвоните с мобильного аппарата на другой внутренний номер.
  4. Наберите с мобильного аппарата внешний номер, чтобы проверить транк и исходящие правила, как для любого внутреннего номера.

Медиа проходит через rtpengine, поэтому адрес rtpengine, который объявляет MonoPbx, должен быть доступен из подсети ims.

:::info Звонки на другие типы телефонов Аппарат VoLTE использует AMR-WB или AMR; стационарные телефоны и транки используют G.711. Звонки между мобильными аппаратами не требуют преобразования. Для звонков между мобильным аппаратом и чем-либо ещё включите в настройках Мобильные кодеки для VoLTE и VoWiFi (AMR-WB, AMR) и используйте rtpengine, умеющий кодировать AMR. Сначала прочтите примечание о лицензии у этой настройки; лицензии на кодеки AMR и EVS — ваша ответственность. См. Режим IMS. :::

SMS.

  1. В настройках IMS задайте Адрес SMSC (номер E.164, хост или URI SIP, например +10000000000) и убедитесь, что у компании есть служба SMS с номером для пользователя.
  2. Отправьте сообщение с мобильного аппарата. MonoPbx принимает его, отправляет через службу SMS компании с одного из номеров пользователя и возвращает отчёт о доставке на телефон.
  3. Сообщение, которое компания получает на номер, направленный на пользователя или внутренний номер SIM, также доставляется на мобильный аппарат.

Контрольный список проверки​

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

  • Телефон подключился и имеет интернет на APN internet. В Open5GS: sudo journalctl -u open5gs-mmed -u open5gs-smfd показывают attach и сессию.
  • Существует вторая сессия для APN ims с адресом из 10.46.0.0/16 (журнал SMF показывает вторую сессию).
  • С адреса ims телефона SIP-порт MonoPbx отвечает: проверьте на хосте MonoPbx, что SIP с 10.46.x.x приходит (sudo tcpdump -ni any udp port 5060).
  • На REGISTER телефона приходит 401, а затем 200 OK. При журнале движка уровня debug MonoPbx называет причину отказа для 403 (но никогда не ключи).
  • В консоли внутренний номер SIM отображается как зарегистрированный.
  • Только Rx: в разделе Мобильная сеть (VoLTE / VoNR), Сеть, карточка Состояние показывает узел Diameter как Подключено.
  • Только Rx: совершите звонок, затем найдите в /var/log/open5gs/pcrf.log запрос Rx от MonoPbx, а в журналах SMF и MME — создание выделенного канала. Если загружен dbg_msg_dumps, как в образце файла, PCRF выводит получаемые сообщения Diameter. После звонка канал удаляется.
  • Звонок в каждом направлении имеет звук в обе стороны.
  • Сообщение с мобильного аппарата доходит до адресата, а сообщение на номер SIM доходит до мобильного аппарата.

Устранение неполадок​

СимптомВероятная причинаЧто проверить
Телефон подключается, но сессии ims нетAPN отсутствует в телефоне или у абонента, либо у DNN нет пулаAPN ims на телефоне в точности совпадает с DNN; у абонента в WebUI есть сессия ims; smf.yaml и upf.yaml оба содержат подсеть ims; SMF и UPF были перезапущены
Сессия ims есть, но телефон никогда не регистрируетсяАдрес P-CSCF не был выданp-cscf задан под smf: и SMF был перезапущен; у APN IMS на телефоне тип ims
REGISTER не доходит до MonoPbxМаршрутизация, брандмауэр или NATОбратный маршрут до 10.46.0.0/16; порты 5060 UDP/TCP открыты; нет NAT подсети ims; правила усиления защиты из быстрого старта
REGISTER снова и снова получает 401K или OPc отличаются в Open5GS и MonoPbx, либо телефон отвергает сетьЗаново введите K и OPc в MonoPbx через Заменить ключи; проверьте, что AMF равен 8000 с обеих сторон. Если порядковый номер SIM опережает, MonoPbx синхронизируется сам; бесконечный 401 означает несовпадение ключей
REGISTER получает 403Абонент приостановлен или не связан с включённым внутренним номером активного пользователя; политика доступа не разрешает этот доступ; идентификатор To не входит в публичные идентификаторы SIM; IPsec обязателен, но не настроенСтраница абонента; для SIM, добавленной в старой версии, добавьте sip:<IMSI>@ims.mnc001.mcc001.3gppnetwork.org как IMPU; настройка IPsec
REGISTER получает 500 с Retry-AfterБэкенд абонентов недоступенВ этом руководстве режим — Эта установка (встроенный); другой бэкенд должен быть доступен
Телефон регистрируется, но звонок никогда не вызывает внутренний номерSIM связана с другим внутренним номером, либо внутренний номер отключёнСвязь абонента; состояние внутреннего номера
Звонки соединяются с односторонним звуком или без звукаUPF не достигает rtpengine, либо rtpengine объявляет адрес, недоступный из подсети imsМаршрутизация из 10.46.0.0/16 до адреса rtpengine и диапазона RTP; RTPE_ADVERTISE; брандмауэр; затем проверьте Мобильные кодеки, если звонок с мобильного аппарата на транк беззвучен
Узел Diameter остаётся в состоянии Недоступен или ПодключениеPCRF не знает MonoPbx, идентификаторы различаются или брандмауэр блокирует 3868Имя в ConnectPeer в точности равно Origin-Host MonoPbx; Идентификатор узла равен Identity PCRF; PCRF слушает 192.0.2.20 (ss -ltn sport = :3868); TCP 3868 открыт с хоста MonoPbx; карточка состояния показывает причину
Узел Подключено, но у звонков нет выделенного каналаНет правила PCC с QCI 1, нет сессии Gx для адреса телефона или между UPF и MonoPbx есть NATВ сессии ims в WebUI есть правило PCC с QCI 1; в pcrf.log ищите "No PCC Rule" или "Cannot find Gx Session"; адрес телефона, каким его видит MonoPbx, не транслируется
Звонки обрываются, когда канал не удаётся создатьPCRF отказал или радиосеть не поддерживает выделенные каналыОтказ обычно оставляет звонок на основном канале; проверьте, что eNB поддерживает QoS и выделенные каналы

Необязательно: VoWiFi (звонки по Wi-Fi) с ePDG​

При VoWiFi телефон строит туннель IKEv2 до ePDG MonoPbx через любую сеть Wi-Fi и регистрируется через него. ePDG аутентифицирует телефон по EAP-AKA' с тем же ключом SIM, что и на шаге 4, и выдаёт ему адрес внутри туннеля, адрес P-CSCF и DNS-сервер. Open5GS не участвует: туннель несёт только сигнализацию и медиа IMS телефона до MonoPbx, соединения S2b с SMF Open5GS нет.

Запуск ePDG​

ePDG — это процесс mpbx-epdg на Linux-хосте с публичным или маршрутизируемым адресом, сертификатом для его имени и правом занимать UDP 500 и 4500. Настройки, из раздела Режим IMS, VoWiFi:

На движках:

[ims.epdg]
link_listen = "0.0.0.0:7444" # where the ePDG connects to the engine
pool = "10.9.0.0/22" # the same pool the ePDG uses

Секрет канала — переменная окружения MPBX_IMS_EPDG_LINK_SECRET (32 случайных байта, openssl rand -base64 32), одно и то же значение на движке и на ePDG.

На хосте ePDG:

[ims]
enabled = true

[ims.epdg]
address = "192.0.2.30"
id = "epdg.epc.mnc001.mcc001.pub.3gppnetwork.org"
cert_file = "/etc/mpbx/epdg.crt"
key_file = "/etc/mpbx/epdg.key"
link_connect = "192.0.2.10:7444"
pool = "10.9.0.0/22"
pcscf = ["192.0.2.10"]
dns = ["192.0.2.53"]

Имя в сертификате должно совпадать с id, а его цепочка должна быть той, которой доверяет телефон. Телефоны проверяют сертификат ePDG по собственному хранилищу доверенных сертификатов, поэтому для частной сети используйте сертификат от публичного CA или установите ваш CA на тестовые телефоны. Затем включите Разрешить голос по Wi-Fi в настройках IMS. Разрешённый доступ SIM должен быть VoLTE и VoWiFi или Только VoWiFi. Отбрасывайте пакеты из пула, которые приходят не через туннель, как описано в разделе Режим IMS, Полезно знать.

Как телефон находит ePDG​

Телефон ищет ePDG по имени в DNS. Имя строится из PLMN SIM:

epdg.epc.mnc<MNC>.mcc<MCC>.pub.3gppnetwork.org (MNC padded to three digits)
epdg.epc.mnc001.mcc001.pub.3gppnetwork.org (PLMN 001/01)
  • На iPhone имя строится из MCC и MNC SIM и не может быть изменено.
  • Публичной зоной pub.3gppnetwork.org управляет GSMA, и она отвечает только для сетей, подключённых через членство в GSMA и IPX. Частной или лабораторной сети в ней нет, поэтому на это имя нужно отвечать самостоятельно: запустите DNS-резолвер с локальной зоной для него и сделайте так, чтобы телефоны использовали этот резолвер.
  • Задайте id в конфигурации ePDG равным этому же имени и направьте имя на адрес ePDG (192.0.2.30).

Выберите резолвер, который у вас уже работает. Каждый пример отвечает на epdg.epc.mnc001.mcc001.pub.3gppnetwork.org адресом 192.0.2.30:

dnsmasq

address=/epdg.epc.mnc001.mcc001.pub.3gppnetwork.org/192.0.2.30

Unbound

server:
local-zone: "epdg.epc.mnc001.mcc001.pub.3gppnetwork.org." redirect
local-data: "epdg.epc.mnc001.mcc001.pub.3gppnetwork.org. 300 IN A 192.0.2.30"

BIND (named.conf, затем файл зоны)

zone "epdg.epc.mnc001.mcc001.pub.3gppnetwork.org" {
type master;
file "/etc/bind/db.epdg.mnc001.mcc001";
};
$TTL 300
@ IN SOA ns.example.net. admin.example.net. ( 1 3600 600 86400 300 )
IN NS ns.example.net.
IN A 192.0.2.30

Затем сделайте так, чтобы телефоны использовали этот резолвер. DHCP-сервер сети Wi-Fi выдаёт DNS-серверы подключающимся телефонам; задайте там адрес резолвера (для dnsmasq на том же узле: dhcp-option=option:dns-server,192.0.2.53) и проверьте, что телефон не использует для этого поиска частный DNS-сервис, VPN или резолвер сотовой сети. Проверьте с ноутбука в той же сети Wi-Fi: dig epdg.epc.mnc001.mcc001.pub.3gppnetwork.org должен вернуть 192.0.2.30.

На Android для тестовых устройств есть ещё два варианта:

  • Использовать то же переопределение DNS. Это работает без изменений на телефоне.
  • Задать адрес ePDG в конфигурации оператора с помощью ключей CarrierConfigManager.Iwlan (Android 12, уровень API 31 и выше):
    • KEY_EPDG_STATIC_ADDRESS_STRING (iwlan.epdg_static_address_string): IP-адрес или FQDN ePDG.
    • KEY_EPDG_ADDRESS_PRIORITY_INT_ARRAY (iwlan.epdg_address_priority_int_array): порядок, в котором перебираются источники адреса. EPDG_ADDRESS_STATIC равен 0, а EPDG_ADDRESS_PLMN равен 1; поставьте 0 первым, чтобы использовать статический адрес.
    • Сами звонки по Wi-Fi включаются ключом KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL.
    • Это ключи конфигурации оператора; обычное приложение изменить их не может. См. справочник Android.

Как телефон находит P-CSCF​

  • По LTE телефон узнаёт адрес P-CSCF от сети при установке сессии ims: Open5GS помещает адреса p-cscf из smf.yaml в установку сессии (шаг 3). DNS для этого не используется.
  • По Wi-Fi P-CSCF приходит от ePDG: он отправляет телефону адреса из [ims.epdg] pcscf в конфигурационной нагрузке IKEv2 вместе с внутренним адресом и DNS-серверами.

Если вы используете домен IMS (ims.mnc001.mcc001.3gppnetwork.org) как домен SIP, телефоны применяют его только внутри SIP-сообщений, отправляемых на выданный им адрес P-CSCF; для этой схемы он не обязан разрешаться в DNS.

Проверка VoWiFi​

  1. Включите звонки по Wi-Fi и подключитесь к сети Wi-Fi, использующей ваш резолвер.
  2. В консоли карточка Состояние показывает ePDG с его туннелями и выданными внутренними адресами.
  3. Мобильный аппарат регистрируется, как при VoLTE, и внутренний номер отображается как зарегистрированный.

Если включён сервер политик Rx, звонок по Wi-Fi запрашивает у PCRF Open5GS канал по адресу телефона в туннеле, которого PCRF не знает. PCRF отклоняет запрос, и звонок продолжается без выделенного канала.

Обычные причины, по которым туннель не поднимается: DNS-имя не разрешается в ePDG, UDP 500 или 4500 отфильтрован, имя сертификата не совпадает с id, либо политика доступа SIM — Только VoLTE. Карточка состояния описана на странице режима IMS.

Что дальше​