Почему не работает отладка на сервере 1С через удаленный рабочий стол и как это исправить?

Разработка и отладка программного кода непосредственно на сервере — стандартная практика для программистов 1С. Однако очень часто при попытке подключить отладчик с удаленного рабочего места (например, из дома через VPN или с другого сетевого сегмента) разработчики сталкиваются с неприятной проблемой: локально на сервере отладка работает прекрасно, но на удаленном клиентском компьютере точки останова упорно игнорируются, а серверные вызовы не перехватываются.

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

Выясняем причину: почему классическая TCP-отладка не работает извне?

В более ранних версиях платформы «1С:Предприятие» по умолчанию использовался протокол TCP. На первый взгляд, схема кажется простой: в настройках указывается диапазон портов (по умолчанию 1560:1591), системные администраторы открывают эти порты на сервере, и всё должно работать. Но на практике удаленной работы мы сталкиваемся с архитектурным ограничением механизма TCP-отладки, которое называется проблемой обратного вызова (Callback).

Давайте проанализируем, как устанавливается связь при TCP-отладке:

1. Конфигуратор на компьютере разработчика инициирует исходящее соединение с сервером 1С.
2. Когда на сервере начинает выполняться код, требующий отладки, рабочий процесс сервера rphost пытается установить обратное входящее соединение на компьютер разработчика.
3. Для этого обратного соединения сервер выбирает случайный порт из диапазона 1560:1591 на клиентском компьютере.

И именно на третьем шаге схема ломается. Если компьютер разработчика находится за домашним роутером, сетевым экраном (Firewall), NAT или подключен по VPN без специальной маршрутизации, то роутер или локальный брандмауэр Windows на клиентском ПК мгновенно заблокирует эту попытку входящего соединения от сервера 1С. В результате конфигуратор не получает отклик, и серверный код выполняется без остановки.

Решение проблемы: переход на протокол HTTP-отладки

Начиная с версии платформы 8.3.7, фирма 1С добавила альтернативный и гораздо более надежный механизм — отладку по протоколу HTTP. Этот вариант полностью решает проблему «обратного вызова» благодаря принципиально иной архитектуре взаимодействия.

При использовании HTTP-отладки запускается специальная служба — локальный или выделенный сервер отладки (приложение dbgs.exe). Схема работы выглядит следующим образом:

1. Сервер отладки запускается на стороне сервера 1С и слушает по умолчанию всего один порт — 1550.
2. Конфигуратор разработчика сам подключается к этому серверу отладки по HTTP (это исходящее соединение для клиента).
3. Рабочий процесс сервера 1С (rphost) также сам подключается к этому серверу отладки (это локальное или исходящее соединение для сервера).

Таким образом, больше нет никаких «обратных» входящих вызовов от сервера к клиенту! Все соединения являются исходящими со сторон участников к единой точке — серверу отладки dbgs. Системным администраторам достаточно открыть всего один входящий порт 1550 на сервере 1С, и отладка будет гарантированно работать у всех удаленных разработчиков без настройки их домашних роутеров.

Шаг 1. Настройка HTTP-отладки на сервере 1С

Для того чтобы перевести сервер 1С в режим HTTP-отладки, нам потребуется изменить параметры запуска службы агента сервера «1С:Предприятие».

Для операционной системы Windows:

1. Откроем консоль служб (services.msc) и остановим службу сервера 1С (например, 1C:Enterprise 8.3 Server Agent).
2. Запустим редактор реестра через команду regedit.
3. Перейдем по следующему пути: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\ и найдем ветку нашей службы 1С (например, 1C:Enterprise 8.3 Server Agent (x86-64)).
4. В правой части окна найдем строковый параметр ImagePath. Он содержит команду запуска службы.
5. Отредактируем этот параметр, добавив в конец строки параметры -debug -http.

Пример исходного значения параметра ImagePath:

"C:\Program Files\1cv8\8.3.22.1709\bin\ragent.exe" -srvc -agent -regport 1541 -port 1540 -range 1560:1591 -d "C:\Program Files\1cv8\srvinfo"

Пример измененного значения с включенной HTTP-отладкой:

"C:\Program Files\1cv8\8.3.22.1709\bin\ragent.exe" -srvc -agent -regport 1541 -port 1540 -range 1560:1591 -debug -http -d "C:\Program Files\1cv8\srvinfo"

После внесения изменений сохраним параметры реестра и запустим службу сервера 1С заново.

Для операционной системы Linux:

1. Остановим службу сервера 1С с помощью команды управления службами вашего дистрибутива.
2. Откроем конфигурационный файл службы. В зависимости от дистрибутива он может находиться по пути /etc/sysconfig/srv1cv83 или /etc/default/srv1cv83.
3. Найдем параметр SRV1CV8_DEBUG и присвоим ему соответствующее значение:

SRV1CV8_DEBUG="-debug -http"

Затем сохраним изменения в файле конфигурации и запустим службу сервера 1С.

Шаг 2. Настройка подключения в Конфигураторе

Теперь, когда сервер готов принимать подключения по HTTP, настроим рабочее место разработчика:

1. Запустим Конфигуратор 1С на удаленном компьютере.
2. Перейдем в главное меню: Сервис — Параметры, а затем откроем вкладку Отладка.
3. Установим переключатель «Способ отладки» в положение Отладка по протоколу HTTP.
4. В поле «Адрес локального сервера отладки» система автоматически подставит локальный адрес, но нам необходимо настроить подключение к удаленному серверу. В поле «Сервер отладки» укажем адрес нашего сервера 1С и порт 1550 в формате: http://[Имя_или_IP_сервера]:1550.
5. Нажмем кнопку «Применить». Конфигуратор предложит перезапуститься для применения настроек — соглашаемся.

Дополнительный чек-лист: что проверить, если отладка все равно не работает?

Если после перехода на HTTP-протокол точки останова все равно пролетают мимо, рекомендуем последовательно выполнить следующие проверки:

1. Настройка автоматического подключения в Конфигураторе
Часто разработчики забывают указать, какие именно сеансы должен перехватывать отладчик. В Конфигураторе перейдем в меню Отладка — Подключение.... В открывшемся окне нажмем кнопку Автоматическое подключение и установим флажки напротив интересующих нас типов соединений: «Тонкий клиент», «Фоновые задания», «Внешнее соединение» и т. д. Это критически важно для перехвата кода, выполняемого в фоновых задачах.

2. Проверка разрешения сетевых имен (DNS)
Платформа 1С крайне чувствительна к корректности работы DNS. Если сервер 1С не может сопоставить имя компьютера разработчика с его IP-адресом (или наоборот), отладка может давать сбои. Чтобы исключить эту проблему при HTTP-отладке, в настройках Конфигуратора (в поле «Сервер отладки») рекомендуется указывать именно прямой IP-адрес сервера (например, http://192.168.10.25:1550), а не его сетевое имя.

3. Проверка публикации веб-сервисов и HTTP-сервисов
Если вы пытаетесь отлаживать код, который инициируется внешними HTTP- или SOAP-запросами к базе 1С, опубликованной на веб-сервере (IIS или Apache), обычных настроек конфигуратора будет недостаточно. Нам потребуется отредактировать файл публикации default.vrd, который находится в каталоге публикации на веб-сервере. Откроем этот файл в текстовом редакторе и добавим внутрь тега <point> параметр отладки:

<debug enable="true" protocol="http" url="http://[IP_сервера_отладки]:1550" />

После изменения файла default.vrd обязательно перезапустим службу веб-сервера (IIS или Apache), чтобы новые параметры вступили в силу.

Проделав эти шаги, мы получим стабильную, быструю и полностью независимую от сетевых преград систему отладки, которая позволит комфортно работать над проектами 1С из любой точки мира.