1C_DEBUG_MODE_SETUP 1С:Предприятие и СУБД

Как включить отладку на сервере 1С:Предприятие (ключ -debug)

Обновлено: 26.08.2026 · Официальная документация ↗

Программист ставит точку останова в Конфигураторе, но выполнение кода на сервере (в серверных модулях) не останавливается.
В меню Отладка → Подключение отсутствуют фоновые задания и серверные сеансы.
Невозможно отладить проведение документов или веб-сервисы в клиент-серверной базе данных.
Серверная служба ragent запущена в стандартном рабочем режиме без флага отладки.

Способ 1. Включение отладки в Windows (через реестр)

Нажмите Win + R, введите regedit и нажмите Enter.
Перейдите по ветке реестра вашей службы сервера 1С:
HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\1C:Enterprise 8.3 Server Agent... (или ragent).
В правой части найдите строковый параметр ImagePath и откройте его двойным кликом.
В поле «Значение» найдите вызов ragent.exe и добавьте параметр -debug (через пробел).
Пример:
"C:\Program Files\1cv8\8.3.24.1342\bin\ragent.exe" -srvc -agent -regport 1541 -port 1540 -range 1560:1591 -d "C:\Program Files\1cv8\srvinfo" -debug
Нажмите ОК.
Откройте Службы (services.msc) и перезапустите службу Агента сервера 1С:Предприятия.

Способ 2. Включение отладки в Linux

Откройте конфигурационный файл службы: /etc/systemd/system/srv1cv8-8.3.XX.XXXX.service (или файл /opt/1cv8/current/srv1cv83.conf).
Добавьте ключ -debug в строку запуска ExecStart или параметр SRV1CV8_DEBUG=1.
Выполните: systemctl daemon-reload && systemctl restart srv1cv8-*.

💡 Практика специалистов: Не включайте режим отладки на высоконагруженных продуктивных серверах с сотнями пользователей без необходимости — случайная остановка сеанса разработчиком на точке останова внутри общей транзакции заблокирует работу всего предприятия.

Частые вопросы (FAQ)

Сильно ли включенный режим отладки замедляет сервер?

Включение ключа -debug практически не влияет на производительность, пока к процессу непосредственно не подключился программист через Конфигуратор и не остановил выполнение на точке останова.

Почему после обновления платформы 1С отладка снова выключилась?

При установке нового релиза создается новая служба Windows со стандартной строкой ImagePath без ключа -debug. Процедуру в реестре нужно повторить для новой ветки службы.

Как включить отладку по протоколу HTTP?

В современных версиях 1С используется отладка по HTTP. Для нее в параметрах запуска ragent указываются ключи -http -debug.

Как проверить, что сервер 1С действительно запустился в режиме отладки?

В Конфигураторе откройте меню Отладка → Подключение. Если в списке доступных предметов отладки появились строки с типом 'Сервер', отладка работает успешно.