Как получить IP-адрес в 1С: рабочие способы и примеры кода

Задача получить IP-адрес компьютера или сервера из кода 1С встречается чаще, чем кажется: идентификация рабочего места в логах, привязка лицензий самописных подсистем, проверка сетевого окружения перед обменом данными, диагностика подключения к базе. При этом встроенного оператора вроде «ПолучитьIPАдрес()» во встроенном языке 1С нет — платформа такой функции не предоставляет.

Поэтому адрес получают обходными путями: через COM-объекты Windows, вызов командной строки или PowerShell, обращение к внешним веб-сервисам либо через сторонние компоненты. У каждого способа есть ограничения: часть работает только на клиенте под Windows, часть требует прав на выполнение внешних приложений, а внешние сервисы возвращают не локальный, а публичный адрес.

Ниже разобраны основные варианты с готовым кодом, указано, где каждый из них работает (тонкий и толстый клиент, сервер 1С, Linux), и какие ошибки встречаются чаще всего.

Почему в 1С нет штатной функции получения IP

Платформа 1С:Предприятие абстрагирует разработчика от операционной системы: один и тот же код должен работать на Windows и Linux, на клиенте и на сервере. Сетевые интерфейсы, их имена и способы опроса в разных ОС устроены по-разному, поэтому прямой доступ к сетевым настройкам во встроенный язык не включён.

Дополнительно действует модель безопасности: тонкий и веб-клиент работают в ограниченной среде, где запуск внешних приложений и COM-объектов либо запрещён, либо требует явного разрешения пользователя. Это значит, что универсального кода «на все случаи» не существует — способ нужно выбирать под контекст исполнения.

Ещё один нюанс: у компьютера обычно несколько сетевых интерфейсов (Ethernet, Wi-Fi, VPN, виртуальные адаптеры гипервизоров). Запрос «дай мне IP-адрес» без уточнения, какого именно интерфейса, может вернуть не тот адрес, который ожидался.

Способ 1. Получить локальный IP через WMI (COM-объект)

Самый распространённый вариант для толстого клиента и сервера 1С под Windows — запрос к WMI через COM-объект WbemScripting.SWbemLocator. WMI возвращает структурированные данные по всем сетевым адаптерам, и можно отфильтровать только активные интерфейсы с включённым IP.

Пример кода:

Функция ПолучитьЛокальныеIP()
Результат = Новый Массив;
Локатор = Новый COMОбъект("WbemScripting.SWbemLocator");
Сервис = Локатор.ConnectServer(".", "root\cimv2");
Запрос = "SELECT IPAddress, Description FROM Win32_NetworkAdapterConfiguration WHERE IPEnabled = True";
Адаптеры = Сервис.ExecQuery(Запрос);
Для Каждого Адаптер Из Адаптеры Цикл
Если Адаптер.IPAddress <> Null Тогда
Для Каждого Адрес Из Адаптер.IPAddress Цикл
Результат.Добавить(Адрес);
КонецЦикла;
КонецЕсли;
КонецЦикла;
Возврат Результат;
КонецФункции

Обратите внимание: функция возвращает массив, а не одну строку, потому что адаптеров с включённым IP может быть несколько. Если нужен «основной» адрес, обычно берут первый IPv4-адрес (формат с точками, без двоеточий) или фильтруют по имени адаптера.

Локатор = Новый COMОбъект("WbemScripting.SWbemLocator");
Сервис = Локатор.ConnectServer(".", "root\cimv2");
Адаптеры = Сервис.ExecQuery("SELECT IPAddress FROM Win32_NetworkAdapterConfiguration WHERE IPEnabled = True");

Ограничения способа: работает только под Windows; в тонком клиенте COM-объекты недоступны; на сервере 1С код выполняется в контексте учётной записи службы агента сервера, у которой должны быть права на запросы WMI (обычно они есть, но при ужесточённых политиках безопасности запрос может быть заблокирован).

Способ 2. Через командную строку: ipconfig и PowerShell

Если COM по какой-то причине недоступен, можно запустить системную утилиту и разобрать её вывод. В Windows это ipconfig, в Linux — hostname -I или ip addr. В 1С для этого используется объект WScript.Shell (опять же Windows) либо команда ЗапуститьПриложение / НачатьЗапускПриложения с перенаправлением вывода в файл.

Пример с чтением вывода через временный файл:

Процедура ПолучитьIPЧерезIpconfig()
ИмяФайла = ПолучитьИмяВременногоФайла("txt");
СтрокаКоманды = "cmd /c ipconfig > """ + ИмяФайла + """";
ЗапуститьПриложение(СтрокаКоманды, , Истина);
Текст = Новый ЧтениеТекста(ИмяФайла, КодировкаТекста.OEM);
Вывод = Текст.Прочитать();
Текст.Закрыть();
// далее разбор строки по шаблону "IPv4-адрес" или "IPv4 Address"
КонецПроцедуры

Разбор текстового вывода — слабое место метода: формат зависит от языка системы (в русской Windows строка называется «IPv4-адрес», в английской — «IPv4 Address»), а в Linux вывод ip addr требует аккуратного парсинга. Для Linux надёжнее команда hostname -I, которая выводит адреса через пробел без лишнего текста.

PowerShell даёт более предсказуемый результат: команда (Get-NetIPAddress -AddressFamily IPv4).IPAddress выводит только адреса, по одному на строку. Минус — на старых системах PowerShell может отсутствовать или запускаться заметно дольше, чем чистый COM-запрос.

Способ 3. Узнать внешний IP через HTTP-запрос

Если нужен адрес, под которым компьютер виден в интернете (например, для настройки доступа к веб-сервисам или проверки VPN), локальные методы не помогут — они вернут внутренний адрес за NAT. Внешний IP получают HTTP-запросом к публичному сервису, который возвращает адрес клиента.

Функция ПолучитьВнешнийIP()
Соединение = Новый HTTPСоединение("api.ipify.org", 443, , , , 10,
Новый ЗащищенноеСоединениеOpenSSL());
Запрос = Новый HTTPЗапрос("/");
Ответ = Соединение.Получить(Запрос);
Если Ответ.КодСостояния = 200 Тогда
Возврат СокрЛП(Ответ.ПолучитьТелоКакСтроку());
КонецЕсли;
Возврат "";
КонецФункции

Таких сервисов несколько (api.ipify.org, ifconfig.me и аналогичные), интерфейс у всех простой: GET-запрос возвращает адрес текстом. Этот способ работает и на клиенте, и на сервере, и под Linux — единственное требование: доступ в интернет с той стороны, где выполняется код.

Учитывайте зависимость от стороннего сервиса: он может быть недоступен, изменить адрес или ограничить частоту запросов. Для промышленного использования стоит предусмотреть таймаут, обработку ошибок и, при критичности, резервный адрес сервиса.

Как выбрать способ под вашу ситуацию

Выбор зависит от трёх факторов: где выполняется код (клиент или сервер), какая операционная система и какой адрес нужен — локальный или внешний. Сводная логика выбора приведена ниже.

На практике чаще всего адрес нужен для серверной логики (логирование, лицензирование, обмены), поэтому код размещают в серверном общем модуле, а клиент при необходимости получает результат вызовом сервера. Это же решает проблему ограничений тонкого клиента.

Проверка результата и типичные ошибки

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

Отдельно стоит упомянуть прокси-серверы: если в компании выход в интернет идёт через прокси, HTTP-запрос из 1С может вернуть адрес прокси, а не реального рабочего места, либо вовсе не пройти без настройки объекта ИнтернетПрокси в HTTPСоединение.

Альтернативы: внешние компоненты и расширения

Если задача регулярная и требует надёжности (например, лицензирование по сетевому окружению), иногда применяют внешние компоненты по технологии Native API или COM, которые возвращают сетевые параметры в удобном виде. Это убирает зависимость от разбора текста и работает быстрее, но добавляет компонент, который нужно распространять и поддерживать под каждую платформу.

Для клиент-серверных внедрений часто проще вообще не опрашивать сеть из 1С, а брать адрес из контекста сеанса: например, при работе через веб-сервер публикации адрес клиента доступен в заголовках HTTP-запроса на стороне веб-сервиса 1С. Это надёжнее, чем опрос интерфейсов на клиенте.

Частые вопросы