1C ragent: что это за процесс и как он работает

Если вы открыли диспетчер задач на сервере с 1С и увидели процесс ragent.exe, потребляющий память и процессорное время, — это нормально. ragent (расшифровывается как remote agent, «удалённый агент») — исполняемый файл агента сервера 1С:Предприятие, который запускается при старте службы «Агент сервера 1С:Предприятия» (1C:Enterprise Server Agent). Именно через него проходят все подключения клиентов к информационным базам в клиент-серверном варианте работы.

Файл ragent.exe находится в каталоге установки платформы, обычно по пути C:\Program Files\1cv8\<версия>\bin\ragent.exe на Windows или /opt/1cv8/<версия>/ragent на Linux. Один агент обслуживает весь кластер серверов 1С, поэтому его стабильная работа критична: если процесс остановлен, пользователи не смогут подключиться ни к одной базе.

Понимание роли ragent помогает диагностировать типовые проблемы: «сервер 1С недоступен», зависания при подключении, рост потребления памяти, ошибки кластера. Ниже разберём устройство процесса, порты, настройку, типичные сбои и способы их устранения.

Какую роль ragent выполняет в архитектуре 1С

Клиент-серверный вариант 1С состоит из трёх уровней: клиентское приложение, кластер серверов 1С и сервер СУБД (MS SQL, PostgreSQL, Oracle или IBM DB2). Агент ragent — точка входа в средний уровень. Клиент сначала обращается именно к агенту, а тот направляет запрос на подходящий рабочий процесс кластера.

Ключевые функции агента:

• ведение списка информационных баз, зарегистрированных в кластере (хранится в файле 1CV8Clst.lst в каталоге srvinfo);
• запуск и контроль рабочих процессов rphost, которые непосредственно исполняют код прикладных решений;
• взаимодействие с менеджером кластера rmngr — распределение сеансов и сервисов между рабочими процессами;
• обработка подключений консоли администрирования серверов 1С;
• ведение журнала регистрации кластера и технологического журнала при его включении.

Важно понимать разницу между тремя процессами, которые видны на сервере: ragent — агент (один на кластер), rmngr — менеджер кластера (управляет распределением нагрузки), rphost — рабочие процессы (их может быть много, именно они потребляют основную память). Если «съедается» оперативная память, чаще всего виноваты rphost, а не ragent.

Где находится ragent и какие порты он использует

По умолчанию агент сервера 1С использует порт 1540 для входящих подключений. Менеджер кластера работает на порту 1541, а рабочие процессы занимают диапазон 1560–1591. Эти порты должны быть открыты в брандмауэре на сервере, иначе клиенты получат ошибку подключения.

Рабочий каталог агента — папка srvinfo (на Windows обычно C:\Program Files\1cv8\srvinfo, на Linux — /home/usr1cv8/.1cv8/1C/1cv8 или путь, заданный параметром -d). Там хранятся реестр кластера, журнал регистрации, файлы сеансовых данных. Удалять содержимое этой папки при работающем агенте нельзя.

Как запускается и настраивается ragent

При установке сервера 1С на Windows с опцией «Устанавливать сервер 1С:Предприятия как службу» регистрируется служба, которая автоматически запускает ragent при старте системы. Параметры запуска прописываются в строке запуска службы и в реестре Windows.

Основные параметры командной строки агента:

• -port 1540 — порт агента;
• -regport 1541 — порт менеджера кластера;
• -range 1560:1591 — диапазон портов рабочих процессов;
• -d "путь" — каталог данных кластера (srvinfo);
• -debug — режим отладки (нужен для подключения отладчика к серверным процедурам).

sc query "1C:Enterprise 8.3 Server Agent" | findstr STATE

На Linux агент обычно запускается через systemd-юнит srv1cv8. Проверить состояние можно командой systemctl status srv1cv8, посмотреть лог запуска — journalctl -u srv1cv8.

Типичные проблемы с ragent и их причины

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

• ошибка клиента «Ошибка соединения с сервером 1С:Предприятия» — служба агента остановлена, закрыт порт 1540 или сбой сети;
• консоль администрирования не видит кластер — агент работает, но повреждён реестр кластера или несовпадают версии платформы консоли и сервера;
• служба не стартует после обновления платформы — в параметрах запуска остался путь на старую версию или повреждены файлы srvinfo;
• ragent занимает аномально много памяти — редкая ситуация, чаще указывает на утечку в конкретной версии платформы; обычно решается обновлением.

Как безопасно перезапустить агент сервера

Перезапуск ragent — штатная операция, но она разрывает все активные сеансы. Правильный порядок такой:

1. 1
   Предупредите пользователей и попросите завершить работу, либо дождитесь нерабочего времени
2. 2
   В консоли администрирования проверьте, что нет активных сеансов и фоновых заданий
3. 3
   Остановите службу: net stop "1C:Enterprise 8.3 Server Agent" или systemctl stop srv1cv8
4. 4
   Дождитесь полной остановки процессов ragent, rmngr и rphost
5. 5
   Запустите службу обратно и проверьте, что порт 1540 прослушивается
6. 6
   Откройте консоль администрирования и убедитесь, что кластер и базы на месте
7. 7
   Проверьте подключение тестовым клиентом к одной из баз

Если после перезапуска кластер «пустой» — не видно информационных баз — проверьте, с тем ли каталогом srvinfo запущен агент. Реестр баз восстанавливается из резервной копии файлов 1CV8Clst.lst и связанных файлов каталога.

Как диагностировать состояние ragent

Первичная диагностика занимает несколько минут и не требует специальных инструментов:

Для глубокой диагностики включите технологический журнал (файл настройки logcfg.xml в каталоге conf платформы): он фиксирует события кластера, ошибки соединений и длительные вызовы. Не забудьте отключить журнал после сбора данных — постоянная запись замедляет сервер и быстро заполняет диск.

Когда проблема не в ragent

Не каждая ошибка «сервер недоступен» связана с агентом. Если служба работает и порт слушается, проверяйте дальше: доступность сервера СУБД, состояние рабочих процессов rphost, лицензии (отсутствие свободных лицензий тоже блокирует подключение), а также сетевые фильтры между клиентом и сервером.

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