Администрирование · 8 мин
Как запустить агент сервера 1С:Предприятие
Как запустить агент сервера 1С:Предприятие в Windows и Linux: запуск службы, команды ragent, проверка портов, решение типичных ошибок при старте агента.
Агент сервера 1С:Предприятие (процесс ragent) — центральный компонент серверной архитектуры, через который клиенты подключаются к кластеру, а рабочие процессы обслуживают информационные базы. Без запущенного агента ни одна база в клиент-серверном режиме работать не будет: пользователи увидят ошибку соединения, а консоль кластера не сможет подключиться.
Способ запуска зависит от операционной системы и от того, как устанавливался сервер: как служба Windows, как демон systemd в Linux или как приложение командной строки для отладки. Ниже разобраны все рабочие сценарии с проверкой результата и разбором типичных ошибок.
Проверка перед запуском: что должно быть установлено
Прежде чем запускать агент, убедитесь, что на машине установлен компонент «Сервер 1С:Предприятия» соответствующей версии платформы. В Windows это видно в списке служб и в каталоге установки (обычно C:\Program Files\1cv8\<номер версии>\bin), в Linux — по наличию пакета 1c-enterprise-server и каталога /opt/1cv8.
Важно, чтобы версия сервера совпадала с версией, под которой создавались и публикуются информационные базы. Запуск агента одной версии, когда базы зарегистрированы в кластере другой версии, приведёт к ошибкам подключения клиентов. Если на сервере стоит несколько версий платформы, у каждой своя служба с отдельным именем и своими портами.
Также проверьте, что учётная запись, под которой будет работать агент, имеет права на каталог реестра кластера (srvinfo) и на временные каталоги. Недостаток прав — одна из самых частых причин, когда служба «запускается и сразу останавливается».
Запуск агента в Windows через службы
Стандартный способ — запуск службы «Агент сервера 1С:Предприятия (x86-64)». Откройте оснастку services.msc (Win+R → services.msc), найдите службу в списке, нажмите правой кнопкой и выберите «Запустить». Тип запуска рекомендуется установить «Автоматически», чтобы агент стартовал вместе с системой.
Тот же результат даёт командная строка с правами администратора:
net start "Агент сервера 1С:Предприятия 8.3 (x86-64)"Если службы в списке нет — сервер был установлен без регистрации службы. Зарегистрировать её можно вручную утилитой ragent с ключом -instsrvc, указав пользователя и пароль:
"C:\Program Files\1cv8\8.3.22.1750\bin\ragent.exe" -instsrvc -usr .\USR1CV8 -pwd ПарольПосле регистрации служба появится в services.msc, и её можно запустить обычным способом. Удаляется служба ключом -rmsrvc.
Запуск агента в Linux
В современных дистрибутивах установщик сервера 1С создаёт юнит systemd. Запуск выполняется командой:
sudo systemctl start srv1cv8 && sudo systemctl enable srv1cv8Команда enable добавляет агент в автозагрузку. Проверить статус можно через systemctl status srv1cv8 — там же видны последние строки журнала, если запуск завершился ошибкой.
Альтернативный вариант — ручной запуск из каталога платформы. Это полезно для диагностики, когда нужно видеть вывод агента прямо в консоли:
/opt/1cv8/x86_64/8.3.22.1750/ragent -daemonДля отладки ключ -daemon можно опустить — тогда агент будет работать в foreground и выводить сообщения в терминал. Учтите: при закрытии сессии такой процесс завершится, поэтому для постоянной работы используйте systemd.
Ключи запуска ragent и нестандартные порты
Если на одном сервере нужно поднять несколько агентов разных версий, каждому назначают собственные порты через ключи -port (порт агента), -regport (порт менеджера кластера) и -range (диапазон портов рабочих процессов):
ragent.exe -port 2540 -regport 2541 -range 2560:2591 -d "C:\1C\srvinfo_83"Ключ -d задаёт каталог реестра кластера. Для разных агентов каталоги обязательно должны различаться: два агента, указывающих на один srvinfo, повредят данные реестра или будут конфликтовать за блокировки.
Проверка, что агент действительно работает
Сам факт отсутствия ошибки при старте службы ещё не гарантирует работоспособность. Проверьте три вещи: наличие процесса, открытый порт и доступность кластера из консоли.
В Windows процесс ragent.exe виден в диспетчере задач, в Linux — командой ps aux | grep ragent. Прослушивание порта проверяется так:
ss -tlnp | grep 1540 # Linux
netstat -ano | findstr 1540 :: WindowsКак проверить результат
Процесс запущен и не падает через несколько секунд
Процесс стартует и сразу исчезает — смотрите журнал и права
Порт в состоянии LISTEN, принадлежит ragent
Порт не открыт или занят другим приложением
Консоль видит кластер и список баз
Ошибка соединения — проверяйте брандмауэр и версию платформы
При подключении клиента появляются процессы rphost
Клиент висит и отваливается по таймауту
Итоговая проверка — подключение консоли администрирования серверов 1С к данному серверу. Если кластер отображается и раскрывается список информационных баз, агент работает штатно.
Типичные ошибки при запуске и их решение
Служба не стартует с ошибкой доступа. Чаще всего учётная запись агента (по умолчанию USR1CV8) потеряла права на каталог srvinfo или пароль пользователя изменился. Решение — проверить права на каталог и при необходимости переустановить службу с актуальным паролем.
Порт уже занят. Если на сервере ранее стояла другая версия платформы, её агент может удерживать 1540-й порт. Определите процесс через netstat и либо остановите лишнюю службу, либо переназначьте порты новому агенту.
Несовпадение версий платформы у клиента и сервера. Клиент 8.3.22 не всегда корректно подключается к кластеру другой версии. Держите на рабочих местах ту же версию платформы, что и на сервере, либо настройте требования назначения функциональности.
Открытие портов и доступ из сети
Даже корректно запущенный агент бесполезен, если сетевой экран блокирует входящие подключения. На сервере должны быть открыты TCP-порты 1540, 1541 и диапазон 1560–1591 (или назначенные вами альтернативные).
В Windows правила добавляются через «Брандмауэр Защитника Windows» → «Правила для входящих подключений», в Linux — через firewalld или iptables. При этом открывать порты стоит только внутри корпоративной сети: выносить порт агента в интернет недопустимо, это создаёт прямой вектор атаки на кластер.
FAQ
Чем агент отличается от рабочего процесса rphost?
Ragent — управляющий процесс кластера: он ведёт реестр баз и распределяет подключения. Rphost — рабочий процесс, который непосредственно исполняет код прикладного решения и обращается к СУБД. Один агент управляет несколькими rphost.
Служба запускается и сразу останавливается — что делать?
Проверьте журнал событий Windows (или journalctl -u srv1cv8 в Linux), права учётной записи на каталог srvinfo и не занят ли порт другим процессом. Чаще всего причина — пароль пользователя службы устарел или нет прав на каталог реестра кластера.
Можно ли запустить два агента разных версий на одном сервере?
Да, это штатная практика. Каждому агенту назначьте уникальные порты (например, 1540/1541/1560–1591 и 2540/2541/2560–2591) и отдельные каталоги srvinfo. Обе службы будут работать независимо.
Как перезапустить агент без остановки работы пользователей?
Полностью безболезненно — никак: при остановке агента сеансы завершатся. Правильный порядок — заблокировать новые подключения в консоли кластера, дождаться завершения активных сеансов и только потом перезапускать службу.
Где находятся журналы агента для диагностики?
Технологический журнал включается через файл logcfg.xml в каталоге conf платформы. События запуска службы в Windows смотрите в «Просмотре событий», в Linux — через journalctl -u srv1cv8. Там фиксируются ошибки старта, проблемы с портами и правами.
Что важно запомнить
Агент запускается как служба Windows (net start) или демон systemd (systemctl start srv1cv8). После старта проверьте процесс ragent, порт 1540 и подключение консоли кластера. Разные версии платформы разводите по портам и каталогам srvinfo, а доступ к портам ограничивайте внутренней сетью.