К статье
Практический материал

Администрирование · 10 мин

Установка агента сервера 1С как службы Windows

Как установить агент сервера 1С как службу Windows: команда regagent, параметры запуска, выбор учётной записи, проверка работы и решение типичных ошибок.

Агент сервера предприятия 1С — центральный процесс кластера, который координирует работу сервера приложений и связь с базами данных. Если сервер 1С установлен «как приложение», агент запускается только после входа пользователя в систему и пропадает при завершении сеанса — рабочие базы становятся недоступны. Регистрация агента как службы Windows решает эту проблему: процесс стартует автоматически вместе с операционной системой и работает без интерактивного входа.

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

Когда агента нужно установить как службу

Режим службы обязателен для любого продуктивного сервера. Признак того, что агент работает как приложение: в панели задач виден значок ragent, а после перезагрузки сервера пользователи не могут подключиться к базам, пока администратор не войдёт в систему и не запустит агент вручную.

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

Подготовка: что проверить перед установкой

Перед регистрацией службы убедитесь, что компонент «Сервер 1С:Предприятия» установлен на компьютере. Исполняемый файл агента находится в каталоге вида C:\Program Files\1cv8\<версия>\bin\ragent.exe. Если папки с ragent.exe нет, сначала запустите дистрибутив платформы и установите серверную компоненту.

Определите три параметра, которые понадобятся при регистрации: сетевой порт агента (по умолчанию 1540), каталог реестра кластера (по умолчанию C:\Program Files\1cv8\srvinfo) и учётную запись, от имени которой будет работать служба. Если на сервере уже есть работающий кластер с базами, используйте его текущий каталог srvinfo — иначе после перерегистрации кластер «потеряет» список баз.

Установка через командную строку

Основной способ — запуск ragent.exe с ключом регистрации службы. Командную строку нужно открыть от имени администратора, иначе регистрация завершится ошибкой доступа.

Типовая команда выглядит так:

cmd
"C:\Program Files\1cv8\8.3.22.1750\bin\ragent.exe" -instsrvc -port 1540 -d "C:\Program Files\1cv8\srvinfo" -usr ".\USR1CV8" -pwd "ПарольУчётнойЗаписи"

Разберём параметры. Ключ -instsrvc указывает на регистрацию службы. Параметр -port задаёт порт агента, -d — каталог реестра кластера. Параметры -usr и -pwd определяют учётную запись службы; если их не указать, служба будет работать от системной учётной записи LocalSystem. Для удаления службы используется ключ -rmsrvc с теми же значениями порта и каталога.

После выполнения команды в оснастке «Службы» появится служба «Агент сервера 1С:Предприятия 8.3» (Агент сервера 1С:Предприятия (x86-64)). Запустите её вручную или командой net start с именем службы.

Порядок установки службы
  1. 1
    Откройте командную строку от имени администратора
  2. 2
    Перейдите в каталог bin нужной версии платформы
  3. 3
    Выполните ragent.exe с ключом -instsrvc, портом, каталогом srvinfo и учётной записью
  4. 4
    Откройте services.msc и найдите службу агента сервера 1С
  5. 5
    Установите тип запуска «Автоматически» и запустите службу
  6. 6
    Проверьте состояние командой sc query или в консоли кластера

Выбор учётной записи для службы

От учётной записи зависят права агента на файловые ресурсы и сетевые подключения. Стандартная практика — создать отдельного пользователя, например USR1CV8, включить его в локальную группу «Пользователи» и выдать полные права на каталог srvinfo и на каталоги, где размещаются файловые базы и выгрузки.

Если сервер 1С работает с MS SQL Server или PostgreSQL по Windows-аутентификации, учётной записи службы нужны соответствующие права на стороне СУБД. При использовании аутентификации самой СУБД (логин и пароль в настройках базы) это требование снимается. Учётная запись LocalSystem подходит для изолированных стендов, но не имеет доступа к сетевым ресурсам — копирование выгрузок на сетевую папку из-под такой службы не сработает.

Установка через дистрибутив платформы

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

Этот способ удобен на новом сервере, но менее гибок: мастер использует стандартные порты и каталог по умолчанию. Если требуется нестандартный порт или несколько кластеров на одном сервере, регистрацию лучше выполнить вручную через ragent.

Способы регистрации службы

ragent.exe -instsrvc

Полный контроль над портом, каталогом и учётной записью; подходит для перерегистрации и нестандартных конфигураций

Мастер установки платформы

Быстро и просто при первичной установке; использует параметры по умолчанию

Оснастка services.msc вручную

Только для изменения учётной записи и типа запуска уже зарегистрированной службы; создать службу с нуля через неё нельзя

Проверка результата

После запуска службы убедитесь, что агент действительно работает. В оснастке «Службы» состояние должно быть «Выполняется», тип запуска — «Автоматически». Командой sc query с именем службы можно проверить состояние из командной строки.

Затем откройте консоль администрирования серверов 1С на любом компьютере сети, добавьте центральный сервер по имени и убедитесь, что кластер отвечает и отображает список информационных баз. Финальная проверка — перезагрузка сервера: после загрузки ОС базы должны быть доступны без входа пользователя в систему.

Контрольные точки

Как проверить результат

Состояние службы в services.msc
Норма

Выполняется, запуск автоматический

Тревожный признак

Остановлена или завершается сразу после старта

Порт агента прослушивается (netstat -an)
Норма

Порт 1540 в состоянии LISTENING

Тревожный признак

Порт не прослушивается

Кластер в консоли администрирования
Норма

Кластер доступен, видны базы и рабочие процессы

Тревожный признак

Ошибка подключения к агенту

Доступность после перезагрузки
Норма

Базы доступны без входа в систему

Тревожный признак

Нужен ручной запуск агента

Типичные ошибки и их решение

Чаще всего служба не стартует из-за неправильного пароля учётной записи или недостатка прав на каталог srvinfo. В журнале событий Windows (раздел «Система») при этом фиксируется ошибка входа или отказ в доступе. Решение — проверить пароль в свойствах службы на вкладке «Вход в систему» и выдать учётной записи полные права на каталог кластера.

Вторая частая ситуация — конфликт портов, когда на сервере установлено несколько версий платформы и обе пытаются занять порт 1540. В этом случае для каждого кластера задают свой диапазон портов при регистрации службы. Третья ошибка — указание пустого или нового каталога srvinfo на сервере с существующими базами: служба запустится, но кластер окажется пустым, и список баз придётся восстанавливать из копии каталога.

Типичные ошибки
01
Регистрация службы без прав администратора — команда завершается ошибкой, служба не создаётся
02
Указание нового каталога srvinfo вместо существующего — кластер теряет список информационных баз
03
Истекающий пароль учётной записи службы — агент перестаёт запускаться после перезагрузки
04
Одинаковый порт у двух кластеров на одном сервере — вторая служба не стартует из-за занятого порта
05
Работа службы от LocalSystem при необходимости доступа к сетевым папкам — выгрузки и обмены файлами не выполняются
Маршрут решения

Как выбрать действие

Служба не запускается, в журнале ошибка входаПроверьте пароль на вкладке «Вход в систему» в свойствах службы
Служба не запускается, отказ в доступе к файламВыдайте учётной записи службы полные права на каталог srvinfo
Кластер пуст после перерегистрацииОстановите службу и верните прежний каталог srvinfo из резервной копии
На сервере несколько версий платформыЗарегистрируйте каждую службу на отдельном порту командой ragent -instsrvc

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

Можно ли установить службу, если агент уже работает как приложение?

Да. Сначала остановите работающий агент-приложение, затем выполните регистрацию службы командой ragent -instsrvc с тем же каталогом srvinfo. Список баз кластера сохранится, так как он хранится в файлах каталога, а не в памяти процесса.

Как удалить службу агента сервера 1С?

Остановите службу и выполните ragent.exe с ключом -rmsrvc, указав тот же порт. Каталог srvinfo при этом не удаляется — при повторной регистрации кластер подхватит прежние настройки и список баз.

Какая учётная запись лучше: доменная или локальная?

Локальная проще в обслуживании и не зависит от доменных политик смены паролей. Доменную выбирают, когда службе нужен доступ к сетевым ресурсам других серверов или Windows-аутентификация в СУБД на отдельной машине.

Нужно ли открывать порты в брандмауэре?

Да, если клиенты и консоль подключаются с других компьютеров. Для стандартной конфигурации нужны входящие правила для портов 1540 (агент), 1541 (менеджер кластера) и диапазона рабочих процессов 1560–1591.

Служба запускается и сразу останавливается — что делать?

Проверьте журнал событий Windows и технологический журнал платформы. Типовые причины: занятый порт, повреждённые файлы в каталоге srvinfo, недостаток прав учётной записи. Для диагностики можно временно запустить ragent как приложение из командной строки — ошибка выведется в консоль.

Можно ли на одном сервере держать два кластера разных версий?

Можно. Каждый агент регистрируется отдельной службой со своим портом и собственным каталогом srvinfo. В оснастке «Службы» они отображаются как отдельные записи с указанием версии платформы.

Итог

Что важно запомнить

Агент сервера 1С регистрируется как служба командой ragent.exe -instsrvc с указанием порта, каталога srvinfo и учётной записи. Перед изменениями сохраните копию каталога srvinfo, выдайте учётной записи службы нужные права и после запуска проверьте доступность кластера, включая перезагрузку сервера.