Администрирование · 9 мин
Агент сервера 1С:Предприятия: что это и как с ним работать
Агент сервера 1С:Предприятия — что это за служба, как она работает, зачем нужна в кластере. Установка, настройка, типичные ошибки и способы диагностики.
Агент сервера 1С:Предприятия — это центральный компонент серверной архитектуры платформы 1С. Он представляет собой службу (в Windows) или демон (в Linux), которая запускается на каждом физическом или виртуальном сервере, входящем в кластер, и управляет всеми остальными процессами сервера 1С на этой машине. Без работающего агента кластер серверов не существует: именно агент хранит реестр кластера, принимает подключения консоли администрирования и координирует работу рабочих процессов.
Термин «агент» часто путают с «сервером 1С» в целом. На практике сервер 1С — это набор взаимосвязанных компонентов: агент (ragent), менеджер кластера (rmngr) и рабочие процессы (rphost). Агент — точка входа: он первым принимает сетевые подключения, регистрирует сервер в кластере и передаёт управление остальным процессам.
Понимание роли агента критично для администратора: большинство проблем «не запускается сервер 1С», «консоль не видит кластер», «база недоступна пользователям» начинаются именно с диагностики службы агента, её портов и файлов реестра кластера.
Из чего состоит сервер 1С и какое место занимает агент
Сервер 1С:Предприятия — это не один процесс, а группа процессов, работающих совместно. Агент (ragent.exe в Windows или ragent в Linux) — главный из них. При старте службы «Агент сервера 1С:Предприятия» именно ragent загружает реестр кластера из каталога srvinfo и запускает менеджер кластера (rmngr), который, в свою очередь, порождает рабочие процессы (rphost), обслуживающие сеансы пользователей.
Агент выполняет несколько конкретных функций: регистрирует сервер в составе кластера, обеспечивает взаимодействие между несколькими серверами одного кластера, принимает подключения консоли администрирования серверов и отвечает за аутентификацию администраторов кластера. Если агент остановлен, рабочие процессы могут ещё какое-то время обслуживать существующие сеансы, но управлять кластером и подключать новые базы уже невозможно.
Какие порты использует агент и зачем их знать
По умолчанию агент сервера 1С использует TCP-порт 1540. Менеджер кластера работает на порту 1541, а рабочие процессы занимают диапазон 1560–1591. Если при установке указан другой диапазон портов, все значения смещаются соответственно — это важно учитывать при настройке межсетевых экранов.
Типичная ситуация: консоль администрирования на другом компьютере «не видит» сервер. В большинстве случаев причина — закрытый порт 1540 на брандмауэре Windows или сетевом экране между машинами. Проверить доступность порта можно командой Test-NetConnection имя_сервера -Port 1540 в PowerShell.
| Компонент | Порт по умолчанию | Назначение |
|---|---|---|
| Агент (ragent) | 1540 | Подключения консоли, управление кластером |
| Менеджер кластера (rmngr) | 1541 | Координация рабочих процессов |
| Рабочие процессы (rphost) | 1560–1591 | Обслуживание сеансов пользователей |
Как устанавливается и запускается агент
Агент устанавливается вместе с компонентом «Сервер 1С:Предприятия» из дистрибутива платформы. При установке в Windows мастер предлагает создать службу «Агент сервера 1С:Предприятия (x86-64)» и задать учётную запись, от имени которой она будет работать. По умолчанию создаётся пользователь USR1CV8 с автоматически сгенерированным паролем.
В Linux агент запускается как демон через скрипт srv1cv8 или юнит systemd. Каталог реестра кластера по умолчанию — /opt/1cv8/.../srvinfo или путь, заданный параметром -d при запуске.
- 1Откройте services.msc и найдите службу «Агент сервера 1С:Предприятия» нужной версии платформы.
- 2Убедитесь, что тип запуска — «Автоматически», а состояние — «Выполняется».
- 3Если служба остановлена — запустите её и проверьте журнал событий Windows на ошибки.
- 4Проверьте, что порт 1540 слушается: netstat -an | find "1540".
- 5Откройте консоль администрирования серверов и убедитесь, что кластер отображается.
Учётная запись службы должна иметь права на каталог srvinfo, на каталоги журналов и, при файловых размещениях лицензий, на каталоги лицензирования. Недостаток прав — частая причина «пустого» кластера после переустановки или переноса сервера.
Реестр кластера: где агент хранит настройки
Вся конфигурация кластера — список информационных баз, администраторов, параметры рабочих процессов, требования назначения функциональности — хранится в реестре кластера. В Windows это обычно каталог C:\Program Files\1cv8\<версия>\srvinfo, ключевой файл — 1CV8Clst.lst, а также файлы регистрации баз.
Каталог srvinfo — критичный объект. Его повреждение или удаление означает потерю списка зарегистрированных баз в кластере: сами базы в СУБД останутся нетронутыми, но их придётся заново регистрировать в консоли. Поэтому каталог srvinfo стоит включать в план резервного копирования сервера.
Типичные проблемы с агентом и их диагностика
Самая частая жалоба — «консоль не видит кластер» или «кластер пустой». Причины обычно такие: служба агента остановлена, консоль подключается не к той версии платформы, порт 1540 закрыт, либо агент запущен с другим каталогом srvinfo (например, после установки новой версии платформы рядом со старой).
Вторая группа проблем — служба не стартует. Проверяйте: занят ли порт 1540 другим процессом (например, агентом другой версии платформы, установленной с тем же диапазоном портов), есть ли права у учётной записи службы на srvinfo, не повреждён ли реестр кластера. Детали смотрите в журнале событий Windows и в технологическом журнале 1С.
Как проверить результат
Состояние «Выполняется», запуск автоматический
Служба остановлена или падает сразу после старта
netstat показывает LISTENING на 1540
Порт не слушается или занят чужим процессом
Кластер раскрывается, видны базы и процессы
Кластер пуст или ошибка подключения
Несколько агентов и кластер из нескольких серверов
На одном физическом сервере может работать несколько агентов разных версий платформы — например, 8.3.22 и 8.3.24. Каждый из них должен использовать свой диапазон портов и свой каталог srvinfo, иначе возникнет конфликт. Консоль администрирования подключается к конкретному агенту по порту, поэтому важно знать, какая версия на каком порту работает.
В кластер можно объединять несколько серверов: агент каждого дополнительного сервера подключается к главному, и рабочие процессы распределяются между машинами. Это используется для отказоустойчивости и балансировки нагрузки. Учтите, что все серверы кластера должны иметь одинаковую версию платформы и сетевую связность по портам агента и менеджера.
Как выбрать действие
FAQ
Чем агент сервера 1С отличается от рабочего процесса rphost?
Агент (ragent) управляет кластером: хранит реестр, принимает подключения консоли, запускает остальные процессы. Рабочие процессы rphost непосредственно обслуживают сеансы пользователей и выполняют код прикладных решений. Агент один на сервер, рабочих процессов может быть несколько.
Можно ли перенести агент сервера 1С на другую машину?
Да. Установите платформу той же версии на новом сервере, остановите службу на старом, скопируйте каталог srvinfo на новое место и запустите службу. Если меняется имя сервера, потребуется перерегистрировать базы или скорректировать настройки подключений клиентов.
Что делать, если забыт пароль администратора кластера?
Остановите службу агента, сделайте резервную копию srvinfo, затем удалите или переименуйте файлы реестра кластера и запустите службу — кластер создастся пустым, без администраторов. После этого заново зарегистрируйте базы и задайте администраторов. Сами данные в СУБД при этом не пострадают.
Нужен ли агент сервера, если база файловая?
Нет. Файловые информационные базы работают без сервера 1С и без агента — клиент обращается напрямую к файлу базы. Агент требуется только для клиент-серверного варианта работы с СУБД (MS SQL, PostgreSQL и др.).
Почему после перезагрузки сервера пользователи не могут подключиться?
Чаще всего служба агента не стартовала автоматически или стартовала раньше, чем поднялась СУБД. Проверьте состояние службы, настройте автоматический запуск с задержкой и убедитесь, что сервер СУБД доступен к моменту старта агента.
Можно ли запустить два агента одной версии платформы на одном сервере?
Технически да, если запустить их с разными портами и разными каталогами srvinfo (параметры командной строки агента). На практике это редко оправдано — обычно достаточно одного агента с несколькими рабочими процессами.
Что важно запомнить
Агент сервера 1С (ragent, порт 1540) — управляющая служба кластера: хранит реестр в srvinfo, принимает подключения консоли и запускает рабочие процессы. Большинство проблем решается проверкой службы, портов, прав учётной записи и целостности каталога srvinfo, который обязательно нужно резервировать.