Администрирование · 10 мин
Установка агента сервера 1С как службы Windows
Как установить агент сервера 1С как службу Windows: команда srvcntx, регистрация через ragent, выбор порта и учётной записи, проверка запуска и типичные ошибки.
Агент сервера 1С:Предприятие (ragent) — ключевой процесс серверной архитектуры, который управляет кластером, рабочими процессами и соединениями с базами данных. Чтобы сервер 1С работал стабильно и запускался автоматически после перезагрузки операционной системы, агент необходимо зарегистрировать как службу Windows. Без этого администратору придётся запускать агент вручную каждый раз после перезагрузки сервера.
Установка агента как службы выполняется через командную строку с правами администратора и занимает несколько минут. Однако ошибки в параметрах — неправильный порт, неверная учётная запись, конфликт с уже существующей службой — приводят к тому, что служба не стартует или кластер оказывается недоступен для клиентов. Ниже разобран полный порядок действий: от подготовки до проверки результата.
Когда агента нужно устанавливать как службу
При стандартной установке сервера 1С:Предприятие инсталлятор предлагает зарегистрировать агент как службу автоматически. Однако есть ситуации, когда регистрацию нужно выполнить вручную: агент был установлен в режиме приложения, служба была удалена или повреждена, требуется поднять несколько агентов на разных портах одного сервера, либо выполняется перенос кластера на новую машину.
Работа агента в режиме обычного приложения (запуск ragent.exe без регистрации службы) допустима только для отладки. Такой процесс привязан к сеансу пользователя: при выходе из системы или перезагрузке сервера агент остановится, и все информационные базы кластера станут недоступны. Для производственной среды это недопустимо.
Подготовка: что проверить перед установкой
Перед регистрацией службы убедитесь, что платформа сервера 1С установлена и вы знаете точный путь к каталогу bin нужной версии. Путь имеет вид C:\Program Files\1cv8\8.3.хх.хххх\bin. Если на сервере установлено несколько версий платформы, важно использовать исполняемый файл именно той версии, под которой должен работать кластер.
Определите три ключевых параметра заранее: порт агента (стандартный — 1540), каталог реестра кластера (по умолчанию srvinfo внутри каталога платформы, но лучше указать отдельный путь, например C:\1cv8\srvinfo) и учётную запись, от имени которой будет работать служба. Если на сервере уже есть работающий кластер, убедитесь, что порт 1540 свободен — проверить можно командой netstat -ano | findstr :1540.
Установка агента как службы через командную строку
Откройте командную строку от имени администратора. Перейдите в каталог bin установленной платформы либо указывайте полный путь к ragent.exe в команде. Базовая команда регистрации службы выглядит так:
"C:\Program Files\1cv8\8.3.22.1750\bin\ragent.exe" -instsrvc -port 1540 -regport 1541 -range 1560:1591 -d "C:\1cv8\srvinfo" -usr .\1C_Server -pwd ПарольУчетнойЗаписиРазберём параметры команды. Ключ -instsrvc указывает, что агент регистрируется как служба. Параметр -port 1540 задаёт порт агента, -regport 1541 — порт реестра кластера, -range 1560:1591 — диапазон портов для рабочих процессов. Параметр -d определяет каталог реестра кластера, а -usr и -pwd — учётную запись и пароль для запуска службы.
Если служба должна работать от имени локальной системной учётной записи, параметры -usr и -pwd можно опустить — тогда служба будет зарегистрирована от имени LocalSystem. Однако для доступа к сетевым ресурсам и SQL Server с Windows-аутентификацией системной учётной записи часто недостаточно.
- 1Откройте командную строку от имени администратора
- 2Убедитесь, что порт 1540 свободен: netstat -ano | findstr :1540
- 3Выполните команду ragent.exe -instsrvc с нужными параметрами порта, каталога и учётной записи
- 4Откройте оснастку services.msc и найдите службу "Агент сервера 1С:Предприятия"
- 5Запустите службу и установите тип запуска "Автоматически"
- 6Проверьте доступность кластера через консоль администрирования серверов 1С
Параметры службы и выбор портов
Стандартная схема портов сервера 1С: агент слушает порт 1540, реестр кластера — 1541, рабочие процессы занимают диапазон 1560–1591. Если на одном физическом сервере нужно развернуть два независимых кластера (например, продуктивный и тестовый), второй агент регистрируется со сдвигом портов: 2540, 2541 и диапазон 2560:2591.
При регистрации второго агента важно указать уникальное имя службы, иначе команда завершится ошибкой, так как служба с именем по умолчанию уже существует. Для этого используется параметр -srvcname, например -srvcname \"1C:Enterprise 8.3 Server Agent (x86-64) test\".
| Назначение | Стандартный порт | Второй кластер |
|---|---|---|
| Порт агента сервера | 1540 | 2540 |
| Порт реестра кластера | 1541 | 2541 |
| Диапазон рабочих процессов | 1560–1591 | 2560–2591 |
Указанные порты должны быть открыты в брандмауэре Windows, если к серверу подключаются клиенты по сети. Откройте входящие TCP-подключения на порт агента и диапазон рабочих процессов, иначе клиенты не смогут найти кластер, хотя служба будет работать корректно.
Проверка результата после установки
После регистрации откройте оснастку «Службы» (services.msc) и найдите службу «Агент сервера 1С:Предприятия 8.3» — её имя может отличаться в зависимости от версии платформы и параметра -srvcname. Запустите службу и убедитесь, что она переходит в состояние «Работает» без ошибок.
Далее проверьте, что агент слушает назначенный порт: netstat -ano | findstr :1540 должен показать строку в состоянии LISTENING. Финальная проверка — подключение через консоль администрирования серверов 1С: добавьте сервер, разверните кластер и убедитесь, что отображаются рабочие процессы и список информационных баз.
Как проверить результат
Статус "Работает", тип запуска "Автоматически"
Служба остановлена или завершается сразу после запуска
netstat показывает LISTENING на порту агента
Порт не прослушивается — агент не запустился
Кластер открывается, видны рабочие процессы и базы
Ошибка подключения к агенту или пустой список процессов
В каталоге srvinfo появились файлы реестра (1CV8Clst.lst и др.)
Каталог пуст — нет прав на запись или указан неверный путь
Удаление и перерегистрация службы
Если служба зарегистрирована с ошибочными параметрами, её нужно удалить и создать заново. Для удаления используется команда ragent.exe -rmsrvc с указанием имени службы, если оно нестандартное. Перед удалением остановите службу через services.msc или командой net stop.
net stop "1C:Enterprise 8.3 Server Agent (x86-64)"
"C:\Program Files\1cv8\8.3.22.1750\bin\ragent.exe" -rmsrvcУдаление службы не затрагивает каталог реестра кластера: файлы srvinfo остаются на месте, и после повторной регистрации агента с тем же параметром -d все информационные базы кластера будут подхвачены автоматически. Удалять каталог srvinfo нужно только осознанно — это приведёт к потере списка зарегистрированных баз в кластере.
Типичные ошибки и их устранение
Самая частая проблема — служба не стартует из-за неверного пароля учётной записи или отсутствия у неё права «Вход в качестве службы». Проверьте журнал событий Windows (Просмотр событий → Журналы Windows → Система): там будет событие от источника Service Control Manager с кодом ошибки. Право входа в качестве службы назначается через локальную политику безопасности (secpol.msc).
Вторая распространённая ситуация — конфликт портов. Если порт 1540 уже занят другим приложением или оставшимся процессом ragent, служба стартует и сразу завершается. Найдите процесс, занявший порт, через netstat -ano и завершите его, либо зарегистрируйте агент на другом порту.
FAQ
Можно ли установить агент как службу при установке платформы?
Да. В мастере установки сервера 1С:Предприятие есть шаг, где предлагается установить агент как службу Windows с указанием учётной записи и пароля. Это стандартный сценарий, и ручная регистрация требуется только при нестандартных задачах или если служба была удалена.
Чем отличается порт 1540 от порта 1541?
Порт 1540 используется агентом сервера для приёма подключений от консоли администрирования и клиентов. Порт 1541 — порт менеджера кластера, через который работает внутренний реестр кластера. Оба порта должны быть уникальны для каждого агента на одном сервере.
Служба запускается и сразу останавливается — в чём причина?
Чаще всего причина в занятом порте, отсутствии прав у учётной записи службы на каталог srvinfo или неверном пароле. Проверьте журнал событий Windows и попробуйте запустить ragent.exe вручную в командной строке без параметров службы — сообщение об ошибке появится прямо в консоли.
Можно ли запустить два агента сервера 1С на одной машине?
Да. Зарегистрируйте второй агент с уникальным именем службы (параметр -srvcname), другим портом (например, 2540), другим портом реестра (2541), отдельным диапазоном рабочих портов (2560:2591) и отдельным каталогом реестра кластера. Каждый агент будет обслуживать собственный независимый кластер.
Потеряются ли базы при удалении службы агента?
Нет. Удаление службы командой -rmsrvc затрагивает только регистрацию в Windows. Реестр кластера в каталоге srvinfo и сами базы в СУБД сохраняются. После повторной регистрации службы с тем же каталогом -d кластер вернётся в прежнее состояние.
Нужно ли открывать порты в брандмауэре?
Да, если к серверу подключаются клиенты или консоль администрирования по сети. Создайте входящие правила для TCP-портов агента (1540), реестра кластера (1541) и диапазона рабочих процессов (1560–1591). На сервере, работающем только локально, это не требуется.
Что важно запомнить
Агент сервера 1С регистрируется как служба командой ragent.exe -instsrvc с указанием порта, каталога реестра кластера и учётной записи. После установки проверьте состояние службы, прослушивание порта 1540 и доступность кластера в консоли администрирования. Для нескольких кластеров на одном сервере используйте уникальные имена служб и непересекающиеся порты.