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-соединение на APNims(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). |
| Хост MonoPbx | Linux, доступный из пользовательской плоскости 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 internet | 10.45.0.0/16 |
Подсеть UE ims | 10.46.0.0/16 |
| Адрес ePDG (VoWiFi) | 192.0.2.30 |
| Идентификатор Diameter MonoPbx | mpbx.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 цифры |
| Домашний домен IMS | ims.mnc001.mcc001.3gppnetwork.org | Realm, который телефоны строят по 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 | Значение |
|---|---|
| IMSI | 001010000000001 (IMSI этой SIM) |
| Subscriber Key (K) | ключ K этой SIM |
| USIM Type / Operator Key | OPc (или OP) и его значение |
| Authentication Management Field (AMF) | 8000 (по умолчанию) |
| MSISDN | необязательно, номер телефона |
В Slice Configurations, Session Configurations добавьте две сессии:
| DNN/APN | Тип | 5QI/QCI | ARP Priority Level | Capability | Vulnerability |
|---|---|---|---|---|---|
internet | IPv4 | 9 | 8 | Disabled | Disabled |
ims | IPv4 | 5 | 1 | Disabled | Disabled |
Значения взяты из руководства 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
- Откройте Мобильная сеть (VoLTE / VoNR), Абоненты IMS, Добавить абонента.
- Введите IMSI, ключ абонента K и ключ оператора (OPc или OP; MonoPbx один раз преобразует его и не хранит). Оставьте Разрешённый доступ равным VoLTE и VoWiFi, а IPsec — Как в настройках установки.
- Выберите Внутренний номер, которому принадлежит эта SIM. SIM регистрируется только на включённый внутренний номер активного пользователя.
- 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):
- В разделе Управление политиками (выделенные каналы) установите Сервер политик в значение PCRF по Diameter Rx.
- Задайте Наш Origin-Host Diameter —
mpbx.ims.mnc001.mcc001.3gppnetwork.orgи Наш Origin-Realm Diameter —ims.mnc001.mcc001.3gppnetwork.org. - В разделе Узлы 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 секунд |
| Используется | включено |
- Сохраните, затем перезапустите движок 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. Телефоны
- Вставьте запрограммированную SIM. Телефон должен подключиться к вашей PLMN (
001/01) и иметь данные на APNinternet. - Добавьте APN IMS: имя
ims, APNims, типims(на некоторых телефонах тип называется «IMS» и отделён от APN данных по умолчанию). Имя APN должно совпадать с DNN, созданным в Open5GS. - Включите 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, какие аппараты он проверял.
- Если телефон запрашивает адрес SMSC, укажите тот, который вы задали в MonoPbx (шаг 7).
- Включите и выключите режим полёта, чтобы телефон подключился заново и построил сессию
ims. После регистрации телефон должен показать индикатор VoLTE или HD Voice.
Если SMF вернул адрес P-CSCF, телефон будет его использовать. На многих телефонах его можно прочитать в журнале модема или IMS; он должен быть 192.0.2.10.
Шаг 7. Первый звонок и SMS
Звонки.
- В консоли откройте Абоненты IMS и проверьте, что абонент этой SIM Действует.
- После регистрации телефона (см. контрольный список) позвоните на внутренний номер SIM со стационарного телефона или софтфона, зарегистрированного в MonoPbx. Телефон звонит.
- Позвоните с мобильного аппарата на другой внутренний номер.
- Наберите с мобильного аппарата внешний номер, чтобы проверить транк и исходящие правила, как для любого внутреннего номера.
Медиа проходит через rtpengine, поэтому адрес rtpengine, который объявляет MonoPbx, должен быть доступен из подсети ims.
:::info Звонки на другие типы телефонов Аппарат VoLTE использует AMR-WB или AMR; стационарные телефоны и транки используют G.711. Звонки между мобильными аппаратами не требуют преобразования. Для звонков между мобильным аппаратом и чем-либо ещё включите в настройках Мобильные кодеки для VoLTE и VoWiFi (AMR-WB, AMR) и используйте rtpengine, умеющий кодировать AMR. Сначала прочтите примечание о лицензии у этой настройки; лицензии на кодеки AMR и EVS — ваша ответственность. См. Режим IMS. :::
SMS.
- В настройках IMS задайте Адрес SMSC (номер E.164, хост или URI SIP, например
+10000000000) и убедитесь, что у компании есть служба SMS с номером для пользователя. - Отправьте сообщение с мобильного аппарата. MonoPbx принимает его, отправляет через службу SMS компании с одного из номеров пользователя и возвращает отчёт о доставке на телефон.
- Сообщение, которое компания получает на номер, направленный на пользователя или внутренний номер 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 снова и снова получает 401 | K или 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
- Включите звонки по Wi-Fi и подключитесь к сети Wi-Fi, использующей ваш резолвер.
- В консоли карточка Состояние показывает ePDG с его туннелями и выданными внутренними адресами.
- Мобильный аппарат регистрируется, как при VoLTE, и внутренний номер отображается как зарегистрированный.
Если включён сервер политик Rx, звонок по Wi-Fi запрашивает у PCRF Open5GS канал по адресу телефона в туннеле, которого PCRF не знает. PCRF отклоняет запрос, и звонок продолжается без выделенного канала.
Обычные причины, по которым туннель не поднимается: DNS-имя не разрешается в ePDG, UDP 500 или 4500 отфильтрован, имя сертификата не совпадает с id, либо политика доступа SIM — Только VoLTE. Карточка состояния описана на странице режима IMS.
Что дальше
- Режим IMS (VoLTE и VoWiFi): все настройки, карточка состояния и коды ошибок.
- IMS для частной сети 5G с free5GC: та же настройка для ядра free5GC.
- Требования к сети: все порты.
- SMS и обмен сообщениями: служба SMS, передающая сообщения от мобильных аппаратов и к ним.