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). |
| Хост MonoPbx | Linux, доступный с 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 internet | 10.60.0.0/16 |
Подсеть UE ims | 10.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 цифры |
| Домашний домен IMS | ims.mnc093.mcc208.3gppnetwork.org | Realm, который телефоны выводят из 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 ID | 20893 |
| GPSI (MSISDN) | необязательно, номер телефона |
| Authentication Management Field (AMF) | 8000 (по умолчанию) |
| Operator Code Type / Value | OPc (или OP) и его значение |
| Permanent Authentication Key | K SIM-карты |
| SQN | оставьте значение по умолчанию |
Для слайса (SST 1, SD 010203) настройте две сети передачи данных:
| Data Network Name | Default 5QI | Примечания |
|---|---|---|
internet | 9 | Session AMBR по необходимости |
ims | 5 | Стандартный 5QI для сигнализации IMS; задайте Session AMBR, например 1 Мбит/с в обе стороны |
Сохраните. S-NSSAI абонента должен поддерживаться вашими AMF и SMF (шаг 3).
В MonoPbx
- Откройте Мобильная сеть (VoLTE / VoNR), Абоненты IMS, Добавить абонента.
- Введите IMSI (
208930000000001, без префиксаimsi-), ключ абонента K и ключ оператора (OPc или OP; MonoPbx преобразует его один раз и не хранит). Оставьте Разрешённый доступ — VoLTE и VoWiFi, а IPsec — Как в настройках установки. - Выберите Внутренний номер, к которому относится эта SIM. SIM регистрируется только на включённом внутреннем номере активного пользователя.
- 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:portPCF из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 PCF | https://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.
- Вставьте запрограммированную SIM. Телефон должен зарегистрироваться в вашей PLMN (
208/93) в режиме 5G standalone и иметь данные в DNNinternet. - Добавьте APN для IMS: имя
ims, APNims, типims. Имя должно совпадать с DNN, созданным в free5GC. - Включите 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, какие устройства он проверял.
- Если телефон запрашивает адрес SMSC, задайте тот, который вы указали в MonoPbx (шаг 7).
- Включите и выключите режим полёта, чтобы телефон зарегистрировался заново и построил PDU-сессию
ims.
Телефон должен использовать адрес P-CSCF, который вернул SMF (pcscf: ipv4:, здесь 192.0.2.10). На многих телефонах его можно прочитать в журнале модема или IMS. Если телефон не запрашивает адрес P-CSCF в своём запросе PDU-сессии, SMF его не отправляет: тогда некоторым устройствам нужен статический P-CSCF в конфигурации оператора.
Шаг 7. Первый звонок и SMS
Звонки.
- В консоли откройте Абоненты IMS и убедитесь, что абонент этой SIM имеет статус Активен.
- После регистрации телефона (см. контрольный список) позвоните на внутренний номер SIM с настольного телефона или софтфона, зарегистрированного на MonoPbx. Телефон звонит.
- Позвоните с телефона на другой внутренний номер.
- Наберите с телефона внешний номер, чтобы проверить транк и правила исходящих звонков, как для любого внутреннего номера.
Медиа проходит через rtpengine, поэтому адрес rtpengine, который объявляет MonoPbx, должен быть доступен из подсети ims.
:::info Звонки на другие виды телефонов Телефон IMS работает с AMR-WB или AMR; настольные телефоны и транки — с G.711. Звонки между телефонами IMS не требуют преобразования. Для звонков между таким телефоном и чем-либо ещё включите в настройках Мобильные кодеки для VoLTE и VoWiFi (AMR-WB, AMR) и используйте rtpengine, умеющий кодировать AMR. Сначала прочитайте замечание о лицензии у этой настройки; лицензии на кодеки AMR и EVS — ваша ответственность. См. Режим IMS. :::
SMS.
- В настройках IMS задайте адрес SMSC (номер E.164, хост или SIP URI, например
+10000000000) и убедитесь, что у компании есть служба SMS с номером для пользователя. - Отправьте сообщение с телефона. MonoPbx принимает его, отправляет через службу SMS компании с одного из номеров пользователя и возвращает отчёт о доставке на телефон.
- Сообщение, которое компания получает на номер, маршрутизируемый на пользователя или внутренний номер 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 или в UPF | APN ims на телефоне совпадает точно; у абонента есть сеть передачи данных ims; ims есть в supportDnnList, в dnnInfos, dnnUpfInfoList и networkInstances SMF и в dnnList UPF; free5GC перезапущен |
| Телефон никогда не начинает голос поверх NR | Сеть не объявляет голос IMS поверх PS, или у телефона нет VoNR для этой PLMN | imsVoPS: 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 раз за разом получает 401 | K или 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 не узнаёт о потере потока QoS | PCF не достигает 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
- Включите звонки по Wi-Fi и подключитесь к сети Wi-Fi, которая использует ваш резолвер.
- В консоли карточка Состояние показывает ePDG с его туннелями и выданными внутренними адресами.
- Телефон регистрируется так же, как для VoLTE, и внутренний номер отображается как зарегистрированный.
Если включён сервер политик N5, звонок по Wi-Fi запрашивает у PCF free5GC поток QoS по адресу туннеля телефона, который PCF не знает. Запрос отклоняется, и звонок продолжается без выделенного потока QoS.
Обычные причины, когда туннель не поднимается: DNS-имя не разрешается в ePDG, UDP 500 или 4500 фильтруется, имя в сертификате не совпадает с id, или политика доступа SIM — Только VoLTE. Карточка «Состояние» описана на странице режима IMS.
Что дальше
- Режим IMS (VoLTE и VoWiFi): все настройки, карточка состояния и коды ошибок.
- IMS для частной сети на Open5GS: та же настройка для ядра Open5GS, с Diameter Rx для LTE.
- Требования к сети: все порты.
- SMS и обмен сообщениями: служба SMS, которая передаёт сообщения с телефонов и на них.