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

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

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

free5GC — ядро только для 5G. В нём нет LTE-подключения и PCRF, поэтому телефоны используют голос поверх NR (VoNR) в сети передачи данных ims, а необязательное QoS для звонков идёт через PCF (N5), а не через Diameter Rx.

:::info Справочная страница Это руководство — пошаговый разбор. Все настройки IMS описаны в разделе Режим IMS (VoLTE и VoWiFi). Используете Open5GS? См. IMS для частной сети на Open5GS. :::

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

data (internet DNN)
Phone ──NR── gNB ──┬──────────────────────────────────────▶ internet
(SIM) │
┌─────────▼────────────── free5GC ────────────────┐
│ AMF UPF (gtp5g) SMF UDM / UDR PCF │
└───────┬──────────────────────────────┬──────────┘
│ "ims" DNN │ N5 (HTTPS)
│ (own subnet) │ Npcf_PolicyAuthorization
┌───────▼──────────────────────────────▼──────────┐
│ MonoPbx │
│ P-CSCF + S-CSCF + registrar │
│ SIP 5060, built-in subscriber data (HSS/UDM │
│ role), rtpengine for media, extensions, SMS │
└───────▲─────────────────────────────────────────┘
│ IKEv2 / ESP, UDP 500 and 4500 (optional)
Phone ──Wi-Fi── internet ePDG (VoWiFi)

Как это работает вместе:

  • Телефон регистрируется в ядре 5G и открывает вторую PDU-сессию в DNN ims. free5GC выдаёт этой сессии собственный диапазон адресов и, если телефон запрашивает, адрес P-CSCF. Этот адрес — MonoPbx.
  • Телефон отправляет SIP REGISTER на MonoPbx по сессии ims. MonoPbx запрашивает аутентификацию по IMS-AKA и проверяет ответ ключом SIM-карты, поэтому MonoPbx нужны те же IMSI, K и OPc, что и у абонента в free5GC. Для этого MonoPbx не обращается к UDM free5GC.
  • N5 (необязательно): для каждого звонка MonoPbx запрашивает у PCF free5GC поток QoS для голосового потока. Без него звонки идут по потоку QoS по умолчанию сессии ims.
  • VoWiFi (необязательно): телефон строит туннель IKEv2 до ePDG MonoPbx через любую сеть Wi-Fi. free5GC в этом не участвует.

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

Что нужноПримечания
free5GCРаботающая сеть 5G SA, в которой телефон уже регистрируется и имеет интернет в DNN internet. Приведённые ниже ключи конфигурации проверены по примерам файлов free5GC v4.3.0 и текущим исходным кодам SMF, PCF и WebConsole. См. руководство по установке free5GC.
SIM-карты, которые можно программироватьНужно знать IMSI, K и OPc (или OP) каждой SIM. В free5GC и MonoPbx значения должны совпадать. В руководстве используется тестовая PLMN из примера free5GC 208/93; везде замените её на свою.
ТелефоныТелефоны с поддержкой голоса поверх NR (VoNR) в вашей PLMN. Это жёсткое требование ядра только для 5G: если телефон не умеет VoNR, звонки по IMS в этой сети невозможны (см. шаг 6).
Хост MonoPbxLinux, доступный с UPF free5GC по фиксированному IP-адресу. Шаг 1 ссылается на руководства по установке.
СетьМаршрут из подсети UE ims до хоста MonoPbx и обратно (см. шаг 3) и отсутствие NAT между UPF и MonoPbx.
Ваши именаRealm IMS строится из PLMN: ims.mnc<MNC>.mcc<MCC>.3gppnetwork.org, где MNC дополняется нулями до трёх цифр. Для PLMN 208/93: ims.mnc093.mcc208.3gppnetwork.org. Телефоны строят его по SIM; регистрировать его в публичном DNS не нужно.

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

ИмяПример
Хост MonoPbx (P-CSCF)192.0.2.10
Хост free5GC (SMF, UPF, PCF)192.0.2.20
Подсеть UE internet10.60.0.0/16
Подсеть UE ims10.62.0.0/16
Адрес ePDG (VoWiFi)192.0.2.30
PCF, как его видит MonoPbx (через HTTPS-фронт из шага 5)https://pcf.example.net:8443

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

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

Откройте эти порты для пользовательской плоскости free5GC (подсеть UE ims): UDP и TCP 5060 (SIP) и диапазон RTP для rtpengine. Полный список — в разделе Требования к сети.

:::tip Куда телефоны отправляют SIP Телефоны отправляют SIP на адрес P-CSCF, который выдаёт им free5GC. Используйте реальный адрес хоста (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)208Ваша PLMN
Код сети (MNC)93Ваша PLMN. 2 или 3 цифры
Домашний домен IMSims.mnc093.mcc208.3gppnetwork.orgRealm, который телефоны выводят из SIM
Источник данных абонентовЭта установка (встроенный)См. шаг 4
Алгоритм по умолчанию для новых абонентовMilenageТо, что использует free5GC (WebConsole предлагает OPc и OP)
Защищать регистрации с помощью IPsecВыключено для этого первого тестаСм. примечание ниже
Разрешить голос по Wi-FiВыключено до необязательного раздела про VoWiFi

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

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

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

Телефонам нужна вторая PDU-сессия в DNN ims с собственным диапазоном адресов и адресом P-CSCF при установлении сессии. Одно и то же имя DNN должно присутствовать в конфигурации AMF, SMF и UPF и у абонента. В примерах показано только то, что вы добавляете; остальное в каждом примере файла сохраните.

AMF: разрешите DNN и объявите голос поверх PS​

В config/amfcfg.yaml:

configuration:
supportDnnList:
- internet
- ims
nasIE:
networkFeatureSupport5GS:
enable: true
imsVoPS: 1 # IMS voice over PS session supported; the sample file has 0

imsVoPS — это «индикатор поддержки голоса IMS поверх PS-сессии» из информационного элемента поддержки функций сети 5GS (TS 24.501). В примере файла он равен 0. Телефон начинает голос поверх NR, только если сеть сообщает о поддержке голоса IMS поверх PS, поэтому задайте 1.

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

В config/smfcfg.yaml добавьте ims в каждый S-NSSAI, который несёт голос, с его DNS и P-CSCF (ключ pcscf находится рядом с dns), и задайте для UPF пул и интерфейс. Это структура примера файла; новые части — записи ims:

configuration:
snssaiInfos:
- sNssai:
sst: 1
sd: 010203
dnnInfos:
- dnn: internet
dns:
ipv4: 8.8.8.8
ipv6: 2001:4860:4860::8888
- dnn: ims
dns:
ipv4: 8.8.8.8
ipv6: 2001:4860:4860::8888
pcscf:
ipv4: 192.0.2.10

userplaneInformation:
upNodes:
UPF:
type: UPF
nodeID: 127.0.0.8
addr: 127.0.0.8
sNssaiUpfInfos:
- sNssai:
sst: 1
sd: 010203
dnnUpfInfoList:
- dnn: internet
pools:
- cidr: 10.60.0.0/16
- dnn: ims
pools:
- cidr: 10.62.0.0/16
interfaces:
- interfaceType: N3
endpoints:
- 127.0.0.8
networkInstances:
- internet
- ims

pcscf: ipv4: читается SMF для каждого DNN и возвращается телефону, который запрашивает адрес P-CSCF в своём запросе PDU-сессии (расширенные параметры конфигурации протокола). Поддерживается только IPv4. Повторите записи ims для каждого S-NSSAI, который используют ваши SIM (в примере файла есть второй, 112233, со своим пулом).

UPF: пул адресов​

В config/upfcfg.yaml добавьте пул рядом с пулом internet:

dnnList:
- dnn: internet
cidr: 10.60.0.0/16
ipForwardEnable: true
- dnn: ims
cidr: 10.62.0.0/16
ipForwardEnable: true

Значения cidr должны совпадать с pools в SMF.

Маршрутизация и межсетевой экран​

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

  • Если MonoPbx находится на другом хосте, добавьте на нём (или на используемом им маршрутизаторе) обратный маршрут: sudo ip route add 10.62.0.0/16 via 192.0.2.20
  • Не применяйте NAT к подсети ims в сторону MonoPbx. Руководство по установке free5GC маскирует трафик, уходящий через интерфейс сети передачи данных (iptables -t nat -A POSTROUTING -o <dn_interface> -j MASQUERADE). Если MonoPbx доступен через этот интерфейс, ограничьте правило пулом интернета, например -s 10.60.0.0/16, чтобы SIP и медиа из 10.62.0.0/16 сохраняли реальный адрес. PCF находит сессию телефона по этому адресу.
  • Оставьте включённой пересылку (sudo sysctl -w net.ipv4.ip_forward=1) и разрешите 10.62.0.0/16 доступ к 192.0.2.10 по UDP/TCP 5060 и в диапазоне rtpengine на любом межсетевом экране между ними.

Перезапустите free5GC, чтобы все сетевые функции прочитали новые файлы.

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

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

В WebConsole free5GC​

Откройте WebConsole по адресу http://<WebConsole host>:5000 (логин по умолчанию из readme WebConsole — admin / free5gc; смените его), затем Subscribers и создайте абонента:

Поле WebConsoleЗначение
SUPI (IMSI)imsi-208930000000001, IMSI SIM-карты
PLMN ID20893
GPSI (MSISDN)необязательно, номер телефона
Authentication Management Field (AMF)8000 (по умолчанию)
Operator Code Type / ValueOPc (или OP) и его значение
Permanent Authentication KeyK SIM-карты
SQNоставьте значение по умолчанию

Для слайса (SST 1, SD 010203) настройте две сети передачи данных:

Data Network NameDefault 5QIПримечания
internet9Session AMBR по необходимости
ims5Стандартный 5QI для сигнализации IMS; задайте Session AMBR, например 1 Мбит/с в обе стороны

Сохраните. S-NSSAI абонента должен поддерживаться вашими AMF и SMF (шаг 3).

В MonoPbx​

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

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

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

:::info Где хранятся ключи Ключи вводятся дважды, потому что free5GC аутентифицирует регистрацию 5G (его UDM), а MonoPbx — регистрацию IMS. Им не нужно обмениваться данными друг с другом. MonoPbx ведёт собственный порядковый номер для каждой SIM, поэтому первая регистрация может потребовать один лишний обмен, пока SIM и MonoPbx согласуют его. Это нормально.

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

Шаг 5. Управление политиками по N5 (необязательно)​

Этот шаг необязателен. Он запрашивает у PCF поток QoS для голосового потока каждого звонка. Если его пропустить, звонки идут по потоку QoS по умолчанию сессии ims, чего достаточно для первого теста. Регистрация, звонки и SMS от него не зависят.

Что поддерживает free5GC​

PCF free5GC указывает npcf-policyauthorization в своём serviceList. По текущим исходным кодам PCF он принимает от AF запрос на создание сессии приложения, находит PDU-сессию по IPv4- или IPv6-адресу телефона, превращает каждый аудиокомпонент медиа в правило PCC с 5QI 1 и сообщает SMF, который затем устанавливает поток QoS. Он также поддерживает событие уведомления о QoS. MonoPbx отправляет адрес телефона, аудиопотоки и нужные ему события, так что на бумаге они совместимы. Будет ли поток QoS проходить сквозным образом на вашем UPF, зависит от версий free5GC и gtp5g; проверьте это по контрольному списку.

Доступ к PCF по HTTPS​

Клиент N5 в MonoPbx принимает адрес PCF с https:// (обычный http:// — только для localhost и 127.0.0.1). SBI в примере free5GC использует scheme: http. Выберите один из вариантов:

  • поставьте перед PCF обратный прокси с терминацией TLS (на хосте MonoPbx или free5GC), который слушает https://pcf.example.net:8443 и пересылает на bindingIPv4:port PCF из pcfcfg.yaml (127.0.0.7:8000 в примере), общаясь с ним по HTTP/2 в открытом виде, как это делают сетевые функции free5GC; либо
  • переведите SBI free5GC на HTTPS, как описано в документации по конфигурации free5GC.

Используйте сертификат, которому MonoPbx доверяет (публичный УЦ или ваш УЦ, указанный в настройках). Не открывайте PCF никому, кроме MonoPbx.

Настройки MonoPbx​

В разделе Мобильная сеть (VoLTE / VoNR), Diameter и политики, в блоке Управление политиками (выделенные каналы):

Поле консолиЗначение
Сервер политикPCF по HTTP (N5)
Базовый URL PCFhttps://pcf.example.net:8443
Аутентификация PCFНет (в примере PCF нет OAuth2 на SBI) или Статический токен доступа, если его требует ваш фронт
Сети-источники PCF (необязательно)адрес, с которого PCF или ваш прокси отправляет уведомления, в виде блока CIDR
URL NRF (необязательно)оставьте пустым

Сохраните, затем перезапустите движок MonoPbx, чтобы он прочитал настройки политик (они читаются при запуске движков): docker compose -f compose.yaml -f compose.linux.yaml -f compose.ims.yaml restart mpbx-sip-engine в Linux-комплекте Compose или перезапустите сервис mpbx при однопроцессной установке. Аутентификация клиентским сертификатом (mTLS) в PCF недоступна; используйте «Нет» или токен доступа.

MonoPbx помещает в каждый запрос адрес уведомлений https://<base domain>/api/v1/ims/n5/notify/<token>, где <base domain> — это http.base_domain АТС. PCF отправляет туда события QoS, поэтому хост PCF должен достигать этого HTTPS-адреса и доверять его сертификату. Если это невозможно, звонки продолжают работать, но MonoPbx не узнаёт о потере потока QoS.

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

free5GC предоставляет только 5G, поэтому телефон совершает звонки по IMS с голосом поверх NR.

  1. Вставьте запрограммированную SIM. Телефон должен зарегистрироваться в вашей PLMN (208/93) в режиме 5G standalone и иметь данные в DNN internet.
  2. Добавьте APN для IMS: имя ims, APN ims, тип ims. Имя должно совпадать с DNN, созданным в free5GC.
  3. Включите VoNR и звонки VoLTE/IMS.
    • Телефоны используют VoNR только там, где это разрешает конфигурация оператора для PLMN SIM, а у лабораторной PLMN её нет. Если телефон не умеет VoNR в вашей PLMN, звонки по IMS здесь невозможны. Проверьте, что поддерживает ваше устройство.
    • Android: решает конфигурация оператора. Соответствующие ключи в CarrierConfigManager: KEY_CARRIER_VOLTE_AVAILABLE_BOOL (carrier_volte_available_bool) для звонков по IMS, KEY_VONR_ENABLED_BOOL (vonr_enabled_bool) и KEY_VONR_SETTING_VISIBILITY_BOOL (vonr_setting_visibility_bool) для голоса поверх NR, KEY_VONR_ON_BY_DEFAULT_BOOL (vonr_on_by_default_bool) для включения по умолчанию, KEY_CARRIER_NR_AVAILABILITIES_INT_ARRAY (carrier_nr_availabilities_int_array) для режимов 5G, которые поддерживает оператор, и KEY_CARRIER_WFC_IMS_AVAILABLE_BOOL (carrier_wfc_ims_available_bool) для звонков по Wi-Fi. Их можно задать с помощью приложения с привилегиями оператора (SIM с правилами привилегий оператора) или инженерными средствами устройства. См. справочник Android.
    • iPhone: голос поверх NR, VoLTE и звонки по Wi-Fi включаются профилем оператора, установленным для SIM, поэтому лабораторной SIM нужен профиль, который их разрешает. Спросите у поставщика SIM, какие устройства он проверял.
  4. Если телефон запрашивает адрес SMSC, задайте тот, который вы указали в MonoPbx (шаг 7).
  5. Включите и выключите режим полёта, чтобы телефон зарегистрировался заново и построил PDU-сессию ims.

Телефон должен использовать адрес P-CSCF, который вернул SMF (pcscf: ipv4:, здесь 192.0.2.10). На многих телефонах его можно прочитать в журнале модема или IMS. Если телефон не запрашивает адрес P-CSCF в своём запросе PDU-сессии, SMF его не отправляет: тогда некоторым устройствам нужен статический P-CSCF в конфигурации оператора.

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

Звонки.

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

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

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

SMS.

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

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

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

  • Телефон зарегистрировался в ядре 5G и имеет интернет в DNN internet (в журналах AMF и SMF видны регистрация и сессия).
  • Существует вторая PDU-сессия для DNN ims с адресом из 10.62.0.0/16.
  • С адреса ims телефона SIP-порт MonoPbx отвечает: проверьте на хосте MonoPbx, что SIP из 10.62.x.x доходит (sudo tcpdump -ni any udp port 5060).
  • На REGISTER телефона приходит 401, а затем 200 OK. При уровне журнала движка debug MonoPbx указывает причину отказа для 403 (но не ключи).
  • В консоли внутренний номер SIM отображается как зарегистрированный.
  • Только N5: совершите звонок, затем найдите в журнале PCF запрос сессии приложения («App Session Id ... Create»), а в журнале SMF — поток QoS. После звонка сессия удаляется.
  • В звонке в каждую сторону звук слышен в обоих направлениях.
  • Сообщение с телефона доходит до адресата, а сообщение на номер SIM доходит до телефона.

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

СимптомВероятная причинаЧто проверить
Телефон регистрируется, но PDU-сессии ims нетDNN отсутствует в телефоне, у абонента, в supportDnnList AMF, в SMF или в UPFAPN ims на телефоне совпадает точно; у абонента есть сеть передачи данных ims; ims есть в supportDnnList, в dnnInfos, dnnUpfInfoList и networkInstances SMF и в dnnList UPF; free5GC перезапущен
Телефон никогда не начинает голос поверх NRСеть не объявляет голос IMS поверх PS, или у телефона нет VoNR для этой PLMNimsVoPS: 1 в amfcfg.yaml; конфигурация оператора телефона (шаг 6)
У телефона есть сессия ims, но он не регистрируетсяАдрес P-CSCF не выданpcscf: ipv4: задан для DNN ims в каждом S-NSSAI, который использует SIM, и SMF перезапущен; телефон запрашивает адрес P-CSCF в запросе PDU-сессии
REGISTER не доходит до MonoPbxМаршрутизация, межсетевой экран или NATОбратный маршрут в 10.62.0.0/16; порты 5060 UDP/TCP открыты; правило маскарадинга не охватывает подсеть ims
REGISTER раз за разом получает 401K или OPc различаются в free5GC и MonoPbx, или телефон отвергает сетьЗаново введите K и OPc в MonoPbx через Заменить ключи; проверьте, что AMF равен 8000 с обеих сторон. Если порядковый номер SIM впереди, MonoPbx синхронизируется сам; бесконечный 401 означает несовпадение ключей
REGISTER получает 403Абонент приостановлен или не привязан к включённому внутреннему номеру активного пользователя; политика доступа не разрешает доступ; идентификатор To не входит в публичные идентификаторы SIM; IPsec требуется, но не настроенСтраница абонента; для SIM, добавленной в старой версии, добавьте sip:<IMSI>@ims.mnc093.mcc208.3gppnetwork.org как IMPU; настройка IPsec
REGISTER получает 500 с Retry-AfterБэкенд данных абонентов недоступенВ этом руководстве режим — Эта установка (встроенный); другой бэкенд должен быть доступен
Телефон регистрируется, но звонок не вызывает внутренний номерSIM привязана к другому внутреннему номеру, или внутренний номер отключёнПривязка абонента; состояние внутреннего номера
Звонки соединяются с односторонним звуком или без звукаUPF не достигает rtpengine, или rtpengine объявляет адрес, недоступный из подсети imsМаршрутизация из 10.62.0.0/16 до адреса rtpengine и диапазона RTP; RTPE_ADVERTISE; межсетевой экран; затем проверьте Мобильные кодеки, если звонок между телефоном и транком беззвучен
Запросы N5 завершаются ошибкойPCF недоступен по HTTPS, сертификат не доверенный или у PCF нет сессии для адреса телефонаБазовый URL и сертификат PCF; адрес телефона в том виде, как его видит MonoPbx, не транслируется; в журнале PCF — «Session Binding failed»; звонок продолжается по потоку QoS по умолчанию
N5 работает, но MonoPbx не узнаёт о потере потока QoSPCF не достигает https://<base domain>/api/v1/ims/n5/notify/...http.base_domain, сертификат и Сети-источники PCF

Дополнительно: VoWiFi (звонки по Wi-Fi) через ePDG​

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

Запустите 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.mnc093.mcc208.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 по собственному хранилищу доверия, поэтому для частной сети используйте сертификат публичного УЦ или установите свой УЦ на тестовые телефоны. Затем включите Разрешить голос по 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.mnc093.mcc208.pub.3gppnetwork.org (PLMN 208/93)
  • На iPhone имя выводится из MCC и MNC SIM и не может быть изменено.
  • Публичная зона pub.3gppnetwork.org управляется через GSMA и отвечает только для сетей, подключённых через членство в GSMA и IPX. Частной или лабораторной сети в ней нет, поэтому это имя нужно обслуживать самим: запустите DNS-резолвер с локальной зоной для него и сделайте так, чтобы телефоны использовали этот резолвер.
  • Задайте id в конфигурации ePDG равным этому же имени и направьте имя на адрес ePDG (192.0.2.30).

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

dnsmasq

address=/epdg.epc.mnc093.mcc208.pub.3gppnetwork.org/192.0.2.30

Unbound

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

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

zone "epdg.epc.mnc093.mcc208.pub.3gppnetwork.org" {
type master;
file "/etc/bind/db.epdg.mnc093.mcc208";
};
$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.mnc093.mcc208.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​

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

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

Проверьте VoWiFi​

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

Если включён сервер политик N5, звонок по Wi-Fi запрашивает у PCF free5GC поток QoS по адресу туннеля телефона, который PCF не знает. Запрос отклоняется, и звонок продолжается без выделенного потока QoS.

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

Что дальше​